Difference between revisions of "STATUS BLOCK GRAB"

From Second Life Wiki
Jump to navigation Jump to search
m (new JIRA information)
m (<lsl> tag to <source>)
 
(10 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Issues/SVC-6115}}{{Issues/SVC-1773}}{{LSL Constant
{{Issues/SVC-1773}}{{LSL Constant
|name={{PAGENAMEE}}
|name={{PAGENAMEE}}
|type=integer
|type=integer
|value={{LSL Hex|0x40|64}}
|value={{LSL Hex|0x40|64}}
|desc=This status flag keeps the object from being {{LSLGC|Grab|grabbed}}.
|desc=This status flag keeps the object from being moved by {{LSLGC|Grab|grabs}}. It will only block grab moves of unlinked prims or the root of a [[Viewerhelp:Glossary#linkset|linkset]].
*To block grab moves of an entire linkset use [[STATUS_BLOCK_GRAB_OBJECT]]


This means when a user tries to grab a physical object with this flag enabled, they will be unable to manipulate the object.
This means when a user tries to grab an object with this flag enabled, they will be unable to manipulate the object.
|examples=Due to {{JIRA|SVC-6115}}, in order to block grabbing in a link_set, unlink the whole object ('''make sure it isn't physical when you do that''') and drop this script into every prim (it self deletes) then re-link the set.<lsl>default
|examples=<source lang="lsl2">default
{
{
     state_entry()
     state_entry()
     {
     {
        // Block grabbing in this prim or the root if in a link_set
         llSetStatus(STATUS_BLOCK_GRAB, TRUE);
         llSetStatus(STATUS_BLOCK_GRAB, TRUE);
        llRemoveInventory(llGetScriptName());
     }
     }
}</lsl>
}</source>
|constants=
|constants=
{{!}}
{{!}}
{{LSL Constants/Status|no_default=*}}
{{LSL Constants/Status|no_default=*}}
|functions=
|functions=
{{LSL DefineRow||[[llDetectedGrab]]|}}
<!--{{LSL DefineRow||[[llDetectedGrab]]|}} not really -->
{{LSL DefineRow||[[llSetStatus]]|}}
{{LSL DefineRow||[[llSetStatus]]|}}
{{LSL DefineRow||[[llGetStatus]]|}}
{{LSL DefineRow||[[llGetStatus]]|}}
Line 27: Line 28:
|cat3=Grab
|cat3=Grab
|cat4
|cat4
|history={{LSL Added|0.2.0|remote=http://secondlife.wikia.com/wiki/Version_0.2.0}}
}}
}}

Latest revision as of 16:12, 23 January 2015

Description

Constant: integer STATUS_BLOCK_GRAB = 0x40;

The integer constant STATUS_BLOCK_GRAB has the value 0x40

This status flag keeps the object from being moved by grabs. It will only block grab moves of unlinked prims or the root of a linkset.

This means when a user tries to grab an object with this flag enabled, they will be unable to manipulate the object.

Caveats


Related Articles

Constants

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

Functions

•  llSetStatus
•  llGetStatus

Events

•  Touch

Examples

default
{
    state_entry()
    {
        // Block grabbing in this prim or the root if in a link_set
        llSetStatus(STATUS_BLOCK_GRAB, TRUE);
    }
}

Deep Notes

History

All Issues

~ Search JIRA for related Issues
   STATUS_BLOCK_GRAB only affects individual prims in a linkset

Footnotes

  1. ^ Early release notes were not very accurate or thorough, they sometimes included information about features added in previous releases or failed to include information about features added in that release.

Signature

integer STATUS_BLOCK_GRAB = 0x40;