=====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: [[Bool]]
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====
[[setposition]] [[animateproperty]] [[movecamera]] [[setproperty]]
====Examples====

<code>
<animateposition Target="SomeObject" Position="100,10,10" />
</code>

> This will find the asset named **SomeObject** and move it to the respective [[XYZ Coordinates]] **100,10,10**.

<code>
<animateposition Target="SomeObject" Positions="10 20 30,30 24 10,60 20 30" FaceTowardsNext="true" />
</code>

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

<code>
<animateposition Target="SomeObject" Position="23,40,10" Speed="0.5" FaceTowardsObject="AnotherObject" />
</code>

> 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**.