llGetAnimationOverride

Template:Needs Translation/LSL/de Template:Needs Translation/LSL/es Template:Needs Translation/LSL/el Template:Needs Translation/LSL/he Template:Needs Translation/LSL/it Template:Needs Translation/LSL/ko Template:Needs Translation/LSL/nl Template:Needs Translation/LSL/hu Template:Needs Translation/LSL/no Template:Needs Translation/LSL/da Template:Needs Translation/LSL/sv Template:Needs Translation/LSL/tr Template:Needs Translation/LSL/pl Template:Needs Translation/LSL/pt Template:Needs Translation/LSL/ru Template:Needs Translation/LSL/th Template:Needs Translation/LSL/uk Template:Needs Translation/LSL/zh-Hans Template:Needs Translation/LSL/zh-Hant

/LSL

GetAnimationOverride

llGetAnimationOverride

Summary

Function: string llGetAnimationOverride( string anim_state );

0.0	Forced Delay
?	Energy

Returns a string that is the name of the animation that is being used for the specified animation state (anim_state).

• string

anim_state

–

animation state

To run this function the script must request the PERMISSION_OVERRIDE_ANIMATIONS or PERMISSION_TRIGGER_ANIMATION permission with llRequestPermissions.

Value	Type	Description	Default
"Crouching"	State		crouch
"CrouchWalking"	State		crouchwalk
"Falling Down"	State		falldown
"Flying"	State		fly
"FlyingSlow"	State	Transition between hovering and forward flight.	flyslow
"Hovering"	State		hover
"Hovering Down"	State		hover_down
"Hovering Up"	State		hover_up
"Jumping"	State	While still in the air during a jump.	jump
"Landing"	Transition	When landing from a jump.	land
"PreJumping"	Transition	At the beginning of a jump.	prejump
"Running"	State		run
"Sitting"	State	Sitting on an object (and linked to it).	sit
"Sitting on Ground"	State	Sitting, but not linked to an object.[1]	sit_ground_constrained
"Standing"	State		stand
"Standing Up"	Transition	After falling a great distance. Sometimes referred to as Hard Landing.	standup
"Striding"	State	When the avatar is stuck on the edge of an object or on top of another avatar.	stride
"Soft Landing"	Transition	After falling a small distance.	soft_land
"Taking Off"	State		hover_up
"Turning Left"	State		turnleft
"Turning Right"	State		turnright
"Walking"	State		walk

Caveats

Permissions

Do not depend upon the auto-grant status of permissions. Always use the run_time_permissions event. If the script lacks both the permissions PERMISSION_OVERRIDE_ANIMATIONS and PERMISSION_TRIGGER_ANIMATION, the script will shout an error on DEBUG_CHANNEL and the operation fails (but the script continues to run). Once the PERMISSION_OVERRIDE_ANIMATIONS permission is granted there may be no way to revoke it except from inside the script (for example, with a new llRequestPermissions call) or if the script is reset. Furthermore even if the script loses the permission (or is derezzed), it will not reset/revert the overridable animations. For Viewer 3.6.7 and up: If the object is not attached to the permission granter but is in the same region, then Me>Movement>Stop Animating Me will revoke both PERMISSION_TRIGGER_ANIMATION and PERMISSION_OVERRIDE_ANIMATIONS (other permissions will remain). In this case, overrides are reset. Once the PERMISSION_TRIGGER_ANIMATION permission is granted there may be no way to revoke it except from inside the script (for example, with a new llRequestPermissions call) or if the script is reset. For Viewer 3.6.7 and up: If the object is not attached to the permission granter but is in the same region, then Me>Movement>Stop Animating Me will revoke both PERMISSION_TRIGGER_ANIMATION and PERMISSION_OVERRIDE_ANIMATIONS (other permissions will remain).

Examples

//    llGetAnimationOverride Example
//    A Script to check the animation Stats on
//  all available overridable animations.
//    By Kanashio Koroshi


default
{
    state_entry()
    {
        llRequestPermissions(llGetOwner(),
            PERMISSION_OVERRIDE_ANIMATIONS);
    }

    run_time_permissions(integer permissions)
    {
        if (permissions & PERMISSION_OVERRIDE_ANIMATIONS)
        {
            llOwnerSay("Listing Overridden Animations");
            llOwnerSay(llGetAnimationOverride("Crouching"));
            llOwnerSay(llGetAnimationOverride("CrouchWalking"));
            llOwnerSay(llGetAnimationOverride("Falling Down"));
            llOwnerSay(llGetAnimationOverride("Flying"));
            llOwnerSay(llGetAnimationOverride("FlyingSlow"));
            llOwnerSay(llGetAnimationOverride("Hovering"));
            llOwnerSay(llGetAnimationOverride("Hovering Down"));
            llOwnerSay(llGetAnimationOverride("Hovering Up"));
            llOwnerSay(llGetAnimationOverride("Jumping"));
            llOwnerSay(llGetAnimationOverride("Landing"));
            llOwnerSay(llGetAnimationOverride("PreJumping"));
            llOwnerSay(llGetAnimationOverride("Running"));
            llOwnerSay(llGetAnimationOverride("Sitting"));
            llOwnerSay(llGetAnimationOverride("Sitting on Ground"));
            llOwnerSay(llGetAnimationOverride("Standing"));
            llOwnerSay(llGetAnimationOverride("Standing Up"));
            llOwnerSay(llGetAnimationOverride("Striding"));
            llOwnerSay(llGetAnimationOverride("Soft Landing"));
            llOwnerSay(llGetAnimationOverride("Taking Off"));
            llOwnerSay(llGetAnimationOverride("Turning Left"));
            llOwnerSay(llGetAnimationOverride("Turning Right"));
            llOwnerSay(llGetAnimationOverride("Walking"));
        }
    }
}

See Also

Events

•

run_time_permissions

–

Permission receiving event

Functions

•	llGetPermissions	–	Get the permissions granted
•	llGetPermissionsKey	–	Get the agent who granted permissions
•	llRequestPermissions	–	Request permissions
•	llSetAnimationOverride
•	llResetAnimationOverride

Articles

•	Script permissions
•	Internal_Animations	–	lists internal Animations always available

Deep Notes

History

Date of Release 12/04/2013

Footnotes

1. ^ "Sit down" on the avatar context menu allows ground sits anywhere: atop the terrain, objects or even in the air.

Signature
function string llGetAnimationOverride( string anim_state );