llSetAgentRot

From Second Life Wiki
Revision as of 14:49, 26 September 2024 by Rider Linden (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Summary

Function: llSetAgentRot( rotation rot, integer flags );
0.0 Forced Delay
10.0 Energy

Sets the rotation the avatar to rot.

• rotation rot Rotation for avatar.
• integer flags Flags to control behavior of llSetAgentRot.

Specification

This function turns the avatar to face the direction indicated by rot.

flags is a placeholder for future expansion. There are no flags defined at this time, pass a constant value of 0.

Caveats

  • This function requires PERMISSION_TRIGGER_ANIMATION.
  • This function will only rotate an avatar around the yaw angle.
    • More complex rotations may be passed in, but the yaw is extracted and then renormalized.
  • Rotating to ZERO_ROTATION will face an avatar due east.
  • This function will not change the rotation for a seated avatar. Update the agent's sit target instead.
    • Special case: If the agent is seated on a prim WITHOUT a sit target they will be turned to face the set rotation when they stand.

Examples

// Turn the touching avatar to face the same direction as the prim.

default
{
    state_entry()
    {
        llSetText("Avatar Rotator", llGetColor(ALL_SIDES), 1.0);
    }

    touch_start(integer total_number)
    {
        llRequestPermissions(llDetectedKey(0), PERMISSION_TRIGGER_ANIMATION);
    }
    
    run_time_permissions(integer perm)
    {
        if (perm & PERMISSION_TRIGGER_ANIMATION)
        {
            llSetAgentRot(llGetRot());
        }
    }

}

See Also

Functions

•  llRequestPermissions

Deep Notes

Signature

function void llSetAgentRot( rotation rot, integer flags );