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

<setposition Target="SomeObject" Position="10,20,10" />
This function will find the asset named SomeObject and re-position it to the coordinates 10,20,10.
<setposition Target="SomeObject" Position="10,20,10" FaceTowardsObject="AnotherObject" />
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.