Difference between revisions of "LlGetLocalPos"

From Second Life Wiki
Jump to navigation Jump to search
m
 
(16 intermediate revisions by 8 users not shown)
Line 3: Line 3:
|func=llGetLocalPos|sort=GetLocalPos
|func=llGetLocalPos|sort=GetLocalPos
|return_type=vector
|return_type=vector
|func_footnote
|func_footnote=If called from the root prim it returns the [[Viewer coordinate frames#Region|position in the region]] unless it is [[llGetAttached|attached]] to which it returns the position relative to the [[Viewer coordinate frames#Attachments|attach point]].
|func_desc
|func_desc
|return_text=that is the position relative to the root ([[Viewer coordinate frames#Local|local]]).
|return_text=that is the position relative ([[Viewer coordinate frames#Local|local]]) to the root.
|spec
|spec
|caveats
|caveats
|constants
|constants
|examples
|examples=
|helpers
<source lang="lsl2">
|also_functions
default
{
  touch_start( integer vIntTouched )
  {
    string vStrMessage = "The touched prim is ";
    if (llDetectedLinkNumber( 0 ) > 1)
    {
      vStrMessage += (string)llVecMag( llGetLocalPos() ) + "m from ";
    }
    llSay( 0, vStrMessage + "the root prim" );
  }
}
</source>
|helpers=
There is no function to set the position of a prim local to itself.
To set the position of a prim local to itself you would have to do something like:
<source lang="lsl2">
SetPositionLocalToCurrentPosition(vector local_position)
{
  llSetPos(llGetLocalPos() + (local_position * llGetLocalRot()));
}
</source>
Or:
<source lang="lsl2">
SetPositionLocalToCurrentPosition(vector local_position)
{
  llSetPos(llGetPos() + (local_position * llGetRot()));
}
</source>
|also_functions={{LSL DefineRow||[[llGetRootPosition]]|Gets the root prims global position}}
{{LSL DefineRow||[[llGetPos]]|Gets the prims global position}}
{{LSL DefineRow||[[llSetPos]]|Sets the prims global position}}
|also_tests
|also_tests
|also_events
|also_events
Line 17: Line 48:
|notes
|notes
|cat1=Movement
|cat1=Movement
|cat2
|cat2=Prim
|cat3
|cat3
|cat4
|cat4
}}
}}

Latest revision as of 02:10, 22 January 2015

Summary

Function: vector llGetLocalPos( );

Returns a vector that is the position relative (local) to the root.

If called from the root prim it returns the position in the region unless it is attached to which it returns the position relative to the attach point.

Examples

default
{
  touch_start( integer vIntTouched )
  {
    string vStrMessage = "The touched prim is ";
    if (llDetectedLinkNumber( 0 ) > 1)
    {
      vStrMessage += (string)llVecMag( llGetLocalPos() ) + "m from ";
    }
    llSay( 0, vStrMessage + "the root prim" );
  }
}

Useful Snippets

There is no function to set the position of a prim local to itself. To set the position of a prim local to itself you would have to do something like:

SetPositionLocalToCurrentPosition(vector local_position)
{
   llSetPos(llGetLocalPos() + (local_position * llGetLocalRot()));
}

Or:

SetPositionLocalToCurrentPosition(vector local_position)
{
   llSetPos(llGetPos() + (local_position * llGetRot()));
}

See Also

Functions

•  llGetRootPosition Gets the root prims global position
•  llGetPos Gets the prims global position
•  llSetPos Sets the prims global position

Deep Notes

Search JIRA for related Issues

Signature

function vector llGetLocalPos();