Difference between revisions of "LlSetStatus"

From Second Life Wiki
Jump to: navigation, search
(Undo revision 1128561 by Joshua Philgarlic (Talk))
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_id=45|func_sleep=0.0|func_energy=10.0
 
|func=llSetStatus
 
|func=llSetStatus
 
|p1_type=integer|p1_name=status|p1_desc=bit mask, STATUS_* flags
 
|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_footnote
 
|func_desc=Sets the object status attributes indicated in the '''status''' mask to '''value'''
 
|func_desc=Sets the object status attributes indicated in the '''status''' mask to '''value'''
Line 9: Line 9:
 
|spec
 
|spec
 
|caveats=*Status is an object attribute; all prims in an object share the same status.
 
|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}}
 
|constants={{LSL Constants/Status}}
 
|examples=<lsl>default
 
|examples=<lsl>default

Revision as of 07:13, 16 December 2010

Summary

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
Constants Value Default Description
STATUS_BLOCK_GRAB 0x040 FALSE Prevent click-and-drag movement on the root prim
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_EDGE - If the object is rezzed by a script, the default is TRUE

Caveats

  • Status is an object attribute; all prims in an object share the same status.
  • STATUS_PHYSICS fails silently in attached objects, regardless of setting.

Important Issues

~ All Issues ~ Search JIRA for related Bugs
   llSetStatus can't change STATUS_PHYSICS of an attachment despite the status being preserved between attach & drop
   llGetStatus(STATUS_ROTATE_Z); will not work on child prims on freshly rezzed objects.

Examples

<lsl>default {

   state_entry()
   {
llSetStatus( STATUS_DIE_AT_EDGE

See Also

Functions

•  llGetStatus Gets the object status.

Deep Notes

All Issues

~ Search JIRA for related Issues
   llSetStatus can't change STATUS_PHYSICS of an attachment despite the status being preserved between attach & drop
   llGetStatus(STATUS_ROTATE_Z); will not work on child prims on freshly rezzed objects.
   STATUS_BLOCK_GRAB only affects individual prims in a linkset
   Create STATUS_TRANSLATE_* flags for llSetStatus
   New constant STATUS_BLOCK_SIT

Signature

function void llSetStatus( integer status, integer value );