llGetRootRotation

Category: Linkset Target

function

Function syntax

rotation llGetRootRotation();

Returns: rotation
Energy: 10

Returns a rotation representing the orientation (relative to the region) of the root prim of the linkset containing the script.

Returns a rotation that is the region rotation of the root prim of the object.

rotation result = llGetRootRotation();

Caveats

Returns an accurate facing for Avatars seated or in mouselook, but only a rough direction otherwise when called from an attached prim.
When a seated avatar is in mouselook, its rotation is affected by the camera’s rotation. There is no way to get the actual rotation of an avatar while seated in mouselook.
This function incorrectly (but usefully) returns the avatars region rotation when called in an attachment, use the following instead:

//  if called only from the root
    llGetLocalRot();
//  if called from in a linked object
    llList2Rot( llGetLinkPrimitiveParams( LINK_ROOT, [PRIM_ROT_LOCAL] ), 0 );
//  this alternative works correctly in all scenarios
    llList2Rot( llGetLinkPrimitiveParams( !!llGetLinkNumber(), [PRIM_ROT_LOCAL] ), 0 );

Examples

Simple example to set region rotation of child prim in unattached link set

default
{
  state_entry()
  {
    //Rotate 45 degrees about Y-axis
    rotation globalRot = llEuler2Rot(<0.0, 45.0, 0.0> * DEG_TO_RAD);
    llSetLocalRot(globalRot / llGetRootRotation());
  }
}

Notes

In an attached object, returns region rotation of avatar NOT of the object’s root prim. See special cases of rotation.

Known issues

VWR-1331: Improve accuracy of avatar’s visible rotation

See also

Functions

Original wiki source

Some wiki templates and tables need their original context. View this article on the Second Life Wiki. Technical wording and examples are retained from the source; historical guidance may differ from current behavior.