# Icospheres

> Learn how to create icospheres in Babylon.js.

Source: https://doc.babylonjs.com/features/featuresDeepDive/mesh/creation/polyhedra/icosphere

## Icosphere
This is a sphere based on an icosahedron with 20 triangular faces that can be subdivided into smaller triangles.

## MeshBuilder
Usage:
```javascript
const icosphere = BABYLON.MeshBuilder.CreateIcoSphere("icosphere", options, scene);
```

options|value|default value
--------|-----|-------------
radius|_(number)_ radius | 1
radiusX|_(number)_  the X radius, overwrites the radius value|radius
radiusY|_(Vector3)_  the Y radius, overwrites the radius value|radius
radiusZ|_(number)_ the Z radius, overwrites the radius value|radius
subdivisions|_(number)_ the number of subdivisions|4
flat|_(boolean)_ if true, the mesh faces have their own normals|true
updatable|_(boolean)_ true if the mesh is updatable|false
sideOrientation|_(number)_ side orientation|DEFAULTSIDE

## Examples 
Icosphere: [Playground: Creating An Icosphere](https://playground.babylonjs.com/#HC5FA8) - Simple example of creating an icosphere.  
Smoothed Icosphere: [Playground: Creating A Smoothed Icosphere](https://playground.babylonjs.com/#HC5FA8#2) - Simple example of creating a smoothed icosphere.  
Less subdivisions and changed radii: [Playground: Icosphere With Less Subdivisions](https://playground.babylonjs.com/#HC5FA8#3) - Simple example of creating an icosphere with less subdivisions and changed radii.  
Icosphere with animation over subdivisions: [Playground: Icosphere With Animation Over Subdivisions](https://playground.babylonjs.com/#E3TVT#1) - Simple example of creating an icosphere with animation over subdivisions.  

## Mesh
Usage:
```javascript
const icosphere = BABYLON.Mesh.CreateIcoSphere("icosphere", options, scene);
```
This is the same format as that for *MeshBuilder*.