=====SetPosition=====
====Summary====

This function allows you to immediately set the position of any given asset to a fixed position based on [[XYZ Coordinates]]

====Parameters====

===Target===

//Type: Text
Default: None//

Specifies the //name// or ARDI ID of the asset you wish to set the position for. 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 place the asset within the 3D world. Co-ordinates are defined as "x,y,z", separated by a ',' and no spaces.

===LocalPosition===

//Type: [[XYZ Coordinates]]
Default: 0,0,0//

The co-ordinates in which to place the asset within the 3D world local to its current position. Co-ordinates are defined as "x,y,z", separated by a ',' and no spaces.

===AttachTo===

//Type: Text
Default: None//

Specifies the //name// or ARDI ID of another asset for which this asset is to be parented to. If using an asset ID, begin the target with the '#' character. //This parameter is optional//

If defined, this asset will be parented to the specified asset and it's //position// will be converted to local co-ordinates around the parent asset.

===FaceTowardsPoint===

//Type: [[XYZ Coordinates]]
Default: None//

This parameter allows you to specify a set of [[XYZ Coordinates]] in which the asset will face towards. The asset will be rotated so that its forward position will be facing towards the specified coordinates.

===FaceTowardsObject===

//Type: Text
Default: None//

This parameter allows you to specify the name of another asset in which the asset will face towards. The asset will be rotated so that its forward position will be facing towards the specified asset.

====Examples====

<code>
<setposition Target="SomeObject" Position="10,20,10" />
</code>

> This function will find the asset named **SomeObject** and re-position it to the coordinates **10,20,10**.

<code>
<setposition Target="SomeObject" Position="10,20,10" FaceTowardsObject="AnotherObject" />
</code>

> This function will find the asset named **SomeObject** and re-position it to the coordinates **10,20,10**. It will then find the asset named **AnotherObject** and then rotate **SomeObject** to be facing towards **AnotherObject**.