Difference between revisions of "LlResetAnimationOverride"

Revision as of 21:13, 25 March 2013

Function: llResetAnimationOverride( string anim_state );


0.0	Forced Delay
?	Energy

Resets the animation override of the specified animation state (anim_state) to the corresponding default value.

• string

–

animation state to be reset

To run this function the script must request the PERMISSION_OVERRIDE_ANIMATIONS permission with llRequestPermissions. If anim_state equals "ALL", all animation states are reset.

Do not depend upon the auto-grant status of permissions. Always use the run_time_permissions event.
If the script lacks the permission PERMISSION_OVERRIDE_ANIMATIONS, 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.

Signature
function void llResetAnimationOverride( string anim_state );

@@ Line 5: / Line 5: @@
 |func=llResetAnimationOverride|sort=ResetAnimationOverride
 |p1_type=string|p1_name=anim_state|p1_desc=animation state to be reset
-|func_footnote=If {{LSLPT|anim_state}} equals "ALL", all animation overrides are reset.
+|func_footnote=If {{LSLPT|anim_state}} equals "ALL", all animation states are reset.
-|func_desc=Resets the animation override of the specified animation state ({{LSLPT|anim_state}}) to the correct default value.
+|func_desc=Resets the animation override of the specified animation state ({{LSLPT|anim_state}}) to the corresponding default value.
 |spec
 |caveats

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

•	Script permissions
•	Internal_Animations	–	lists internal Animations always available