LlDerezObject: Difference between revisions

From Second Life Wiki
Jump to navigation Jump to search
Rider Linden (talk | contribs)
No edit summary
Nexii Malthus (talk | contribs)
Clarify it is the derezzer's inventory
 
Line 9: Line 9:
|spec=
|spec=
Deletes, or marks temp, an object that was previously rezzed by this script. The object's root prim must have been previously rezzed from a script within this object.  
Deletes, or marks temp, an object that was previously rezzed by this script. The object's root prim must have been previously rezzed from a script within this object.  
If the object is successfully deleted this function returns TRUE, if it fails for any reason it returns false.
If the object is successfully deleted this function returns TRUE, if it fails for any reason it returns FALSE.
|caveats=
|caveats=
* The targeted object's rezzer must be the same as the object hosting this script
* The targeted object's rezzer must be the same as the object hosting this script
Line 40: Line 40:
{{!}} [[DEREZ_TO_INVENTORY]]
{{!}} [[DEREZ_TO_INVENTORY]]
{{!}} 2
{{!}} 2
{{!}} Returns the targeted object to inventory and saves its current state.
{{!}} Returns the targeted object to derezzer's inventory and saves its current state.
{{!}}}
{{!}}}



Latest revision as of 20:23, 21 April 2025

Summary

Function: integer llDerezObject( key id, integer flag );
0.0 Forced Delay
10.0 Energy

Derezzes an object previously rezzed from within the object containing the script.
Returns a boolean (an integer) which is TRUE for success or FALSE for failure.

• key id The ID of an object in the region.
• integer flag Deletion options.

Specification

Deletes, or marks temp, an object that was previously rezzed by this script. The object's root prim must have been previously rezzed from a script within this object. If the object is successfully deleted this function returns TRUE, if it fails for any reason it returns FALSE.

Constant Value Description
DEREZ_DIE 0 Immediately delete the object.
DEREZ_MAKE_TEMP 1 Mark the object as temporary so that the simulator will remove the object at a later time.
DEREZ_TO_INVENTORY 2 Returns the targeted object to derezzer's inventory and saves its current state.

Caveats

  • The targeted object's rezzer must be the same as the object hosting this script
  • The target must not be an attachment
  • The target must be copyable
  • The target's owner must be the same as the script's owner.
  • When marking an object as temporary, the object must not contribute to the navmesh.
  • When using DEREZ_TO_INVENTORY there are a few other restrictions:
    • The derezzer must not be an attachment.
    • The derezzer must be modifiable.
    • The object in the derezzer's inventory must still exist.
    • The object in the derezzer's inventory must not be a coalesced object.

Examples

Deep Notes

Signature

function integer llDerezObject( key id, integer flag );