
## 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 are determined by two windings integers p and q. The simplest knotted knot is with 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);
```




## Ground

A ground is a flat horizontal plane parallel to the xz plane which can be subdivided into rectangular regions. The origin of the ground is at the center of the plane. The optional properties for determining the size of the ground are width (x) and height (z) (and yes we all agree that depth would be more descriptive than height!)

## MeshBuilder

Usage :

```javascript
const ground = BABYLON.MeshBuilder.CreateGround("ground", options, scene); //scene is optional and defaults to the current scene
```

| option       | value                                                    | default value |
| ------------ | -------------------------------------------------------- | ------------- |
| width        | _(number)_ size of the width                             | 1             |
| height       | _(number)_ size of the height                            | 1             |
| updatable    | _(boolean)_ true if the mesh is updatable                | false         |
| subdivisions | _(number)_ number of square subdivisions along each axis | 1             |

### Example

Ground: <Playground id="#45R5JK" title="Create a Ground" description="Simple example of creating a ground."/>

## Mesh

Usage

```javascript
const ground = BABYLON.MeshBuilder.CreateGround("ground", { width, height, subdivisions }, scene);
const ground = BABYLON.MeshBuilder.CreateGround("ground", { width, height, subdivisions }, scene, updatable); //one optional parameter after scene
```



## 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);
```
