llSetAgentRot

From Second Life Wiki
Revision as of 09:32, 26 September 2024 by Rider Linden (talk | contribs) (Created page with "{{LSL_Function |func_id=|func_sleep=0.0|func_energy=10.0 |func=llSetAgentRot |p1_type=rotation|p1_name=rot |func_desc=Sets the rotation the avatar to {{LSLP|rot}}. |return_tex...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Summary

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

Sets the rotation the avatar to rot.

• rotation rot

Specification

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

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 );