Difference between revisions of "LlSetStatus"

Revision as of 06:13, 16 December 2010

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, TRUE enables, FALSE disables

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}

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.
  - Use STATUS_BLOCK_GRAB_OBJECT to block grabbing of a link_set.
STATUS_PHYSICS fails silently in attached objects, regardless of setting.

<lsl>default {

   state_entry()
   {

llSetStatus( STATUS_DIE_AT_EDGE

Signature
function void llSetStatus( integer status, integer value );

@@ Line 1: / Line 1: @@
-{{Issues/SVC-5531}}{{Issues/SVC-1773}}{{Issues/SVC-4197}}{{Issues/SVC-5723}}{{LSL_Function
+{{Issues/SVC-6549}}{{Issues/SVC-5531}}{{Issues/SVC-1773}}{{Issues/SVC-4197}}{{Issues/SVC-5723}}{{LSL_Function/boolean|value|bool=*}}{{LSL_Function
 |func_id=45|func_sleep=0.0|func_energy=10.0
 |func=llSetStatus
 |p1_type=integer|p1_name=status|p1_desc=bit mask, STATUS_* flags
-|p2_type=integer|p2_name=value|p2_desc=boolean
+|p2_type=integer|p2_name=value
 |func_footnote
 |func_desc=Sets the object status attributes indicated in the '''status''' mask to '''value'''
@@ Line 9: / Line 9: @@
 |spec
 |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.
+** Except for [[STATUS_BLOCK_GRAB]], this only affects the prim the script is in, child prims in linked objects will not be affected.
-*STATUS_PHYSICS fails silently in attached objects, regardless of setting
+***Use [[STATUS_BLOCK_GRAB_OBJECT]] to block grabbing of a link_set.
+*STATUS_PHYSICS fails silently in attached objects, regardless of setting.
 |constants={{LSL Constants/Status}}
 |examples=<lsl>default