Difference between revisions of "LlSetStatus"

Revision as of 16:21, 16 December 2010

Function: llSetStatus( integer status, integer value );

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.
Setting STATUS_PHYSICS fails silently in attached objects. ~ #SVC-6549

		SVC-6549	A		llSetStatus can't change STATUS_PHYSICS of an attachment despite the status being preserved between attach & drop
		SVC-5531	A		llGetStatus(STATUS_ROTATE_Z); will not work on child prims on freshly rezzed objects.

<lsl>default {

   state_entry()
   {

llSetStatus( STATUS_DIE_AT_EDGE

SVC-6549	A	llSetStatus can't change STATUS_PHYSICS of an attachment despite the status being preserved between attach & drop
SVC-5531	A	llGetStatus(STATUS_ROTATE_Z); will not work on child prims on freshly rezzed objects.
SVC-1773	A	STATUS_BLOCK_GRAB only affects individual prims in a linkset
SVC-4197	A	Create STATUS_TRANSLATE_* flags for llSetStatus
SVC-5723	A	New constant STATUS_BLOCK_SIT

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

@@ Line 1: / Line 1: @@
-{{Issues/SVC-6549}}{{Issues/SVC-5531}}{{Issues/SVC-1773}}{{Issues/SVC-4197}}{{Issues/SVC-5723}}{{LSL_Function/boolean|value|bool=*}}{{LSL_Function
+{{LSL_Function
+|inject-2={{Issues/SVC-6549}}{{Issues/SVC-5531}}{{Issues/SVC-1773}}{{Issues/SVC-4197}}{{Issues/SVC-5723}}{{LSL_Function/boolean|value|bool=*}}
 |func_id=45|func_sleep=0.0|func_energy=10.0
 |func=llSetStatus
@@ Line 11: / Line 12: @@
 ** 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.
+* Setting [[STATUS_PHYSICS]] fails silently in attached objects. ~ [[#SVC-6549]]
 |constants={{LSL Constants/Status}}
 |examples=<lsl>default