Difference between revisions of "LlSetPos"

Revision as of 14:24, 12 October 2007

Function: llSetPos( vector pos );


0.2	Forced Delay
10.0	Energy

Moves the object or primitive towards pos 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.
This function does not work for physical objects. Use llMoveToTarget instead.

//Move the object up 1m when someone touches it.
default {
     touch_start(integer i) {
          llSetPos(llGetPos() + <0,0,1>);
     }
}

Signature
function void llSetPos( vector pos );

@@ Line 18: / Line 18: @@
 *This function does not work for physical objects. Use [[llMoveToTarget]] instead.
 |constants
-|examples
+|examples=
+<pre>
+//Move the object up 1m when someone touches it.
+default {
+     touch_start(integer i) {
+          llSetPos(llGetPos() + <0,0,1>);
+     }
+}
+</pre>
 |helpers
 |also_functions={{LSL DefineRow||[[llGetLocalPos]]|Returns the prim's local position if it is attached or non-root (otherwise it returns the global position)}}

•	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