
## Line System
MeshBuilder only. A system of non-contiguous lines that are independent of each other and may exist in their own space. You must set at least the _lines_ option. On update, you must set the _lines_ and _instance_ options. You can also update the _colors_ option if previously set at construction time.

## MeshBuilder 
Usage :
```javascript
// creates an instance of a line system
let lineSystem = BABYLON.MeshBuilder.CreateLineSystem("lineSystem", {lines: myArray}, scene);

// updates the existing instance of lineSystem : no need for the parameter scene here
lineSystem = BABYLON.MeshBuilder.CreateLineSystem("lineSystem", {lines: myArray, instance: lineSystem});
```

option|value|default value
--------|-----|-------------
lines|_(Vector3[][])_  array of lines, each line being an array of successive Vector3 **REQUIRED**
updatable|_(boolean)_ true if the mesh is updatable|false
instance|_(LineMesh)_ an instance of a line system mesh to be updated|null
colors|_(Color4[])_ array of Color4, each point color|null
useVertexAlpha|_(boolean)_ false if the alpha blending is not required (faster)|true

### Examples
Example of a Linesystem: <Playground id="#Y7CS4N" title="Line System Example" description="Simple example of a line system." image=""/>
Update of the Linesystem: <Playground id="#Y7CS4N#1" title="Updating Line System Example" description="Simple example of updating a line system." image=""/>

Unlike a mesh Lines are colored after creation with a color property rather than a material.
```javascript
linesystem.color = new BABYLON.Color3(1, 0, 0);
```
Colored Line System: <Playground id="#Y7CS4N#2" title="Colored Line System Example 1" description="Simple example of a colored line system." image=""/>

You can produce multi-colored lines by setting the colors for each point of each line before creation

<Playground id="#Y7CS4N#3" title="Colored Line System Example 2" description="Simple example of a colored line system." image=""/>


## Lines
Lines are created as a contiguous series of attached line segments from a list of points. You must set at least the _points_ option. On update, you must set the _points_ and _instance_ options. You can also update the _colors_ option if previously set at construction time.

## MeshBuilder
Usage:
```javascript
const options = {
    points: myPoints, //vec3 array,
    updatable: true
}

let lines = BABYLON.MeshBuilder.CreateLines("lines", options, scene);  //scene is optional and defaults to the current scene

// Update
options.points[0].x +=6; 
options.instance = lines;
lines = BABYLON.MeshBuilder.CreateLines("lines", options); //No scene parameter when using instance
```

option|value|default value
--------|-----|-------------
points|_(Vector3[])_  array of Vector3, the path of the line **REQUIRED**
updatable|_(boolean)_ true if the mesh is updatable|false
instance|_(LineMesh)_ an instance of a line mesh to be updated|null
colors|_(Color4[])_ array of Color4, each point color|null
useVertexAlpha|_(boolean)_ false if the alpha blending is not required (faster)|true

Unlike a mesh Lines are colored after creation with a color property rather than a material.
```javascript
lines.color = new BABYLON.Color3(1, 0, 0);
```

### Examples
non updatable lines: <Playground id="#MZ7QRG#6" title="Create Non Updatable Lines" description="Simple example of creating non updatable lines." image=""/>
non updatable closed lines: <Playground id="#MZ7QRG#8" title="Create Non Updatable Closed Lines" description="Simple example of creating non updatable closed lines." image=""/> 
updatable example: <Playground id="#MZ7QRG#9" title="Create Updatable Closed Lines" description="Simple example of creating updatable closed lines." image=""/> 
updatable spriral: <Playground id="#MZ7QRG#10" title="Create Updatable Spiral Lines" description="Simple example of creating updatable spiral lines." image=""/>

multi colored lines have to be set on creation. <Playground id="#MZ7QRG#11" title="Create Multi Colored Lines" description="Simple example of creating multi colored lines." image=""/>

## Mesh
usage:
```javascript
let lines = BABYLON.Mesh.CreateLines("lines", points, scene);
let lines = BABYLON.Mesh.CreateLines("lines", points, scene, updatable, instance);
```  

option	value	default value
option points	value (Vector3[]) array of Vector3, the path of the line REQUIRED	default value
option dashSize	value (number) size of the dashes	default value 3
option gapSize	value (number) size of the gaps	default value 1
option dashNb	value (number) intended number of dashes	default value 200
option updatable	value (boolean) true if the mesh is updatable	default value false
option instance	value (LineMesh) an instance of a line mesh to be updated	default value null

Creating Dashed Lines

Dashed Lines

MeshBuilder

Examples

Mesh