llSetAnimationOverride

From Second Life Wiki
Revision as of 20:36, 25 March 2013 by Strife Onizuka (talk | contribs) (Created page with "{{LSL_Function |inject-2= {{LSL_Function/permission|PERMISSION_OVERRIDE_ANIMATIONS}} {{LSL_Function/inventory|anim|uuid=false|type=animation}} |func_id=?|func_sleep=0.0|func_ener…")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Summary

Function: llSetAnimationOverride( string anim_state, string anim );

Set the animation (anim) that will play for the given animation state (anim_state).

• string anim_state animation state to be overriden
• string anim an animation in the inventory of the prim this script is in or the name of a built-in animation

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

Caveats

Permissions
  • 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.
  • If anim is missing from the prim's inventory or it is not an animation then an error is shouted on DEBUG_CHANNEL.

Examples

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
•  llGetAnimationOverride
•  llResetAnimationOverride

Articles

•  Script permissions
•  Internal_Animations lists internal Animations always available

Deep Notes

Signature

function void llSetAnimationOverride( string anim_state, string anim );