=====Animate=====

====Summary====
The **animate** effect is used to link an animation to an analogue value. When the value is at its lowest, the //first// frame of the animation plays. When the value is at its highest, the //last// frame animation plays. And of course where the value is anywhere in between, the animation plays in a proportional state.

**For this function to work, your 3D model must be based on an FBX file with a baked-in animation**.

====Parameters====

===Amount===
//Type: [[float]] [[bindable]]
Default: **1**//

The percentage (0-100) within the animation that should be displayed. 0% is the first frame, 100% is the last, 50% is the midpoint of the animation.

This is almost always set to a property using a [[binding expressions]].

===Enabled===
//Type: [[boolean]] [[bindable]]//
//Default: **true**//

Enables the effect when the value is '1', disables it when the value is '0'.

====Examples====

<code>
<animate amount="[ Level ]"/>
</code>

> Used on a tank with an animation showing changes in the water level, this makes the animation play based on how full the tank is. 

<code>
<animate amount="[ Level:%:0:100 ]"/>
</code>

> As above, but this time the 'Level' property is in meters instead of in percentages, so this instructs ARDI to convert the meters into a percentage-of-range. 

<code>
<animate amount="[ Level:*:0:1.1 ]"/>
</code>

> Here there's a problem with the level sensor - it continually reports 10% low. Although we would always suggest fixing the sensor, this will multiply your level by 1.1 to fix the 10% error in the animation.