llGetAnimation

From Second Life Wiki
Jump to navigation Jump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

Summary

Function: string llGetAnimation( key id );

Returns a string that is the name of the currently playing locomotion animation for avatar id. See the table below.

• key id avatar UUID that is in the same region

llGetAgentInfo provides information on some animation states not covered by this function (typing, away, busy). llGetAnimationList provides more detailed information about the running animations, but may not reflect avatar state as accurately as llGetAnimation.

Value Description
"" During logout
"Crouching"
"CrouchWalking"
"Falling Down"
"Flying"
"FlyingSlow"
"Hovering"
"Hovering Down"
"Hovering Up"
"Jumping" While still in the air during a jump.
"Landing" When landing from a jump.
"PreJumping" At the beginning of a jump.
Value Description
"Init" At login and after teleports.
"Running"
"Sitting" Sitting on an object.
"Sitting on Ground" Sitting on the terrain.
"Standing"
"Standing Up" After falling a great distance. Sometimes referred to as Hard Landing.
"Striding" When the avatar is stuck on the edge of an object or on top of another avatar.
"Soft Landing" After falling a small distance.
"Taking Off"
"Turning Left"
"Turning Right"
"Walking"

Caveats

  • This function can return an empty string while the avatar is logging out.
  • New return values could conceivably be added at any time and this list may not in-fact be complete. Scripts should be written under the assumption that they may receive a value they won't recognize.
All Issues ~ Search JIRA for related Bugs

Examples

<lsl> // A simple animation override example. // Make the avatar do backflips when jumping.

key gOwner; //the wearer's key


// User functions

Initialize(key id) {

   if (id == NULL_KEY) { // detaching
       llSetTimerEvent(0.0); // stop the timer
   }
   else { // attached, or reset while worn
       llRequestPermissions(id, PERMISSION_TRIGGER_ANIMATION);
       gOwner = id;
   }

}


// Event handlers

default {

   state_entry() {
       // in case the script was reset while already attached
       if (llGetAttached() != 0) {
           Initialize(llGetOwner());
       }
   }
   attach(key id) {
       Initialize(id);
   }
   run_time_permissions(integer perm) {
       if (perm & PERMISSION_TRIGGER_ANIMATION) {
           llSetTimerEvent(0.25); // start polling
       }
   }
   timer() {
       if (llGetAnimation(gOwner) == "Jumping") {
           
           // You can stop the built-in animation if you like, if
           // it might interfere with your own. Be aware that an
           // avatar can become stuck, and some llGetAgentInfo results
           // can be inaccurate, if you stop built-ins indiscriminately.
           // Always test.
           //
           // llStopAnimation("jump");
           llStartAnimation("backflip");
       }
   }

}

</lsl>

See Also

Functions

•  llGetAgentInfo
•  llGetAnimationList

Deep Notes

Search JIRA for related Issues

Signature

function string llGetAnimation( key id );