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.