llSetAgentRot

From Second Life Wiki
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

KBwarning.png Warning: This function or parameter requires a viewer update to function correctly.

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.
  • Currently the viewer has not been updated to handle updates to your own avatar correctly. However it is possible for others to see your avatar rotating and vice versa for you to able to see other avatars being rotated with this function.

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(), 0);
        }
    }

}

See Also

Functions

•  llRequestPermissions

Deep Notes

Signature

function void llSetAgentRot( rotation rot, integer flags );