====/api/asset/setlocation====

===Usage===

This function is used to set the physical location of an asset.

You can set any combination of **position**, **rotation** and **scale**. The values must be made up of three floating-point numbers. 

For position and scale, these are measured in your //world units// (normally **feet** or **meters**) in X,Y & Z, and the rotation is measured in degrees in Roll, Pitch and Yaw.

//Note: Although the term used is 'scale', this represents the **size** of the object in world coordinates. A scale of 2,2,2 is a 2m x 2m x 2m cube. In other systems, this value might be assumed to mean 'double the size of the original model'.//

===Details==

^Detail^Value^
|Group|Asset|
|From Server Version|0.9.0|
|Permission|[[permission_guest|Guest]]|
|Methods|GET or POST|

==Parameters==

^Parameter^Notes^Meaning^
|**id**|Number [Required]|The ID of the asset|
|**position**|String [Optional]|Location in X,Y,Z|
|**scale**|String [Optional]|Size in X,Y,Z|
|**rotation**|String [Optional]|Rotation in Roll,Pitch,Yaw (Degrees)|
|**offset**|String [Optional]|Offset from Reference|

===Offset Values===

Some assets base their position off other assets. For example, the wheels of a car are often based off the position of the car itself, the position of a train based on the railway.

By providing values for //offset//, you modify where the asset is **relative to the parent object**.

The offset value contains //six// elements in the following format...

<code>
X,Y,Z|Roll,Pitch,Yaw
</code>

This provides both the distance away the asset is, and the relative orientation.

===Examples===

==Call==

<code>
http://ardiserver.com/api/asset/setlocation?id=5&property=10&position=10,0,0
</code>

//This moves the object to 10m to the right of the center of the world.//

<code>
http://ardiserver.com/api/asset/setlocation?id=5&property=10&position=10,0,0&rotation=0,90,0
</code>

//This moves it, then flips it up on its side.//

<code>
http://ardiserver.com/api/asset/setlocation?id=5&property=10&offset=5,0,0|0,90,0
</code>

//This moves the object 5m out from and pitches it up 90 degrees relative to its parent.//