Trace

Summary

This behaviour will trace an assets movement, causing it to leave a trail as it moves.

Parameters

Axis

Type: Vector3 Default: 0,1,0

The axis from which to dispense a trail. Values must be entered as X, Y, Z respectively.

Cut

Type: Float Default: 0.5

The percentage portion of the assets mesh to cut off to use as a particle for the trail.

Colour

Type: RGBA Color Default: 0,0,0.8,0.5

The color of the trail. Values are entered as Red, Green, Blue and Alpha values respectively.

Active

Type: Boolean Bindable Default: 1

This parameter controls whether or not the trail is active and can be modified in real time to activate or deactivate as needed.

UpdateRate

Type: Float Default: 1

The rate for which to dispense trail particles. The amount entered will be the amount of time delay between each particle, higher values will cause a larger separation between each trail particle.

Examples

<trace colour="1,0,0,0.5" updaterate=0.2 />
The above code will add a trace to the asset that will have a Red color and have an Alpha transparency value of 0.5. The UpdateRate is set to 0.2 which will cause it to release trail particles close together in a very tight manner.
<trace axis="1,0,0" cut="1" colour="0,1,0,1" active="0" updaterate="2" />
The above code will add a trace to the asset that will have a Green color and have an Alpha transparency of 1 making it completely opaque. The trail will have an active value of 0 meaning it will begin deactivated and is expected to be activated at a later time. With an UpdateRate of 2, trail particles will be released further apart, more akin to a breadcrumb trail rather than in a consistent line.