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
<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"/>
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.