Difference between revisions of "LlSetPos"
Jump to navigation
Jump to search
Kireji Haiku (talk | contribs) m (added tip with reference to llSetRegionPos and llSetLinkPrimitiveParamsFast) |
Lady Sumoku (talk | contribs) m (Replaced old <LSL> block with <source lang="lsl2">) |
||
| Line 21: | Line 21: | ||
|examples= | |examples= | ||
{{LSL Tip|This function has a movement cap of 10m and a time delay of 0.2 seconds per call. Please consider using [[llSetRegionPos]] and/or [[llSetLinkPrimitiveParamsFast]] instead.}} | {{LSL Tip|This function has a movement cap of 10m and a time delay of 0.2 seconds per call. Please consider using [[llSetRegionPos]] and/or [[llSetLinkPrimitiveParamsFast]] instead.}} | ||
< | <source lang="lsl2"> | ||
//Move the object up 1m when someone touches it. | //Move the object up 1m when someone touches it. | ||
default { | default { | ||
| Line 43: | Line 43: | ||
llSetPos(save); | llSetPos(save); | ||
} | } | ||
</ | </source> | ||
|helpers | |helpers | ||
|also_functions={{LSL DefineRow||[[llSetRegionPos]]|Sets position of object to any position within the region.}} | |also_functions={{LSL DefineRow||[[llSetRegionPos]]|Sets position of object to any position within the region.}} | ||
Revision as of 13:18, 22 January 2015
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: llSetPos( vector pos );
| 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 upon the situation (see #Specification). |
Movement is capped to 10m per call for unattached root prims.[1]
Specification
This function is available for nonphysical root prims and all child prims. It has no effect on the root prim if the object is physical.
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.
- Attached
- 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 in the root prim of physical objects. Use a physical function like llMoveToTarget instead.
Examples
 |
Important: This function has a movement cap of 10m and a time delay of 0.2 seconds per call. Please consider using llSetRegionPos and/or llSetLinkPrimitiveParamsFast instead. |
//Move the object up 1m when someone touches it.
default {
touch_start(integer i) {
llSetPos(llGetPos() + <0,0,1>);
}
}
// to bypass the small movement bug use this
// - created by Madpeter Zond
// notes: it does not check if the movement would go out of limit range for linked prims
llSetLocalPos(vector offset)
{
vector save = offset;
if(offset.x < 0.0) offset.x -= 1;
else offset.x += 1;
if(offset.y < 0.0) offset.y -= 1;
else offset.y += 1;
if(offset.z < 0.0) offset.z -= 1;
else offset.z += 1;
llSetPos(offset);
llSetPos(save);
}
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
| • | llSetRegionPos | – | Sets position of object to any position within the region. | |
| • | 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 |