OsDropAttachment

From OpenSimulator

(Difference between revisions)
Jump to: navigation, search
m (Add Author)
m (Remove space)
Line 139: Line 139:
 
See [http://wiki.secondlife.com/wiki/Template:LSL_Constants_Attachment Attachment Points] for the complete list of LSL Attachment Points Constants.
 
See [http://wiki.secondlife.com/wiki/Template:LSL_Constants_Attachment Attachment Points] for the complete list of LSL Attachment Points Constants.
 
}}
 
}}
'''See Also: '''
+
'''See Also:'''
 
* [[osForceAttachToAvatar]]
 
* [[osForceAttachToAvatar]]
 
* [[osForceAttachToAvatarFromInventory]]
 
* [[osForceAttachToAvatarFromInventory]]

Revision as of 16:06, 24 November 2020

osDropAttachment()
Requires script to be granted PERMISSION_ATTACH, drops an attachment like a user-triggered attachment drop.
Threat Level Moderate
Permissions ${OSSL|osslParcelO}ESTATE_MANAGER,ESTATE_OWNER
Extra Delay 0 seconds
Example(s)
//
// osDropAttachment Script Example (XEngine)
// Author: djphil
//
 
default
{
    state_entry()
    {
        llSay(PUBLIC_CHANNEL, "Touch to see llAttachToAvatar attach this object to your avatar's left hand.");
        llSay(PUBLIC_CHANNEL, "Touch it again to see osDropAttachment drop this object on the ground in front of your avatar.");
    }
 
    touch_start(integer number)
    {
        if (!llGetAttached())
        {
            llRequestPermissions(llGetOwner(), PERMISSION_ATTACH);
        }
 
        else if (llGetAttached())
        {
            osDropAttachment();
        }
    }
 
    run_time_permissions(integer perm)
    {
        if (perm & PERMISSION_ATTACH)     
        {
            llAttachToAvatar(ATTACH_LHAND); 
        }
 
        else
        {
            llOwnerSay("Permission to attach denied");
        }
    }
 
    // The attach event is called on both attach and detach.
    attach(key id)
    {
        // Test if is a valid key and not NULL_KEY ('id' is only valid on attach)
        if (id && id != NULL_KEY)
        {
            llOwnerSay("The object is attached to " + llKey2Name(id));
        }
 
        else 
        {
            llOwnerSay("The object is not attached!");
        }
    }
 
    on_rez(integer param)
    {
        // Reset the script if it's not attached.
        if (!llGetAttached())        
        {
            llResetScript();
        }
    }
}

For YEngine:

//
// osDropAttachment Script Example (YEngine)
// Author: djphil
//
 
default
{
    state_entry()
    {
        llSay(PUBLIC_CHANNEL, "Touch to see llAttachToAvatar attach this object to your avatar's left hand.");
        llSay(PUBLIC_CHANNEL, "Touch it again to see osDropAttachment drop this object on the ground in front of your avatar.");
    }
 
    touch_start(integer number)
    {
        if (!llGetAttached())
        {
            llRequestPermissions(llGetOwner(), PERMISSION_ATTACH);
        }
 
        else if (llGetAttached())
        {
            osDropAttachment();
        }
    }
 
    run_time_permissions(integer perm)
    {
        if (perm & PERMISSION_ATTACH)     
        {
            llAttachToAvatar(ATTACH_LHAND); 
        }
 
        else
        {
            llOwnerSay("Permission to attach denied");
        }
    }
 
    // The attach event is called on both attach and detach.
    attach(key id)
    {
        // Test if is a valid key ('id' is only valid on attach)
        if (id)
        {
            llOwnerSay("The object is attached to " + llKey2Name(id));
        }
 
        else 
        {
            llOwnerSay("The object is not attached!");
        }
    }
 
    on_rez(integer param)
    {
        // Reset the script if it's not attached.
        if (!llGetAttached())        
        {
            llResetScript();
        }
    }
}
Notes
This function was added in 0.7.5-post-fixes.

See Attachment Points for the complete list of LSL Attachment Points Constants.


See Also:

Personal tools
General
About This Wiki