llSetAgentRot

function

Function syntax

llSetAgentRot(

rotation rot,// Target rotation to turn the avatar to face.
integer flags// Flags to configure the rotation behavior. Values: AgentRotFlags

);

Energy: 10

Sets the rotation of the avatar to rot, controlled by flags.

Sets the rotation the avatar to rot.

llSetAgentRot(ZERO_ROTATION, 0);

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.
Viewers prior to 7.2.1.17108480561 will not show your own avatar’s rotation being affected by this function, but others will see your rotation update.

Examples

Example 1

16 collapsed lines
// 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);
        }
    }

}

llSetAgentRot

Specification

Caveats

Examples

See also

Functions