
## Cylinder or Cone
The created cylinder has its flat sides parallel to the xz plane with its origin at the center of the vertical line of symmetry. If you set _diameterTop_ to zero, you get a cone instead of a cylinder, with different values for _diameterTop_ and _diameterBottom_ you get a truncated cone.
## MeshBuilder
Usage :
```javascript
const cone = BABYLON.MeshBuilder.CreateCylinder("cone", options, scene); //scene is optional and defaults to the current scene
```

option|value|default value
--------|-----|-------------
height|_(number)_ height of the cylinder|2
diameterTop|_(number)_ diameter of the top cap, can be zero to create a cone, overwrites the _diameter_ option|1
diameterBottom|_(number)_ diameter of the bottom cap, can't be zero, overwrites the _diameter_ option|1
diameter|_(number)_ diameter of both caps|1
tessellation|_(number)_ number of radial sides|24
subdivisions|_(number)_ number of rings|1
faceColors|_(Color4[])_ array of 3 _Color4_, 0 : bottom cap, 1 : cylinder tube, 2 : top cap|Color4(1, 1, 1, 1) for each face
faceUV|_(Vector4[])_ array of 3 _Vector4_, 0 : bottom cap, 1 : cylinder tube, 2 : top cap| UVs(0, 0, 1, 1) for each face
arc|_(number)_ ratio of the circumference between 0 and 1|1
hasRings|_(boolean)_ makes the subdivisions independent from each other, so they become different faces|false
enclose|_(boolean)_ adds two extra faces per subdivision to a sliced cylinder to close it around its height axis|false
updatable|_(boolean)_ true if the mesh is updatable|false
sideOrientation|_(number)_ side orientation|DEFAULTSIDE
frontUVs|_(Vector4)_  **ONLY WHEN sideOrientation:BABYLON.Mesh.DOUBLESIDE set** | Vector4(0,0, 1,1) 
backUVs|_(Vector4)_  **ONLY WHEN sideOrientation:BABYLON.Mesh.DOUBLESIDE set** | Vector4(0,0, 1,1) 

### Examples
Cylinder: <Playground id="#QANVC6" title="Create a Cylinder" description="Simple example of creating a cylinder."/>

Cone: <Playground id="#QANVC6#1" title="Create a Cone" description="Simple example of creating a cone."/>

Triangular Prism: <Playground id="#QANVC6#2" title="Create a Triangular Prism" description="Simple example of creating a triangular prism."/>

Arc <Playground id="#QANVC6#3" title="Create an Arc" description="Simple example of creating an arc."/>

Cake Slice: <Playground id="#QANVC6#2240" title="Create a Cake Slice" description="Simple example of creating a cake slice."/>

![can label and top](/img/how_to/apply-material-to-faces/logo_label.jpg)

Cylinder with faceUVs <Playground id="#QANVC6#4" title="Create a Cylinder With Face UVs" description="Simple example of creating a cylinder with face UVs."/>

## Mesh
Usage :
```javascript
const cylinder = BABYLON.MeshBuilder.CreateCylinder("cylinder", {height, diameterTop, diameterBottom, tessellation, subdivisions}, scene);
```



## Capsule
*Requires BJS version 4.2+*
The created capsule has its origin at the center of the capsule. The height minus the sum of the top and bottom radius must be > 0.

## MeshBuilder
Usage :
```javascript
const capsule = BABYLON.MeshBuilder.CreateCapsule("ribbon", options, scene);  //scene is optional and defaults to the current scene
```

option|value|default value
--------|-----|-------------
orientation?|_(Vector3)_ Direction of the capsule upon inception. | Vector3.Up
subdivisions|_(number)_ Number of sub segments on the tube section of the capsule running parallel to orientation.| 2
tessellation|_(number)_  Number of cylindrical segments on the capsule.|16
height|_(number)_  Height or length of the capsule.|1
radius|_(number)_ Radius of the capsule.|0.25
capSubdivisions|_(number)_ Number of sub segments on the cap sections of the capsule running parallel to orientation.|6
radiusTop?|_(number)_  Overwrite for the top radius.
radiusBottom?|_(number)_  Overwrite for the bottom radius.
topCapSubdivisions?|_(number)_ Overwrite for the top capSubdivisions.
bottomCapSubdivisions?|_(number)_ Overwrite for the bottom capSubdivisions.

### Examples
Default capsule: <Playground id="#CL6HZ0" title="Create a Default Capsule" description="Simple example of creating a default capsule."/>  
Different cap subdivisions: <Playground id="#CL6HZ0#1" title="Create a Capsule With Subdivisions" description="Simple example of creating a capsule with subdivisions."/>
Forward orientation: <Playground id="#CL6HZ0#2" title="Create a Capsule With Foreward Orientation" description="Simple example of creating a capsule with forward orientation."/>
Different radii: <Playground id="#CL6HZ0#3" title="Create a Capsule With Different Radii" description="Simple example of creating a capsule with different radii."/>

## Mesh
```javascript
const capsule = BABYLON.Mesh.CreateCapsule("ribbon", options, scene);  //scene is optional and defaults to the current scene
```
The same form as for *MeshBuilder*


## Sphere

The created sphere has its origin at the center of the sphere. By using different values for _diameterX_, _diameterY_ and diameterZ\_ lead you create an ellipsoid.

## MeshBuilder

Example :

```javascript
const sphere = BABYLON.MeshBuilder.CreateSphere("sphere", options, scene); //scene is optional and defaults to the current scene
```

| option          | value                                                                 | default value      |
| --------------- | --------------------------------------------------------------------- | ------------------ |
| segments        | _(number)_ number of horizontal segments                              | 32                 |
| diameter        | _(number)_ diameter of the sphere                                     | 1                  |
| diameterX       | _(number)_ diameter on X axis, overwrites _diameter_ option           | diameter           |
| diameterY       | _(number)_ diameter on Y axis, overwrites _diameter_ option           | diameter           |
| diameterZ       | _(number)_ diameter on Z axis, overwrites _diameter_ option           | diameter           |
| arc             | _(number)_ ratio of the circumference (latitude) between 0 and 1      | 1                  |
| slice           | _(number)_ ratio of the height (longitude) between 0 and 1            | 1                  |
| updatable       | _(boolean)_ true if the mesh is updatable                             | false              |
| sideOrientation | _(number)_ side orientation                                           | DEFAULTSIDE        |
| frontUVs        | _(Vector4)_ **ONLY WHEN sideOrientation:BABYLON.Mesh.DOUBLESIDE set** | Vector4(0, 0, 1,1) |
| backUVs         | _(Vector4)_ **ONLY WHEN sideOrientation:BABYLON.Mesh.DOUBLESIDE set** | Vector4(0, 0, 1,1) |

### Examples

<Playground id="#WIR77Z" title="Create a Sphere" description="Simple example of creating a sphere." image="/img/playgroundsAndNMEs/divingDeeperMeshSetShapes6.jpg" isMain={true} category="Mesh"/>

<Playground id="#WIR77Z#1" title="Create a Ellipsoid" description="Simple example of creating a ellipsoid." image="/img/playgroundsAndNMEs/divingDeeperMeshSetShapes7.jpg"/>

<Playground id="#WIR77Z#2" title="Create an Arc" description="Simple example of creating an arc." image="/img/playgroundsAndNMEs/divingDeeperMeshSetShapes8.jpg"/>

<Playground id="#WIR77Z#3" title="Create an Arc and Slice" description="Simple example of creating an arc and slice." image="/img/playgroundsAndNMEs/divingDeeperMeshSetShapes9.jpg"/>

## Mesh

Usage :

```javascript
const sphere = BABYLON.MeshBuilder.CreateSphere("sphere", { segments, diameter }, scene);
```

It is only possible to create a sphere with this method, for an ellipsoid you need to use scaling.
