Stretch

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.

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…

point1="10,10,10" point2="20,20,11" point3="30,30,10"

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.

points="10,10,10|20,20,11|30,30,10"

Type: Vector3 Default: 1,0,0

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

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

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.