OsDropAttachmentAt

From OpenSimulator

(Difference between revisions)
Jump to: navigation, search
(creating basic documentation)
 
m (Change See Also)
 
(9 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
{{osslfunc
 
{{osslfunc
|function_syntax=Void osDropAttachmentAt(Vector3 pos, Quaternion rot)
+
|function_syntax= osDropAttachmentAt(vector pos, rotation rot)
 
|threat_level=Moderate
 
|threat_level=Moderate
 +
|permissions=${OSSL|osslParcelO}ESTATE_MANAGER,ESTATE_OWNER
 +
|delay=0
 
|description=Requires script to be granted [[PERMISSION_ATTACH]], drops an attachment at position '''pos''' with rotation '''rot'''
 
|description=Requires script to be granted [[PERMISSION_ATTACH]], drops an attachment at position '''pos''' with rotation '''rot'''
 +
|ossl_example=<source lang="lsl">
 +
//
 +
// osDropAttachmentAt Script Example (XEngine)
 +
// Author: djphil
 +
//
 +
 +
vector pos;
 +
rotation rot;
 +
 +
default
 +
{
 +
    state_entry()
 +
    {
 +
        pos = llGetPos();
 +
        rot = llGetRot();
 +
 +
        llSay(PUBLIC_CHANNEL, "Touch to see llAttachToAvatar attach this object to your avatar's left hand.");
 +
        llSay(PUBLIC_CHANNEL, "Touch it again to see osDropAttachmentAt drop this object to its original position and rotation.");
 +
        llSay(PUBLIC_CHANNEL, "The posistion is " + (string)pos + " and the rotation is " + (string)rot);
 +
    }
 +
 +
    touch_start(integer number)
 +
    {
 +
        if (!llGetAttached())
 +
        {
 +
            llRequestPermissions(llGetOwner(), PERMISSION_ATTACH);
 +
        }
 +
 +
        else if (llGetAttached())
 +
        {
 +
            osDropAttachmentAt(pos, rot);
 +
        }
 +
    }
 +
 +
    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();
 +
        }
 +
    }
 +
}
 +
</source>
 +
''' For YEngine: '''
 +
<source lang="lsl">
 +
//
 +
// osDropAttachmentAt Script Example (YEngine)
 +
// Author: djphil
 +
//
 +
 +
vector pos;
 +
rotation rot;
 +
 +
default
 +
{
 +
    state_entry()
 +
    {
 +
        pos = llGetPos();
 +
        rot = llGetRot();
 +
 +
        llSay(PUBLIC_CHANNEL, "Touch to see llAttachToAvatar attach this object to your avatar's left hand.");
 +
        llSay(PUBLIC_CHANNEL, "Touch it again to see osDropAttachmentAt drop this object to its original position and rotation.");
 +
        llSay(PUBLIC_CHANNEL, "The posistion is " + (string)pos + " and the rotation is " + (string)rot);
 +
    }
 +
 +
    touch_start(integer number)
 +
    {
 +
        if (!llGetAttached())
 +
        {
 +
            llRequestPermissions(llGetOwner(), PERMISSION_ATTACH);
 +
        }
 +
 +
        else if (llGetAttached())
 +
        {
 +
            osDropAttachmentAt(pos, rot);
 +
        }
 +
    }
 +
 +
    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();
 +
        }
 +
    }
 +
}
 +
</source>
 +
|additional_info=This function was added in 0.7.5-post-fixes.<br>
 +
See [http://wiki.secondlife.com/wiki/Template:LSL_Constants_Attachment Attachment Points] for the complete list of LSL Attachment Points Constants.
 
}}
 
}}
 +
== See Also ==
 +
* [[osForceAttachToAvatar]]
 +
* [[osForceAttachToAvatarFromInventory]]
 +
* [[osForceAttachToOtherAvatarFromInventory]]
 +
* [[osForceDetachFromAvatar]]
 +
* [[osForceDropAttachment]]
 +
* [[osForceDropAttachmentAt]]
 +
* [[osDropAttachment]]
 +
* [[osDropAttachmentAt]]

Latest revision as of 19:43, 5 December 2020

osDropAttachmentAt(vector pos, rotation rot)
Requires script to be granted PERMISSION_ATTACH, drops an attachment at position pos with rotation rot
Threat Level Moderate
Permissions ${OSSL|osslParcelO}ESTATE_MANAGER,ESTATE_OWNER
Extra Delay 0 seconds
Example(s)
//
// osDropAttachmentAt Script Example (XEngine)
// Author: djphil
//
 
vector pos;
rotation rot;
 
default
{
    state_entry()
    {
        pos = llGetPos();
        rot = llGetRot();
 
        llSay(PUBLIC_CHANNEL, "Touch to see llAttachToAvatar attach this object to your avatar's left hand.");
        llSay(PUBLIC_CHANNEL, "Touch it again to see osDropAttachmentAt drop this object to its original position and rotation.");
        llSay(PUBLIC_CHANNEL, "The posistion is " + (string)pos + " and the rotation is " + (string)rot);
    }
 
    touch_start(integer number)
    {
        if (!llGetAttached())
        {
            llRequestPermissions(llGetOwner(), PERMISSION_ATTACH);
        }
 
        else if (llGetAttached())
        {
            osDropAttachmentAt(pos, rot);
        }
    }
 
    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:

//
// osDropAttachmentAt Script Example (YEngine)
// Author: djphil
//
 
vector pos;
rotation rot;
 
default
{
    state_entry()
    {
        pos = llGetPos();
        rot = llGetRot();
 
        llSay(PUBLIC_CHANNEL, "Touch to see llAttachToAvatar attach this object to your avatar's left hand.");
        llSay(PUBLIC_CHANNEL, "Touch it again to see osDropAttachmentAt drop this object to its original position and rotation.");
        llSay(PUBLIC_CHANNEL, "The posistion is " + (string)pos + " and the rotation is " + (string)rot);
    }
 
    touch_start(integer number)
    {
        if (!llGetAttached())
        {
            llRequestPermissions(llGetOwner(), PERMISSION_ATTACH);
        }
 
        else if (llGetAttached())
        {
            osDropAttachmentAt(pos, rot);
        }
    }
 
    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.


[edit] See Also

Personal tools
General
About This Wiki