AnimatePosition

Summary

This functions allows you to choose a Target asset in the 3D world and then have it move to another Position over time.

You can specify either a single Position or multiple Positions. If multiple Positions are specified, the asset will smoothly transition through each specified position as waypoints.

Parameters

Target

Type: Text Default: None

Specifies the name or ARDI ID of the asset you wish to animate. If using an asset ID, begin the target with the '#' character.

Position

Type: XYZ Coordinates Default: 0,0,0

The co-ordinates in which to move the asset to within the 3D world. Co-ordinates are defined as “x,y,z”, separated by a ',' and no spaces.

Positions

Type: Multiple XYZ Coordinates Default: None

Assign multiple coordinates in which to move the asset. The asset will move through each coordinate as a waypoint until arriving at the last coordinate specified.

Coordinates must be defined as XYZ Coordinates separated by space, with each set of coordinates separated by a ','.

For example: A value of “10 30 12,20 12 34,5 10 5” will move the asset to 10,30,12 first then 20,12,34 and then finally 5,10,5.

Specify either a Position parameter or a Positions parameter. Do not specify both.

Speed

Type: Float Default: 0.1

This parameter will set the speed at which the asset will move.

FaceTowardsNext

Type: Boolean Default: False

This parameter will force the asset to rotate and point towards the next set of XYZ Coordinates that it is currently moving to.

FaceTowardsObject

Type: Text Default: None

This parameter allows you to specify the name of another asset in the 3D world in which the moving asset will point towards as it moves.

RotateLocal

Type: Multiple XYZ Coordinates Default: None

This parameter allows you to rotate the asset by x,y,z values. Specify the three XYZ values separated by a ',' such as: “180,90,45”.

MoveToObject

Type: Text Default: None

This parameter allows you to move the asset directly to another asset in the 3D world. Specify the name of an asset and the moving asset will move towards it.

See Also

Examples

<animateposition Target="SomeObject" Position="100,10,10" />
This will find the asset named SomeObject and move it to the respective XYZ Coordinates 100,10,10.
<animateposition Target="SomeObject" Positions="10 20 30,30 24 10,60 20 30" FaceTowardsNext="true" />
This will find the asset named SomeObject and cause it to move through the the specified waypoints 10,20,30 , 30,24,10 and 60,20,30 respectively. With the FaceTowardsNext value set to true, the asset will turn to face towards each waypoint as it moves towards it.
<animateposition Target="SomeObject" Position="23,40,10" Speed="0.5" FaceTowardsObject="AnotherObject" />
This will find the asset named SomeObject and move it to the respective XYZ Coordinates 23,40,10. Speed will be increased to 0.5 and it will rotate and face towards the asset named AnotherObject.