Difference between revisions of "LlStopAnimation"

Revision as of 10:04, 15 September 2007

Function: llStopAnimation( string anim );

Stop animation anim for agent that owns or is sitting on object

• string

anim

–

an animation in the inventory of the prim this script is in or a UUID of an animation

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

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

If anim is missing from the prim's inventory and it is not a UUID or it is not an animation then an error is shouted on DEBUG_CHANNEL.
If anim is a UUID then there are no new asset permissions consequences for the object.
- The resulting object develops no new usage restrictions that might have occurred if the asset had been placed in the prims inventory.

Signature
function void llStopAnimation( string anim );

@@ Line 4: / Line 4: @@
 |p1_type=string|p1_name=anim
 |func_footnote
-|func_desc=Stop animation '''anim''' for agent that owns object
+|func_desc=Stop animation '''anim''' for agent that owns or is sitting on object
 |return_text
 |spec

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