Difference between revisions of "LlSetPos"

Revision as of 08:20, 20 March 2007

Function: llSetPos( vector pos );

Moves the object or primitive towards the specified location without using physics.

• vector

–

position in region or local coordinates depending on the situation (see #Specification).

Movement is capped to 10m per call for unattached root prims.

Root prims (or single prim objects)
- Attached
  - pos is a local coordinate relative to the attach point.
- Not attached
  - pos is a region coordinate.
Child prims (non root prims)
- pos is a local coordinate relative to the root prim.

This function causes the script to sleep for 0.2 seconds.
Because of the intermixing of local and regional coordinates with this function, when a prims position is wanted it is best to use llGetLocalPos.

Signature
function void llSetPos( vector pos );

@@ Line 2: / Line 2: @@
 |func_id=58|func_sleep=0.2|func_energy=10.0
 |func=llSetPos
-|p1_type=vector|p1_name=pos
+|p1_type=vector|p1_name=pos|p1_desc=position in [[Viewer coordinate frames#Region|region]] or [[Viewer coordinate frames#local|local coordinates]] depending on the situation (see ''[[#Specification]]'').
-|func_desc=Moves the object or primitive towards the specified location without using physics. How this is achived depends upon if the prim is the root and if it is attached (see ''[[#Specification|Specification]]'').
+|func_desc=Moves the object or primitive towards the specified location without using physics.
 |func_footnote=Movement is capped to 10m per call for unattached root prims.
 |spec=
+=====Coordinate Frame=====
 *Root prims (or single prim objects)
+**Attached
+***'''pos''' is a [[Viewer coordinate frames#local|local coordinate]] relative to the attach point.
 **Not attached
 ***'''pos''' is a [[Viewer coordinate frames#Region|region coordinate]].
-**Attached
-***'''pos''' is a [[Viewer coordinate frames#local|local coordinate]]relative to the attach point.
 *Child prims (non root prims)
 **'''pos''' is a [[Viewer coordinate frames#local|local coordinate]] relative to the root prim.

•	llGetLocalPos	–	Returns the prim's local position if it is attached or non-root (otherwise it returns the global position)
•	llGetPos	–	Returns the prim's global position, even if it is attached or non-root