
## Torus
The created torus (doughnut shape) has its origin at the center of the torus. You can control its diameter and the thickness of its circular body.

## MeshBuilder
Example :
```javascript
const torus = BABYLON.MeshBuilder.CreateTorus("torus", options, scene);
```

option|value|default value
--------|-----|-------------
diameter|_(number)_ diameter of the torus|1
thickness|_(number)_ thickness of its tube|0.5
tessellation|_(number)_ number of segments along the circle|16
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
Thick: <Playground id="#IJGMXZ#1" title="Create a Thick Torus" description="Simple example of creating a thick torus."/>
Thin: <Playground id="#IJGMXZ#2" title="Create a Thin Torus" description="Simple example of creating a thin torus."/>

## Mesh
## Usage
```javascript
const torus = BABYLON.MeshBuilder.CreateTorus("torus", {diameter, thickness, tessellation, updatable, sideOrientation}, scene);
```



## Torus Knot
A torus knot is a continuous shape that twists and turns around the surface of a torus. The number of twists and turns is determined by two winding integers, p and q. The simplest torus knot uses 2 and 3 for p and q. The origin of the created torus knot is at the center of the underlying torus.

## MeshBuilder
Example :
```javascript
const torus = BABYLON.MeshBuilder.CreateTorusKnot("torusKnot", options, scene);
```

option|value|default value
--------|-----|-------------
radius|_(number)_ radius of the torus knot|2
tube|_(number)_ thickness of its tube|0.5
radialSegments|_(number)_ number of radial segments|32
tubularSegments|_(number)_ number of tubular segments|32
p|_(number)_ number of windings|2
q|_(number)_ number of windings|3
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
Simplest: <Playground id="#SVU8U9#1" title="Create a Simple Torus Knot" description="Simple example of creating a simple torus knot."/> 
Low p and q: <Playground id="#SVU8U9#2" title="Create a Torus Knot With Low P And Q" description="Simple example of creating a simple torus knot with low P And Q."/>
High p and q: <Playground id="#SVU8U9#3" title="Create a Torus Knot With High P And Q" description="Simple example of creating a simple torus knot with high P And Q."/>
Breaking the rules - using high non-integer P and q: <Playground id="#SVU8U9#4" title="Create a Torus Knot With High non integer P And Q" description="Simple example of creating a simple torus knot with high non integer P And Q."/>

## Mesh
```javascript
const knot = BABYLON.MeshBuilder.CreateTorusKnot("knot", {radius, tube, radialSegments, tubularSegments, p, q}, scene);
```




## Disc or Regular Polygon
The created disc is a flat surface parallel to the xy plane, with its origin at the center of the disc. The word disc is a bit of a misnomer, since you can use it to create any kind of regular polygon. The number of sides depends on the value given to _tessellation_. The larger this value, the closer it is to an actual disc. Using the arc option, you can create a sector.

## MeshBuilder
Usage :
```javascript
const disc = BABYLON.MeshBuilder.CreateDisc("disc", options, scene); //scene is optional and defaults to the current scene 
```

option|value|default value
--------|-----|-------------
radius|_(number)_ the radius of the disc or polygon|0.5
tessellation|_(number)_ the number of disc/polygon sides|64
arc|_(number)_ ratio of the circumference between 0 and 1|1
updatable|_(boolean)_ true if the mesh is updatable|false
sideOrientation|_(number)_ side orientation|DEFAULTSIDE


### Examples
Disc: <Playground id="#MVSQWZ#1" title="Create a Disc" description="Simple example of creating a disc."/>
Triangle: <Playground id="#MVSQWZ#2" title="Create a Triangle" description="Simple example of creating a triangle."/>
Sector: <Playground id="#MVSQWZ#3" title="Create a Sector" description="Simple example of creating a sector."/>

## Mesh
Usage :
```javascript
const disc = BABYLON.Mesh.CreateDisc("disc", radius, tessellation, scene);
const disc = BABYLON.Mesh.CreateDisc("disc", radius, tessellation, scene, updatable, sideOrientation); //optional parameters after scene
```

option	value	default value
diameter	(number) diameter of the torus	1
thickness	(number) thickness of its tube	0.5
tessellation	(number) number of segments along the circle	16
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)

Creating A Torus

Torus

MeshBuilder

Examples

Mesh

Usage