Difference between revisions of "LlGetRegionFlags"
Jump to navigation
Jump to search
m (LSL llGetRegionFlags moved to LlGetRegionFlags) |
m (Replaced <source> with <syntaxhighlight>) |
||
| (16 intermediate revisions by 6 users not shown) | |||
| Line 3: | Line 3: | ||
|func=llGetRegionFlags | |func=llGetRegionFlags | ||
|return_type=integer | |return_type=integer | ||
| | |func_desc | ||
| | |return_text=that is the region flags (REGION_FLAG_*) for the region the object is in. | ||
| | |func_footnote=Only a small number of flags are actually used; the rest (shown below in strike-through) are always zero. In particular, it is not possible to detect the status of "Allow Land Resell", "Allow Land Join/Divide", or "Block Land Show in Search"; nor, obviously, it is possible for a script to detect that "Disable Scripts" has been set. | ||
|spec | |spec | ||
|caveats | |caveats | ||
|constants | |constants={{LSL Constants/Region}} | ||
|examples | |examples=<syntaxhighlight lang="lsl2">default | ||
{ | |||
touch_start(integer total_number) | |||
{ | |||
if( llGetRegionFlags() & REGION_FLAG_SANDBOX ) | |||
{ | |||
llOwnerSay("Region is a sandbox."); | |||
} | |||
else | |||
{ | |||
llOwnerSay("Region is not a sandbox."); | |||
} | |||
} | |||
} | |||
</syntaxhighlight> | |||
|helpers | |helpers | ||
|also_functions | |also_functions= | ||
{{LSL DefineRow||[[llGetEnv]]|for region settings that don't fit in a flag}} | |||
{{LSL DefineRow||[[llGetParcelFlags]]|}} | |||
{{LSL DefineRow||[[llRequestSimulatorData]]}} | |||
|also_tests | |also_tests | ||
|also_events | |also_events | ||
|also_articles | |also_articles | ||
|notes | |notes | ||
| | |location={{SourceLink/github|viewer|indra/llmessage/llregionflags.h}} | ||
| | |history=<div> | ||
| | *{{SVN|960|rev=93583|branch=Release|anchor=file25|date=Saturday, 02 August 2008|ser=1.23.4.93096}} REGION_FLAGS_SKIP_MONO_SCRIPTS added.</div> | ||
|cat1= | |cat1=Region | ||
|cat2 | |cat2=Region/Flags | ||
|cat3 | |cat3 | ||
|cat4 | |cat4 | ||
}} | }} | ||
Latest revision as of 08:59, 11 February 2023
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: integer llGetRegionFlags( );| 0.0 | Forced Delay |
| 10.0 | Energy |
Returns an integer that is the region flags (REGION_FLAG_*) for the region the object is in.
Only a small number of flags are actually used; the rest (shown below in strike-through) are always zero. In particular, it is not possible to detect the status of "Allow Land Resell", "Allow Land Join/Divide", or "Block Land Show in Search"; nor, obviously, it is possible for a script to detect that "Disable Scripts" has been set.
| Flag | Value | Description |
|---|---|---|
| REGION_FLAG_ALLOW_DAMAGE | 0x00000001 | Find if a region is entirely damage enabled |
| REGION_FLAG_FIXED_SUN | 0x00000010 | Find if a region has a fixed sun position |
| REGION_FLAG_BLOCK_TERRAFORM | 0x00000040 | Find if a region terraforming disabled |
| REGION_FLAG_SANDBOX | 0x00000100 | Find if a region is a sandbox |
| REGION_FLAG_DISABLE_COLLISIONS | 0x00001000 | Find if a region has disabled collisions |
| REGION_FLAG_DISABLE_PHYSICS | 0x00004000 | Find if a region has disabled physics |
| REGION_FLAG_BLOCK_FLY | 0x00080000 | Find if a region blocks flying |
| REGION_FLAG_ALLOW_DIRECT_TELEPORT | 0x00100000 | Find if a region allows direct teleports |
| REGION_FLAG_RESTRICT_PUSHOBJECT | 0x00400000 | Find if a region restricts llPushObject calls |
| 0x00000002 | Can you make landmarks here? | |
| 0x00000004 | Do we allow the home position to be set here? | |
| 0x00000008 | Do we reset the home position when someone teleports away from here? | |
| 0x00000020 | Tax free zone (no taxes on objects, land, etc.) Taxes were abolished with SL version 1.2. See SL Wikia:Taxes | |
| 0x00000080 | Can't release, sell, or buy land. | |
| 0x00000200 | ||
| 0x00000400 | Region allows land reselling | |
| 0x00000800 | Region allows posting of classified ads | |
| 0x00002000 | ||
| 0x00008000 | ||
| 0x00010000 | ||
| 0x00020000 | ||
| 0x00040000 | ||
| 0x00200000 | Is there an administrative override on scripts in the region at the moment. This is the similar skip scripts, except this flag is persisted in the database on an estate level. | |
| 0x00800000 | ||
| 0x01000000 | ||
| 0x02000000 | ||
| 0x04000000 | ||
| 0x08000000 | ||
| 0x10000000 | ||
| 0x20000000 | ||
| 0x40000000 | ||
| 0x80000000 |
| † | REGION_FLAGS_* are internal and not exposed to the compiler (hence the strike through), despite this their values may be valid in the mask. In other words, there may be no nice name for the constant that the compiler will accept but the values may work. Remember that LL does not support these; they may redefine the flags without notice, this has happened in the past. |
| * | REGION_FLAGS_* flags in red have been removed from the source code, the values may get reassigned and reused! |
Examples
default
{
touch_start(integer total_number)
{
if( llGetRegionFlags() & REGION_FLAG_SANDBOX )
{
llOwnerSay("Region is a sandbox.");
}
else
{
llOwnerSay("Region is not a sandbox.");
}
}
}
See Also
Functions
| • | llGetEnv | – | for region settings that don't fit in a flag | |
| • | llGetParcelFlags | |||
| • | llRequestSimulatorData |
Deep Notes
History
SVN:960 r93583 Branch:Release s:1.23.4.93096 Saturday, 02 August 2008REGION_FLAGS_SKIP_MONO_SCRIPTS added.
Source
Signature |
|---|
function integer llGetRegionFlags(); |