=====Stretch=====

====Summary====
The **stretch** effect allows you to stretch a 3D model along a path.

This is primarily used when creating conveyors, allowing you to take a model of a small conveyor and convert it into an arbitrarily large and complex one.

The model is stretched along 'control points' (3D coordinates), the first being the position of the asset itself.

//Note that currently, Stretch doesn't deal with curves and instead is designed for relatively straight lengths, such as those found in conveyor systems.//

//A future update will allow Stretch (or a similar, new function) to include smooth curves.//

====Parameters====

===Point[x]===
//Type: [[Vector3]] [[Set]]//
//Default: None//

The 'points' attributes specify the set of points that the asset should follow, starting from //point1// to //pointx//. 

Each point should include an X, Y and Z coordinate that the stretched item should pass through.

So a conveyor that passes through four points starts at the object position, and goes through...

<code>
point1="10,10,10" point2="20,20,11" point3="30,30,10"
</code>

===Points===
//Type: [[Vector3]] [[List]] (|)//
//Default: None//
//Optional//

An alternative method of passing the points along the stretch path. Instead of providing several different attributes (as in the previous property), this combines them all into one line. Each Vector3 is split up by the '|' character.

<code>
points="10,10,10|20,20,11|30,30,10"
</code>

===Axis===
//Type: [[Vector3]]//
//Default: **1,0,0**//

The axis to stretch along. In the vast majority of cases, the default value should be correct.

====Examples====

<code>
<stretch point1="10,0,0" point2="20,0,10" point3="30,0,0"/>
</code>

> Stretch the conveyor, starting at 0,0,0 (the assets position), and passing through a point 10m to the left, then 20m to the left and 10m up, then finally 30m to the left and back on the ground level.