llSetPos

Template:Needs Translation/LSL/es Template:Needs Translation/LSL/el Template:Needs Translation/LSL/he Template:Needs Translation/LSL/it Template:Needs Translation/LSL/ko Template:Needs Translation/LSL/nl Template:Needs Translation/LSL/hu Template:Needs Translation/LSL/no Template:Needs Translation/LSL/da Template:Needs Translation/LSL/sv Template:Needs Translation/LSL/tr Template:Needs Translation/LSL/pl Template:Needs Translation/LSL/pt Template:Needs Translation/LSL/ru Template:Needs Translation/LSL/th Template:Needs Translation/LSL/uk Template:Needs Translation/LSL/zh-Hans Template:Needs Translation/LSL/zh-Hant

/LSL

SetPos

llSetPos

Summary

Function: llSetPos( vector pos );

58	Function ID
0.2	Forced Delay
10.0	Energy

Moves the object or primitive towards pos without using physics.

• vector

pos

–

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

Movement is capped to 10m per call for unattached root prims.^[1]

Specification

Coordinate Frame

• 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.

Caveats

• 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.

All Issues ~ Search JIRA for related Bugs

Examples

<lsl> //Move the object up 1m when someone touches it. default {

    touch_start(integer i) {
         llSetPos(llGetPos() + <0,0,1>);
    }

}

</lsl>

Notes

Multiple movement commands can be chained together with llSetPrimitiveParams and PRIM_POSITION. The advantage of doing this is that the script only sleeps once per function call instead of once per movement.

See Also

Functions

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

Deep Notes

Search JIRA for related Issues

Footnotes

1. ^ Unless you exploit the undocumented warpPos bug.

Signature
function void llSetPos( vector pos );