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.