Difference between revisions of "LlSetStatus"

From Second Life Wiki
Jump to navigation Jump to search
(Added commentary on STATUS_BLOCK_GRAB with code example and refernce to JIRA link for more information.)
m (better comment wording in script example)
Line 25: Line 25:
{
{
     state_entry() {
     state_entry() {
         llSetStatus(STATUS_BLOCK_GRAB,TRUE);          // Set No grab setting for prim.
         llSetStatus(STATUS_BLOCK_GRAB,TRUE);          // Set 'No grab' flag on prim.
         llOwnerSay("'No Grab' was set!");
         llOwnerSay("'No Grab' was set!");
         llRemoveInventory(llGetScriptName());
         llRemoveInventory(llGetScriptName());

Revision as of 19:24, 9 December 2008

Summary

Function: llSetStatus( integer status, integer value );
0.0 Forced Delay
10.0 Energy

Sets the object status attributes indicated in the status mask to value

• integer status bit mask, STATUS_* flags
• integer value boolean

Constants Value Default Description
STATUS_PHYSICS 0x001 FALSE Object is physical
STATUS_ROTATE_X 0x002 TRUE Can turn along this axis (physical objects only)
STATUS_ROTATE_Y 0x004 TRUE Can turn along this axis (physical objects only)
STATUS_ROTATE_Z 0x008 TRUE Can turn along this axis (physical objects only)
STATUS_PHANTOM 0x010 FALSE Object is phantom
STATUS_SANDBOX 0x020 FALSE Keep object within 10 meters and in the same region
STATUS_BLOCK_GRAB 0x040 FALSE Prevent click-and-drag movement on the root prim
Constants Value Default Description
STATUS_DIE_AT_EDGE 0x080 FALSE* Delete and do not return object if it goes off world
STATUS_RETURN_AT_EDGE 0x100 FALSE Return object to owner if it goes off world
STATUS_CAST_SHADOWS 0x200 TRUE not currently used
STATUS_BLOCK_GRAB_OBJECT 0x400 FALSE Prevent click-and-drag movement on all prims in the object
STATUS_DIE_AT_NO_ENTRY 0x800 FALSE Delete and do not return object if it cannot enter a parcel
* STATUS_DIE_AT_EDGE - If the object is rezzed by a script, the default is TRUE
STATUS_DIE_AT_NO_ENTRY - No-copy objects ignore this flag and remain in-world

Caveats

  • Status is an object attribute; all prims in an object share the same status.
    • Except for STATUS_BLOCK_GRAB, this only affects the prim the script is in, child prims in linked objects will not be affected.

Examples

<lsl>default {

   state_entry()
   {
llSetStatus( STATUS_DIE_AT_EDGE

See Also

Functions

•  llGetStatus Gets the object status.

Deep Notes

Signature

function void llSetStatus( integer status, integer value );