=====Animate=====

====Summary====

This function will allow you to animate any 3D object added using the AddMesh function. Animations are created by specifying exact position, rotation and scale keyframes over time.
====Paramaters====

===Target===

//Type: Text
Default: None//

Specifies the name of the object to be moved. This value is usually specified by the **Name** Parameter.

===PositionFrames===

//Type: [[KeyFrame]]
Default: None//

This specifies the //position// Keyframes for which the object is to be moved. Keyframes are entered as "time,x,y,z" co-ordinates that are **space** delimited. For example a value of **"2,10,5,10 4,10,5,5 6,5,10,5"** will cause the object to move to the 3D Object space location of 10,5,10 at 2 seconds, 10,5,5 at 4 seconds and 5,10,5 at 6 seconds. 

===RotationFrames===

//Type: [[KeyFrame]]
Default: None//

This specifies the //rotation// Keyframes for which the object is to be rotated. Keyframes are entered as "time,x,y,z" co-ordinates that are **space** delimited. For example a value of **"2,0,0,90 4,0,0,180 6,90,0,180"** will cause the object to rotate to 0,0,90 at 2 seconds, 0,0,180 at 4 seconds and 90,0,180 at 6 seconds. 

===ScaleFrames===

//Type: [[KeyFrame]]
Default: None//

This specifies the //scale// Keyframes for which the object is to be scaled. Keyframes are entered as "time,x,y,z" co-ordinates that are **space** delimited. For example a value of **"2,2,2,2 4,4,4,4 6,0.5,0.5,0.5"** will cause the object to grow to double its size at 2 seconds, 4 times it's original size at 4 seconds and half it's original size at 6 seconds. 

====Examples====

<code>
  <addmesh name="Tool" file="Tool.fbx" Offset="50,55,-1" Rotation="-90,90,0" Scale="0.5,0.5,0.5"/>
  <animate PositionFrames="2,-20,58,-1 3,-20,58,-1 4,-20,58,14" RotationFrames="5,-90,90,0 7,0,90,0" target="Tool"/>
</code>

The above code will create an object attached to the marker called "Tool". It will then move to position **-20,58,-1** after 2 seconds, **-20,58,-1** after 3 seconds and **-20,58,14** after 4 seconds. It will then rotate 90 degrees on the x axis from **-90,90,0** to **0,90,0** from 5 to 7 seconds. The final animation displays a tool being inserted into a part of the real world object that this marker is placed on and turning 90 degrees anti-clockwise.
====See Also====
[[addmesh_ar]] [[addshape_ar]] [[indicator_ar]]