llDerezObject

From Second Life Wiki
Revision as of 17:25, 23 June 2024 by Lucia Nightfire (talk | contribs) (Clarified that the rezzer of the target object's root prim is what determines success/fail when using this function on any prim in a linkset.)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

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 an integer Returns success or 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.

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.

Examples

Deep Notes

Signature

function integer llDerezObject( key id, integer flag );