Difference between revisions of "LlDetachFromAvatar"

From Second Life Wiki
Jump to navigation Jump to search
m
(Undo revision 57757 by Karzita Zabaleta (Talk) when an object is attached from inworld, that is when it is put in inventory)
Line 2: Line 2:
|func_id=114|func_sleep=0.0|func_energy=10.0
|func_id=114|func_sleep=0.0|func_energy=10.0
|sort=DetachFromAvatar|func=llDetachFromAvatar
|sort=DetachFromAvatar|func=llDetachFromAvatar
|func_footnote=The detached object is put into the user's inventory.
|func_footnote=The detached object remains in the user's inventory.
|func_desc=Detach object from avatar.
|func_desc=Detach object from avatar.
|return_text
|return_text
Line 11: Line 11:
<lsl>
<lsl>
default
default
{      
{
     attach(key AvatarKey)
     attach(key AvatarKey)
     {//give instructions for use and prevent item from being attached to avatar
     {//give instructions for use and prevent item from being attached to avatar
Line 37: Line 37:
|helpers
|helpers
|also_functions=
|also_functions=
{{LSL DefineRow||{{LSLG|llAttachToAvatar}}|}}
{{LSL DefineRow||[[llAttachToAvatar]]|}}
{{LSL DefineRow||{{LSLG|llGetAttached}}|}}
{{LSL DefineRow||[[llGetAttached]]|}}
|also_events=
|also_events=
{{LSL DefineRow||{{LSLG|attach}}|}}
{{LSL DefineRow||[[attach]]|}}
|also_articles
|also_articles
|notes=There is no way to delete an attachment with a script or to drop it to the ground.
|notes=There is no way to delete an attachment with a script or to drop it to the ground.

Revision as of 23:35, 8 March 2008

Summary

Function: llDetachFromAvatar( );

Detach object from avatar.

To run this function the script must request the PERMISSION_ATTACH permission with llRequestPermissions and it must be granted by the owner. The detached object remains in the user's inventory.

Caveats

Permissions
  • Do not depend upon the auto-grant status of permissions. Always use the run_time_permissions event.
  • If the script lacks the permission PERMISSION_ATTACH, the script will shout an error on DEBUG_CHANNEL and the operation fails (but the script continues to run).
  • If PERMISSION_ATTACH is granted by anyone other than the owner, then when the function is called an error will be shouted on DEBUG_CHANNEL.
  • Once the PERMISSION_ATTACH permission is granted there is no way to revoke it except from inside the script (for example, with a new llRequestPermissions call) or the script is reset or deleted.
All Issues ~ Search JIRA for related Bugs

Examples

<lsl> default {

   attach(key AvatarKey)
   {//give instructions for use and prevent item from being attached to avatar
       if(AvatarKey)
       {//event is called on both attach and detatch, but Key is only valid on attach
           llOwnerSay ("
           We hope you will enjoy your purchase, 
           but if you really want to use this item properly, you should: 
           1) drag it from your inventory to the ground 
           2) Right click on it and select \"open\"
           3) copy its contents to inventory.");
           llRequestPermissions(AvatarKey, PERMISSION_ATTACH );
       }
   }
   run_time_permissions(integer perm)
   {
       if(perm & PERMISSION_ATTACH)
       {
           llDetachFromAvatar( );
       }
   }

}

</lsl>

Notes

There is no way to delete an attachment with a script or to drop it to the ground.

See Also

Events

•  run_time_permissions Permission receiving event
•  attach

Functions

•  llGetPermissions Get the permissions granted
•  llGetPermissionsKey Get the agent who granted permissions
•  llRequestPermissions Request permissions
•  llAttachToAvatar
•  llGetAttached

Articles

•  Script permissions

Deep Notes

Search JIRA for related Issues

Signature

function void llDetachFromAvatar();