Second Life Wiki - User contributions [en]

Category:LSL Float

Maestro Linden — Tue, 31 Mar 2026 18:26:33 GMT

Maestro Linden: add caveat that float equality comparison is not a good approach

{{LSL Header|ml=*}}
{{RightToc}}{{LSLC|}}{{LSLC|Types}}
The LSL "float" type is a {{wikipedia|Floating point|floating point}} data type that uses 32 bit in {{Wikipedia|IEEE_floating_point|IEEE-754}} form.
If a number is written with a decimal point in LSL, then it is taken to be a float.

The valid range is 1.401298464E-45 to 3.402823466E+38

Floats can be specified in scientific notation such as 2.6E-5.

If a function requires a float as a parameter, and the number is an integer (e.g. 5), you can add the .0 to clearly indicate it's a float, but omitting the .0 is equally valid and actually saves bytecode space in the compiled code.

When dividing 2 constants, defining them as floats will avoid the chance of unwanted rounding down. Better still, do the math on your calculator and save the server some cycles.

<div id="box">
== Examples ==
<div style="padding: 0.5em">
<syntaxhighlight lang="lsl2">float min = 1.175494351E-38;
float max = 3.402823466E+38;
float sci = 2.6E-5;
float sci_a = 2.6E+3;
float sci_b = 2.6E3;
float sci_c = 26000.E-1;
float f = 2600; //implicitly typecast to a float
float E = 85.34859;
float cast = (float)"42"; //explicit typecast to a float
float hex_float = (float)"0x1.5p5"; // C99 style hex floats are allowed when cast from strings, but not as direct literals
float Infintity = (float)"inf"; //-- may be negative, will cause a math error if evaluated in LSO, see 'caveats' below
float NotANumber = (float)"nan"; //-- may be negative, will cause a math error if evaluated in LSO, see 'caveats' bleow
</syntaxhighlight>
</div></div>

<div id="box">
== Useful Snippets ==
<div style="padding: 0.5em">
If you need to validate an arbitrary float without limitations then the following function is ideal:
<syntaxhighlight lang="lsl2">integer isValidFloat(string s) { return (string)((float)s) != (string)((float)("-" + llStringTrim(s, STRING_TRIM_HEAD))); }</syntaxhighlight>

However, the following is more efficient, but comes with the noted caveats. If these are not an issue to you then it is the recommended option, particularly under Mono:
<syntaxhighlight lang="lsl2">integer isValidFloat(string s) { return (float)(s + "1") != 0.0; }</syntaxhighlight>

'''Caveats''':
* LSO-LSL scientific notation with an exponent greater than 38 will fail (throw a Math Error). Mono is unaffected as it supports <code>infinity</code>
* Under both Mono and LSO-LSL you may find strange results if dealing with strings containing more than 9 decimal places. Remember that string casting in LSL only gives up to 6 so is safe, and human input is rarely going to be that accurate, plus values that small are not usually all that useful.
* Due to the limited precision with which floats are stored, not all integer values can be accurately held in a float: only the values between -16,777,216 and 16,777,216 are precise. Between +/-16,777,216 and +/-33,554,432 values are rounded to even numbers, beyond +/-33,544,432 they are rounded to multiples of 4, etc. The rounding is towards the nearest value, or towards zero if both are equally far.
* "nan" (not-a-number), "inf" (infinity) and their negatives are special text values that can be cast from a string (with any leading spaces or trailing characters). those values will cause a math error when the variable is evaluated in LSO. If you are parsing user data, by casting a string to a float, use the following code (replacing vStrDta with your string variable name) see [https://jira.secondlife.com/browse/SVC-6847 SVC-6847]: <syntaxhighlight lang="lsl2">(float)llList2String( llParseStringKeepNulls( llToLower( llStringTrim( vStrDta, STRING_TRIM ) ), ["inf", "nan"], [] ), 0 )</syntaxhighlight>
* Under both Mono and LSO-LSL, equality comparisons between two float values are not recommended. Instead, consider comparison with a small tolerance value, such as: <syntaxhighlight lang="lsl2">llAbs(a - b) < epsilon</syntaxhighlight>

However, both of the above snippets will stop validating at the first character that is not valid in a float string. The following code rigorously validates the whole of a string to ensure it represents a float (and nothing else), at the cost of speed and memory footprint.
<syntaxhighlight lang="lsl2">
// Validate a string containing a float value
// Does not handle scientific notation, or hex floats (!!)
// After all, this is designed for 95% of likely human entered data

integer ValidateSimpleFloat(string sin)
{
sin = llToLower(sin);
// Avoid run time fail (for lslEditor at least) if string looks remotely like scientific notation
if (llSubStringIndex(sin, "e") != -1) return FALSE;
list temp = llParseStringKeepNulls(sin, ["."], [] );
string subs = llList2String(temp, 0);
if ( (string) ( (integer) subs) != subs) return FALSE;
if ( (temp != []) > 2) return FALSE;
if ( (temp != [])== 2)
{
subs = llList2String(temp, 1); // extract the decimal part
// must have no sign after DP, so handle first decimal discretely
string first = llGetSubString(subs, 0, 0);
if ( (string) ( (integer) first) != first) return FALSE;
if ( (string) ( (integer) subs) != subs) return FALSE;
}
return TRUE;
}
</syntaxhighlight>
</div>

== Float-to-String ==
<div style="padding: 0.5em">
There are several ways to convert a float to a string. The first of which is to typecast it to a string <code>(string)(1.0)</code>. This however has the disadvantage of rounding and being limited to six decimal places. Several functions have been written to provide more options. They fall into two categories, lossless and lossy.

{| class="sortable" {{Prettytable}}
|+ Lossy functions
|- {{Hl2}}
! Name
! title="Infinity / NaN support" {{!}} inf/nan
! Rounding
! Truncation
! Notes
|-
| Typecast
| Yes
| Yes
| No
| <code>(string)float_value</code><br>Mono only gives [https://jira.secondlife.com/browse/SCR-397?focusedCommentId=340847&page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#comment-340847 6 digits of precision].
|-
| [[Format Decimal]]
| No
| Yes
| No
|
|-
| [[Float2String]]
| No
| Yes
| Yes
|
|}
{| class="sortable" {{Prettytable}}
|+ Lossless functions
|- {{Hl2}}
! Name
! Speed
! Reversible
! title="Infinity / NaN support" {{!}} inf/nan support
! [[PI]]
! Notes
|-
| [[Float2Hex]]
| Fast
| <code>(float)</code>
| No
| 0x6487ED5p-25
| Since the output is in the Hexadecimal Scientific Notation, it's not really human readable.
|-
| [[Float2Sci]]
| Slow
| <code>(float)</code>
| No
| 3.1415925
| Useful when you want the result to be lossless but also human readable, comes at the cost of speed.
|-
| [[User:Strife_Onizuka/Float_Functions#Base64-Float|FUIS]]
| Fastest
| [[User:Strife_Onizuka/Float_Functions#Base64-Float|SIUF]]
| No
| "QEkP2g"
| Not at all human readable. Guarantied to always use six characters.
|}
*Infinity is only accessible in Mono.
</div></div>

Template:LSL Constants/Permissions

Maestro Linden — Mon, 02 Feb 2026 23:29:40 GMT

Maestro Linden: add missing (but empty) cell to table

{{{!}} {{Prettytable|style=margin-top:0;}}
{{!}}-{{Hl2}}
! colspan="2" {{!}} Constants
! Action
! Category
! Granter
! title="Automatically granted when requested if one of the specified preconditions are met." {{!}} Automatically granted when…
{{!}}-
{{!}} [[PERMISSION_DEBIT]]
{{!}} {{LSL Hex|0x2|2}}
{{!}} take money from agent's account
{{!}} {{LSLGC|Money}}
{{!}} Owner
{{!}}
{{!}}-
{{!}} [[PERMISSION_TAKE_CONTROLS]]
{{!}} {{LSL Hex|0x4|4}}
{{!}} take agent's [[control|controls]]
{{!}} {{LSLGC|Controls|Control}}
{{!}} Anyone
{{!}} sat on, attached
{{!}}-
{{!}} [[PERMISSION_TRIGGER_ANIMATION]]
{{!}} {{LSL Hex|0x10|16}}
{{!}} start or stop [[llStartAnimation|Animations]] on agent
{{!}} {{LSLGC|Animation}}
{{!}} Anyone
{{!}} sat on, attached
{{!}}-
{{!}} [[PERMISSION_ATTACH]]
{{!}} {{LSL Hex|0x20|32}}
{{!}} [[llAttachToAvatar|attach]]/[[llDetachFromAvatar|detach]] from agent
{{!}} {{LSLGC|Attachment}}
{{!}} [[llAttachToAvatar|Owner]] or [[llAttachToAvatarTemp|Anyone]]
{{!}} attached
{{!}}-
{{!}} [[PERMISSION_CHANGE_LINKS]]
{{!}} {{LSL Hex|0x80|128}}
{{!}} change {{LSLGC|Link|links}}
{{!}} {{LSLGC|Link}}
{{!}} Owner
{{!}}
{{!}}-
{{!}} [[PERMISSION_TRACK_CAMERA]]
{{!}} {{LSL Hex|0x400|1024}}
{{!}} track the agent's {{LSLGC|Camera|camera}} [[Position|position]] and [[rotation]]
{{!}} {{LSLGC|Camera}}
{{!}} Anyone
{{!}} sat on, attached
{{!}}-
{{!}} [[PERMISSION_CONTROL_CAMERA]]
{{!}} {{LSL Hex|0x800|2048}}
{{!}} control the agent's camera <br />([[LlSetCameraParams Test|must be sat on or attached; automatically revoked on stand or detach]])
{{!}} {{LSLGC|Camera}}
{{!}} Anyone
{{!}} sat on, attached
{{!}}-
{{!}} [[PERMISSION_TELEPORT]]
{{!}} {{LSL Hex|0x1000|4096}}
{{!}} [[llTeleportAgent|teleport]] the agent
{{!}} {{LSLGC|Teleport}}
{{!}} Anyone{{Footnote|handle=teleport|[[PERMISSION_TELEPORT]] cannot be held by [[llAttachToAvatarTemp|temporary attachments]].|PERMISSION_TELEPORT cannot be held be attachments.}}
{{!}}
{{!}}-
{{!}} [[PERMISSION_SILENT_ESTATE_MANAGEMENT]]
{{!}} {{LSL Hex|0x4000|16384}}
{{!}} [[llManageEstateAccess|manage estate access]] without notifying the owner of changes
{{!}} {{LSLGC|Estate}}
{{!}} Owner
{{!}}
{{!}}-
{{!}} [[PERMISSION_OVERRIDE_ANIMATIONS]]
{{!}} {{LSL Hex|0x8000|32768}}
{{!}} configure the overriding of default [[llStartAnimation|animations]] on agent
{{!}} {{LSLGC|Animation}}
{{!}} Anyone
{{!}} attached
{{!}}-
{{!}} [[PERMISSION_RETURN_OBJECTS]]
{{!}} {{LSL Hex|0x10000|65536}}
{{!}} Used by [[llReturnObjectsByOwner]] and [[llReturnObjectsByID]] to return objects from parcels
{{!}} {{LSLGC|Cleanup}}
{{!}} Owner, Group Owner
{{!}}
{{!}}-
{{!}} [[PERMISSION_PRIVILEGED_LAND_ACCESS]]
{{!}} {{LSL Hex|0x80000|524288}}
{{!}} Grants the script privileged access to land parcel functions, such as parcel sale. Used by [[llSetParcelForSale]].
{{!}} {{LSLGC|Land}}
{{!}} Owner
{{!}}
{{!}}-
{{#ifeq:{{{flags|}}}|all|
{{!}}-
{{!}} colspan="5" {{!}} '''Permissions without functions:'''<br>These flags lack functions that depend on them.
{{!}}-
{{!}} [[PERMISSION_REMAP_CONTROLS]]
{{!}} {{LSL Hex|0x8|8}}
{{!}} Permission to remap agent's controls.
{{!}} {{LSLGC|Controls|Control}}
{{!}} Anyone
{{!}}
{{!}}-
{{!}} [[PERMISSION_RELEASE_OWNERSHIP]]
{{!}} {{LSL Hex|0x40|64}}
{{!}} Permission to release ownership. <br />the concept of public objects has been removed from SL
{{!}} ???
{{!}} Owner
{{!}}
{{!}}-
{{!}} [[PERMISSION_CHANGE_JOINTS]]
{{!}} {{LSL Hex|0x100|256}}
{{!}} Permission to change joints.
{{!}} ???
{{!}} Owner
{{!}}
{{!}}-
{{!}} [[PERMISSION_CHANGE_PERMISSIONS]]
{{!}} {{LSL Hex|0x200|512}}
{{!}} Permission to change asset permissions.
{{!}} {{LSLGC|Permissions/Asset}}
{{!}} Owner
{{!}}
{{!}}-
{{!}} PERMISSION_EXPERIENCE
{{!}} {{LSL Hex|0x2000|8192}}
{{!}} Permission for object to join experience???
{{!}} {{LSLGC|Permissions/Experience}}
{{!}} Owner
{{!}}
{{!}}-
{{!}} PERMISSION_SIT
{{!}} {{LSL Hex|0x20000|131072}}
{{!}} Permission to sit on a object.<br/>This is used internally for experience permissions.
{{!}} {{LSLGC|Permissions/Experience}}
{{!}} Anyone
{{!}} in experience
{{!}}-
{{!}} PERMISSION_CHANGE_ENVIRONMENT
{{!}} {{LSL Hex|0x40000|262144}}
{{!}} Permission to change environment settings.<br/>This is used internally for experience permissions.
{{!}} {{LSLGC|Permissions/Experience}}
{{!}} Anyone
{{!}} in experience
{{!}}-
{{!}} unknown
{{!}} {{LSL Hex|0x1|1}}
{{!}} unknown
{{!}} ???
{{!}} Anyone
{{!}}
{{!}}-
{{!}} unknown
{{!}} {{LSL Hex|0x10000|65536}} < Value
{{!}} unknown
{{!}} ???
{{!}} Anyone
{{!}}
}}
{{!}}}<noinclude>{{LSL Constants/Permissions|flags=all}}</noinclude>

PERMISSION PRIVILEGED LAND ACCESS

Maestro Linden — Mon, 02 Feb 2026 23:27:04 GMT

Maestro Linden: create page

{{LSL Constant
|name=PERMISSION_PRIVILEGED_LAND_ACCESS
|type=integer
|value=524288
|desc=Required Permission to use the llSetParcelForSale() function.
|examples
|functions=
{{LSL DefineRow||[[llSetParcelForSale]]|}}
|events
|cat1
|cat2
|cat3
|cat4
|self
}}

LlGetInventoryKey

Maestro Linden — Mon, 12 Jan 2026 17:26:04 GMT

Maestro Linden: Fix erroneous mention about errors being shouted on DEBUG channel

{{LSL_Function
|func_id=175|func_sleep=0.0|func_energy=10.0
|func=llGetInventoryKey|return_type=key|p1_type=string|p1_name=name
|func_footnote=If {{LSLP|name}} is not [[llGetInventoryPermMask|copy, mod, trans]] then the return is {{LSL Const|NULL_KEY|key|"00000000-0000-0000-0000-000000000000"|c=Evaluates to false in conditionals just like invalid keys.}}.<br/>Use [[llGetInventoryType]] instead of this function to verify the existence of inventory.
|func_desc
|sort=GetInventoryKey
|return_text=that is the [[UUID]] of the inventory {{LSLP|name}}
|spec
|caveats=*Inventory items are records that usually ''point'' to assets, but they are not the actual assets.
**Multiple inventory items can point to the same asset and return the same key.
**Some newly created inventory entries get default keys until they are edited and saved:
***Newly created notecard entries use [[NULL_KEY]] at present, until they are edited and saved.
***Newly created script entries point to the "[[Hello Avatar]]" script ("d0d40b7c-e32b-3bcb-3346-2be8470093c0" at this writing, not a guaranteed default) until they are edited and saved.
***Most other inventory entries are given unique asset keys at creation time.
**When an asset is "edited" a new asset key is assigned to the edit. The inventory item used to open the asset for editing is updated with the new asset key.
***No other inventory items that share the original asset are updated with the new asset key.
|constants
|examples=
<syntaxhighlight lang="lsl2">
// Put this script in an empty prim, and drag a full-perm texture into the prim's contents to find out its UUID
default
{
changed(integer change)
{
if (change & CHANGED_INVENTORY) // if there has been a change to the prim's contents ...
{
string name = llGetInventoryName(INVENTORY_TEXTURE, 0);
if (name) // if a texture exists ...
{
key uuid = llGetInventoryKey(name);
if (uuid) // if the uuid is valid ...
llOwnerSay( "The UUID of '" + name + "' is " + (string) uuid);
else // texture was not full-perm
llOwnerSay( "The UUID of '" + name + "' could not be determined");
}
}
}
}
</syntaxhighlight>
<syntaxhighlight lang="lsl2">string item = "Default";

default
{
state_entry()
{
llOwnerSay("Touch to get information about \"" + item + "\".");
}

touch_start(integer total_number)
{
integer type = llGetInventoryType(item);
integer index = llListFindList([ INVENTORY_NONE,
INVENTORY_TEXTURE, INVENTORY_SOUND, INVENTORY_LANDMARK, INVENTORY_CLOTHING,
INVENTORY_OBJECT, INVENTORY_NOTECARD, INVENTORY_SCRIPT, INVENTORY_BODYPART,
INVENTORY_ANIMATION, INVENTORY_GESTURE], [type]);
string name = llList2String(["does not exist",
"texture", "sound", "landmark", "clothing",
"object", "notecard", "script", "body part",
"animation", "gesture"], index);

llOwnerSay("Type: " + name);

if(type == INVENTORY_NONE)
return;

integer owner_perms = llGetInventoryPermMask(item, MASK_OWNER);
list perms;
if(owner_perms & PERM_COPY)
perms += "Copy";

if(owner_perms & PERM_MODIFY)
perms += "Modify";

if(owner_perms & PERM_TRANSFER)
perms += "Transfer";

if(owner_perms & PERM_MOVE)
perms += "Move";

llOwnerSay("Perms: " + llList2CSV(perms));

integer temp = PERM_COPY | PERM_MODIFY | PERM_TRANSFER;
if((owner_perms & temp) != temp)
return;

llOwnerSay("Key: " + (string)llGetInventoryKey(item));
}
}
</syntaxhighlight>
|helpers
|also_functions=
{{LSL DefineRow||[[llGetInventoryAcquireTime]]|Returns the time the item was added to the prim's inventory}}
{{LSL DefineRow||[[llGetInventoryName]]|Returns the inventory item's name}}
{{LSL DefineRow||[[llGetInventoryType]]|Tests to see if an inventory item exists and returns its type}}
{{LSL DefineRow||[[llGetInventoryNumber]]|Returns the number of items of a specific type in inventory}}
{{LSL DefineRow||[[llGetInventoryPermMask]]|Returns the inventory item's permissions}}
{{LSL DefineRow||[[llGetInventoryCreator]]|Returns the inventory item's creator}}
|also_events
|also_tests
|also_articles
|notes=*The UUID returned is that of the asset to which the inventory item points, it is not the UUID of the inventory item itself. The assets themselves are immutable (they never change, they are only ever created and deleted); this allows multiple inventory handles to refer to the same asset without having to duplicate the asset. When it appears an asset is being modified, it is saved as a new asset. The consequence of this is that multiple copies of items in inventory all share the same asset UUID.
*It is still possible to inspect the UUID of any animation in inventory by triggering it and using [[llGetAnimationList|llGetAnimationList()]] like so:
<syntaxhighlight lang="lsl2">llStartAnimation("myAnim");
llOwnerSay("myAnim's UUID is " + llList2String(llGetAnimationList(llGetPermissionsKey()), -1));</syntaxhighlight>
|history=
* 0.2 - Introduced during the closed beta period.
* 1.2 - Restricted to full perm inventory items only.
* 1.24 - Objects and scripts no longer return their actual UUID but a hash (i.e. pseudo UUID which is consistent with the object/script) instead. -- {{JIRA|SVC-3670}}
<sup>The preceding version numbers are approximations.</sup>
|cat1=Inventory
|cat2=Key
|cat3
|cat4
}}

LlGetInventoryKey

Maestro Linden — Tue, 04 Nov 2025 19:40:20 GMT

Maestro Linden: Remove dubious reference to 'client cooperation' in caveats list. llGetInventoryKey's output should not depend on which viewer was used to add the queried item to prim inventory.

{{LSL_Function
|inject-2={{Issues/SVC-3670}}{{Issues/SVC-4050}}{{Issues/SVC-6374}}{{LSL_Function/inventory|name|uuid=false}}
|func_id=175|func_sleep=0.0|func_energy=10.0
|func=llGetInventoryKey|return_type=key|p1_type=string|p1_name=name
|func_footnote=If {{LSLP|name}} is not [[llGetInventoryPermMask|copy, mod, trans]] then the return is {{LSL Const|NULL_KEY|key|"00000000-0000-0000-0000-000000000000"|c=Evaluates to false in conditionals just like invalid keys.}}.<br/>Use [[llGetInventoryType]] instead of this function to verify the existence of inventory.
|func_desc
|sort=GetInventoryKey
|return_text=that is the [[UUID]] of the inventory {{LSLP|name}}
|spec
|caveats=*Inventory items are records that usually ''point'' to assets, but they are not the actual assets.
**Multiple inventory items can point to the same asset and return the same key.
**Some newly created inventory entries get default keys until they are edited and saved:
***Newly created notecard entries use [[NULL_KEY]] at present, until they are edited and saved.
***Newly created script entries point to the "[[Hello Avatar]]" script ("d0d40b7c-e32b-3bcb-3346-2be8470093c0" at this writing, not a guaranteed default) until they are edited and saved.
***Most other inventory entries are given unique asset keys at creation time.
**When an asset is "edited" a new asset key is assigned to the edit. The inventory item used to open the asset for editing is updated with the new asset key.
***No other inventory items that share the original asset are updated with the new asset key.
|constants
|examples=
<syntaxhighlight lang="lsl2">
// Put this script in an empty prim, and drag a full-perm texture into the prim's contents to find out its UUID
default
{
changed(integer change)
{
if (change & CHANGED_INVENTORY) // if there has been a change to the prim's contents ...
{
string name = llGetInventoryName(INVENTORY_TEXTURE, 0);
if (name) // if a texture exists ...
{
key uuid = llGetInventoryKey(name);
if (uuid) // if the uuid is valid ...
llOwnerSay( "The UUID of '" + name + "' is " + (string) uuid);
else // texture was not full-perm
llOwnerSay( "The UUID of '" + name + "' could not be determined");
}
}
}
}
</syntaxhighlight>
<syntaxhighlight lang="lsl2">string item = "Default";

default
{
state_entry()
{
llOwnerSay("Touch to get information about \"" + item + "\".");
}

touch_start(integer total_number)
{
integer type = llGetInventoryType(item);
integer index = llListFindList([ INVENTORY_NONE,
INVENTORY_TEXTURE, INVENTORY_SOUND, INVENTORY_LANDMARK, INVENTORY_CLOTHING,
INVENTORY_OBJECT, INVENTORY_NOTECARD, INVENTORY_SCRIPT, INVENTORY_BODYPART,
INVENTORY_ANIMATION, INVENTORY_GESTURE], [type]);
string name = llList2String(["does not exist",
"texture", "sound", "landmark", "clothing",
"object", "notecard", "script", "body part",
"animation", "gesture"], index);

llOwnerSay("Type: " + name);

if(type == INVENTORY_NONE)
return;

integer owner_perms = llGetInventoryPermMask(item, MASK_OWNER);
list perms;
if(owner_perms & PERM_COPY)
perms += "Copy";

if(owner_perms & PERM_MODIFY)
perms += "Modify";

if(owner_perms & PERM_TRANSFER)
perms += "Transfer";

if(owner_perms & PERM_MOVE)
perms += "Move";

llOwnerSay("Perms: " + llList2CSV(perms));

integer temp = PERM_COPY | PERM_MODIFY | PERM_TRANSFER;
if((owner_perms & temp) != temp)
return;

llOwnerSay("Key: " + (string)llGetInventoryKey(item));
}
}
</syntaxhighlight>
|helpers
|also_functions=
{{LSL DefineRow||[[llGetInventoryAcquireTime]]|Returns the time the item was added to the prim's inventory}}
{{LSL DefineRow||[[llGetInventoryName]]|Returns the inventory item's name}}
{{LSL DefineRow||[[llGetInventoryType]]|Tests to see if an inventory item exists and returns its type}}
{{LSL DefineRow||[[llGetInventoryNumber]]|Returns the number of items of a specific type in inventory}}
{{LSL DefineRow||[[llGetInventoryPermMask]]|Returns the inventory item's permissions}}
{{LSL DefineRow||[[llGetInventoryCreator]]|Returns the inventory item's creator}}
|also_events
|also_tests
|also_articles
|notes=*The UUID returned is that of the asset to which the inventory item points, it is not the UUID of the inventory item itself. The assets themselves are immutable (they never change, they are only ever created and deleted); this allows multiple inventory handles to refer to the same asset without having to duplicate the asset. When it appears an asset is being modified, it is saved as a new asset. The consequence of this is that multiple copies of items in inventory all share the same asset UUID.
*It is still possible to inspect the UUID of any animation in inventory by triggering it and using [[llGetAnimationList|llGetAnimationList()]] like so:
<syntaxhighlight lang="lsl2">llStartAnimation("myAnim");
llOwnerSay("myAnim's UUID is " + llList2String(llGetAnimationList(llGetPermissionsKey()), -1));</syntaxhighlight>
|history=
* 0.2 - Introduced during the closed beta period.
* 1.2 - Restricted to full perm inventory items only.
* 1.24 - Objects and scripts no longer return their actual UUID but a hash (i.e. pseudo UUID which is consistent with the object/script) instead. -- {{JIRA|SVC-3670}}
<sup>The preceding version numbers are approximations.</sup>
|cat1=Inventory
|cat2=Key
|cat3
|cat4
}}

Template:LSL Constants/Parcel

Maestro Linden — Tue, 02 Sep 2025 18:26:56 GMT

Maestro Linden: Scrub references to unsupported parcel flags

{{#if:{{{wrap|}}}|{{!}}}}
{{{!}} class="sortable" {{Prettytable|style=margin-top:0;margin-bottom:0;}}
{{!}}-{{Hl2}}
! title="Flag" {{!}} Flag
! title="Value" {{!}} Value
! class="unsortable" {{!}} Description
{{!}}-
{{!}} {{LSL Const|PARCEL_FLAG_ALLOW_FLY|integer|1|hex=0x00000001|c=find if a parcel allows flying}}
{{!}} {{#var:value}}
{{!}} {{#var:comment}}
{{!}}-
{{!}} {{LSL Const|PARCEL_FLAG_ALLOW_SCRIPTS|integer|2|hex=0x00000002|c=find if a parcel allows outside scripts}}
{{!}} {{#var:value}}
{{!}} {{#var:comment}}
{{!}}-
{{!}} {{LSL Const|PARCEL_FLAG_ALLOW_LANDMARK|integer|8|hex=0x00000008|c=find if a parcel allows landmarks to be created}}
{{!}} {{#var:value}}
{{!}} {{#var:comment}}
{{!}}-
{{!}} {{LSL Const|PARCEL_FLAG_ALLOW_TERRAFORM|integer|16|hex=0x00000010|c=find if a parcel allows anyone to terraform the land}}
{{!}} {{#var:value}}
{{!}} {{#var:comment}}
{{!}}-
{{!}} {{LSL Const|PARCEL_FLAG_ALLOW_DAMAGE|integer|32|hex=0x00000020|c=find if a parcel allows damage}}
{{!}} {{#var:value}}
{{!}} {{#var:comment}}
{{!}}-
{{!}} {{LSL Const|PARCEL_FLAG_ALLOW_CREATE_OBJECTS|integer|64|hex=0x00000040|c=find if a parcel allows anyone to create objects}}
{{!}} {{#var:value}}
{{!}} {{#var:comment}}
{{!}}-
{{!}} {{LSL Const|PARCEL_FLAG_USE_ACCESS_GROUP|integer|256|hex=0x00000100|c=find if a parcel limits access to a group}}
{{!}} {{#var:value}}
{{!}} {{#var:comment}}
{{!}}-
{{!}} {{LSL Const|PARCEL_FLAG_USE_ACCESS_LIST|integer|512|hex=0x00000200|c=find if a parcel limits access to a list of residents}}
{{!}} {{#var:value}}
{{!}} {{#var:comment}}
{{!}}-
{{!}} {{LSL Const|PARCEL_FLAG_USE_BAN_LIST|integer|1024|hex=0x00000400|c=find if a parcel uses a ban list, including restricting access based on payment info}}
{{!}} {{#var:value}}
{{!}} {{#var:comment}}
{{!}}-
{{!}} {{LSL Const|PARCEL_FLAG_USE_LAND_PASS_LIST|integer|2048|hex=0x00000800|c=find if a parcel allows passes to be purchased}}
{{!}} {{#var:value}}
{{!}} {{#var:comment}}
{{!}}-
{{!}} {{LSL Const|PARCEL_FLAG_LOCAL_SOUND_ONLY|integer|32768|hex=0x00008000|c=find if a parcel restricts spatialized sound to the parcel}}
{{!}} {{#var:value}}
{{!}} {{#var:comment}}
{{!}}-
{{!}} {{LSL Const|PARCEL_FLAG_RESTRICT_PUSHOBJECT|integer|2097152|hex=0x00200000|c=find if a parcel restricts llPushObject}}
{{!}} {{#var:value}}
{{!}} find if a parcel restricts [[llPushObject]]
{{!}}-
{{!}} {{LSL Const|PARCEL_FLAG_ALLOW_GROUP_SCRIPTS|integer|hex=0x02000000|c=find if a parcel allows scripts owned by group}}
{{!}} {{#var:value}}
{{!}} {{#var:comment}}
{{!}}-
{{!}} {{LSL Const|PARCEL_FLAG_ALLOW_CREATE_GROUP_OBJECTS|integer|hex=0x04000000|c=find if a parcel allows object creation by group members or objects}}
{{!}} {{#var:value}}
{{!}} {{#var:comment}}
{{!}}-
{{!}} {{LSL Const|PARCEL_FLAG_ALLOW_ALL_OBJECT_ENTRY|integer|hex=0x08000000|c=find if a parcel allows all objects to enter a parcel}}
{{!}} {{#var:value}}
{{!}} {{#var:comment}}
{{!}}-
{{!}} {{LSL Const|PARCEL_FLAG_ALLOW_GROUP_OBJECT_ENTRY|integer|hex=0x10000000|c=find if a parcel only allows group (and owner) objects to enter the parcel}}
{{!}} {{#var:value}}
{{!}} {{#var:comment}}
{{!}}}
<noinclude>{{{{FULLPAGENAME}}|valid=*}}</noinclude>

Template:LSL Constants/Experience Tools Errors

Maestro Linden — Wed, 13 Aug 2025 19:18:19 GMT

Maestro Linden: Clarify that XP_ERROR_STORAGE_EXCEPTION can be triggered when calling llCreateKeyValue on a key that already exists (which is probably the cause of most cases of this error)

{{{!}} class="sortable" {{prettytable}}
{{!}}- {{hl2}}
! {{!}} LSL Constant
! title="Value" {{!}}
! {{!}} Message returned via [[llGetExperienceErrorMessage]]
! {{!}} Description
{{!}}-
{{!}} [[XP_ERROR_NONE]]
{{!}} 0
{{!}} no error
{{!}} No error was detected.
{{!}}-
{{!}} [[XP_ERROR_THROTTLED]]
{{!}} 1
{{!}} exceeded throttle
{{!}} The call failed due to too many recent calls.
{{!}}-
{{!}} [[XP_ERROR_EXPERIENCES_DISABLED]]
{{!}} 2
{{!}} experiences are disabled
{{!}} The region currently has experiences disabled.
{{!}}-
{{!}} [[XP_ERROR_INVALID_PARAMETERS]]
{{!}} 3
{{!}} invalid parameters
{{!}} One of the string arguments was too big to fit in the key-value store.
{{!}}-
{{!}} [[XP_ERROR_NOT_PERMITTED]]
{{!}} 4
{{!}} operation not permitted
{{!}} Experience permissions were denied by the user.
{{!}}-
{{!}} [[XP_ERROR_NO_EXPERIENCE]]
{{!}} 5
{{!}} script not associated with an experience
{{!}} This script is not associated with an experience.
{{!}}-
{{!}} [[XP_ERROR_NOT_FOUND]]
{{!}} 6
{{!}} not found
{{!}} The sim was unable to verify the validity of the experience. Retrying after a short wait is advised.
{{!}}-
{{!}} [[XP_ERROR_INVALID_EXPERIENCE]]
{{!}} 7
{{!}} invalid experience
{{!}} The script is associated with an experience that no longer exists.
{{!}}-
{{!}} [[XP_ERROR_EXPERIENCE_DISABLED]]
{{!}} 8
{{!}} experience is disabled
{{!}} The experience owner has temporarily disabled the experience.
{{!}}-
{{!}} [[XP_ERROR_EXPERIENCE_SUSPENDED]]
{{!}} 9
{{!}} experience is suspended
{{!}} The experience has been suspended by Linden Lab customer support.
{{!}}-
{{!}} [[XP_ERROR_UNKNOWN_ERROR]]
{{!}} 10
{{!}} unknown error
{{!}} An unknown error not covered by any of the other predetermined error states.
{{!}}-
{{!}} [[XP_ERROR_QUOTA_EXCEEDED]]
{{!}} 11
{{!}} experience data quota exceeded
{{!}} An attempt to write data to the key-value store failed due to the data quota being met.
{{!}}-
{{!}} [[XP_ERROR_STORE_DISABLED]]
{{!}} 12
{{!}} key-value store is disabled
{{!}} They key-value store is currently disabled on this region.
{{!}}-
{{!}} [[XP_ERROR_STORAGE_EXCEPTION]]
{{!}} 13
{{!}} key-value store communication failed
{{!}} Unable to communicate with the key-value store, or attempted to create key that already exists
{{!}}-
{{!}} [[XP_ERROR_KEY_NOT_FOUND]]
{{!}} 14
{{!}} key doesn't exist
{{!}} They requested key does not exist.
{{!}}-
{{!}} [[XP_ERROR_RETRY_UPDATE]]
{{!}} 15
{{!}} retry update
{{!}} A checked update failed due to an out of date request.
{{!}}-
{{!}} [[XP_ERROR_MATURITY_EXCEEDED]]
{{!}} 16
{{!}} experience content rating too high
{{!}} The content rating of the experience exceeds that of the region.
{{!}}-
{{!}} [[XP_ERROR_NOT_PERMITTED_LAND]]
{{!}} 17
{{!}} not allowed to run on this land
{{!}} The experience is blocked or not enabled for this land.
{{!}}-
{{!}} [[XP_ERROR_REQUEST_PERM_TIMEOUT]]
{{!}} 18
{{!}} experience permissions request timed out
{{!}} The request for experience permissions was ignored.
{{!}}-
{{!}}}

LlSetLinkGLTFOverrides

Maestro Linden — Mon, 21 Apr 2025 19:49:56 GMT

Maestro Linden: add note about base color and alpha overrides being coupled.

{{LSL_Function
|inject-2={{LSL Function/color|color}}{{LSL_Function/link-face|link|face}}
|func=llSetLinkGLTFOverrides
|func_desc=Sets or removes individual overrides applied to a PBR texture on a face
|p1_type= integer|p1_name= link|p1_desc=
|p2_type= integer|p2_name= face|p2_desc=
|p3_type= list|p3_name= params|p3_desc= List of overrides and override values.
|constants=
{{LSL Constants/GLTF Overrides}}
|caveats=
* {{LSLP|OVERRIDE_GLTF_BASE_COLOR_FACTOR}} and {{LSLP|OVERRIDE_GLTF_BASE_ALPHA}} parameters are coupled. If an override is set for one parameter, then the other is automatically given an override. The default {{LSLP|OVERRIDE_GLTF_BASE_COLOR_FACTOR}} is <1,1,1>, and the default {{LSLP|OVERRIDE_GLTF_BASE_ALPHA}} is 1.0.
|examples
|helpers
|also_functions=
{{LSL DefineRow||[[LlSetPrimitiveParams]]|Sets the parameters for a prim}}
{{LSL DefineRow||[[LlGetPrimitiveParams]]|Gets the parameters set on a prim}}
|notes
|cat1=Experience
|cat2=Permissions/Experience
}}

PRIM GLTF BASE COLOR

Maestro Linden — Mon, 21 Apr 2025 19:45:04 GMT

Maestro Linden: add caveat about tint_color and alpha overrides being coupled

[[Category:glTF]]

<onlyinclude>{{#if:

{{#vardefine:normal_return|an empty list.}}

{{#vardefine:normal_const|{{LSL Const|PRIM_GLTF_BASE_COLOR|integer|48|c=Used to {{GetSet|{{{1|}}}|get|set|/}} the [[GLTF Overrides|GLTF]] base color override of an object's face}}}}

{{LSL_Function/angle|rotation_in_radians}}

{{#vardefine:p_repeats_desc|x and y range from -10000.0 to 10000.0. Negative values flip the texture (z is ignored)}}
{{#vardefine:p_offsets_desc|x and y range from -1.0 to 1.0. (z is ignored)}}
{{#vardefine:p_tint_color_desc|tint color in linear RGB}}
{{#vardefine:p_alpha_desc|opacity in the range 0.0 to 1.0}}
{{#vardefine:p_alpha_mode_desc|alpha mode: [[PRIM_GLTF_ALPHA_MODE_OPAQUE]], [[PRIM_GLTF_ALPHA_MODE_BLEND]] or [[PRIM_GLTF_ALPHA_MODE_MASK]]}}
{{#vardefine:p_alpha_mask_cutoff_desc|cutoff value for alpha masking mode in the range 0.0 to 1.0}}
{{#vardefine:p_double_sided_desc|render material as double sided}}

{{LSL_Function/inventory|texture|uuid=true|type=texture|no_caveat={{#ifeq:{{{1|}}}|get|true|<noinclude>*</noinclude>}}|full={{{remote|}}}|remote={{#ifeq:{{{1|set}}}|get|*}}|target=PRIM_GLTF_BASE_COLOR#Target}}

{{#ifeq:{{{1|}}}|none||

{{#vardefine:facetable|{{#var:facetable}}
{{!}}-
{{!}} [ {{#var:normal_const}} ]
{{!}} {{#var:normal_return}} }}

{{#vardefine:caveats_get|
* {{LSLP|repeats}} is not only used to get the number of repeats but the sign of the individual components indicate if "Flip" is set.
}}

{{#vardefine:caveats_set|
* {{LSLP|repeats}} is not only used to set the number of repeats but the sign of the individual components is also used to set the "Flip" attribute.
* To clear any override parameters, supply an empty string ("") in the parameter slot.
* {{LSLP|tint_color}} is in linear RGB color space, unlike legacy tint that uses sRGB. Use [[llsRGB2Linear]] and [[llLinear2sRGB]] to perform conversions.
}}
* {{LSLP|tint_color}} and {{LSLP|alpha}} parameters are coupled. If an override is set for one parameter, then the other is automatically given an override. The default {{LSLP|tint_color}} is <1,1,1>, and the default {{LSLP|alpha}} is 1.0.

{{#ifeq:{{{1|}}}|get|

{{#vardefine:caveats|{{#var:caveats}}
{{#var:caveats_get}}
}}

|

{{#vardefine:caveats|{{#var:caveats}}
{{#var:caveats_set}}
}}

}}

<noinclude>
{{:PRIM TEXGEN|{{{1|}}}}}
</noinclude>

}}

{{#vardefine:shared_caveat|* In the [[PRIM_TEXGEN_DEFAULT|default]] [[PRIM_TEXGEN|texture mapping]] {{LSLP|tg_type|mode}} the [[PRIM_GLTF_BASE_COLOR|texture]] {{LSLP|repeats}} units are in texture repeats per face. In the [[PRIM_TEXGEN_PLANAR|planar]] texture mapping mode the texture {{LSLP|repeats}} units are in texture repeats per half meter. This is in contrast to the in-world editing tool, in which the planar texture scaling units are repeats per meter.}}

{{#vardefine:caveats|{{#var:caveats}}
{{#var:shared_caveat}}}}

}}</onlyinclude>{{#if:

{{#vardefine:caveats_set|{{#var:caveats}}{{#vardefine:caveats|}}}}
{{#vardefine:issues_set|{{#var:issues}}{{#vardefine:issues|}}}}

{{LSL_Function/face|face|{{#var:normal_const}}|!footer=*|return={{#var:normal_return}}}}

{{#vardefine:caveats_get|{{#var:caveats}}{{#vardefine:caveats|}}
{{#var:caveats_get}}
{{#var:shared_caveat}}}}
{{#vardefine:issues_get|{{#var:issues}}{{#vardefine:issues|}}}}

}}{{LSL Constant
|inject-2={{LSL PrimitiveParam Categorize|Face}}
|name=PRIM_GLTF_BASE_COLOR
|type=integer
|value=48
|desc=Used to get or set the [[GLTF Overrides|GLTF]] base color override of an object's {{LSLP|face}}.
|examples=
|pa={{LSL Constant/List|i_front=[ {{#var:normal_const}}, |i_end= ]|
|inject-1={{#vardefine:p_texture_desc|}}
{{#vardefine:p_texture_hover|}}
{{#vardefine:direction|_set}}
{{LSL_Function/inventory|texture|uuid=true|type=texture}}
|text=Used with [[llSetPrimitiveParams]] & [[llSetLinkPrimitiveParams]].

{{LSL Generic/Caveats|issues={{#var:issues_set}}|title=*|h=4}}

|toc=llSetPrimitiveParams
|i1_type=integer|i1_name=face
|i2_type=string|i2_name=texture
|i3_type=vector|i3_name=repeats
|i4_type=vector|i4_name=offsets
|i5_type=float|i5_name=rotation_in_radians|i5_disp=rot
|i6_type=vector|i6_name=tint_color
|i7_type=float|i7_name=alpha
|i8_type=integer|i8_name=alpha_mode
|i9_type=float|i9_name=alpha_mask_cutoff
|i10_type=integer|i10_name=double_sided
}}
|pb={{LSL Constant/List|i_front=[[llGetPrimitiveParams]]([ {{#var:normal_const}}, |i_end= ]);|
|inject-1={{#vardefine:p_texture_desc|}}
{{#vardefine:p_texture_hover|}}
{{#vardefine:direction|_get}}
{{LSL_Function/inventory|texture|uuid=true|type=texture|no_caveat=true|full={{{remote|}}}|remote=*|target=#Target}}
{{LSL Function/link|link|nogroup=*|nocaveats=*}}
|r_front=Returns the list [ |r_end= ]
|text=
{{LSL Generic/Caveats|caveats={{#var:caveats_get}}{{#vardefine:caveats_get}}|issues={{#var:issues_get}}|title=*|h=4}}
====Target====
In the case of llGetPrimitiveParams is either the prim the script resides in, or the prim specified by the immediately prior [[PRIM_LINK_TARGET]] call. However in the case of llGetLinkPrimitiveParams, it is either the value of the {{LSLP|link}} parameter, or the prim specified by the immediately prior [[PRIM_LINK_TARGET]] call.
|toc=llGetPrimitiveParams
|i1_type=integer|i1_name=face
|r1_type=string|r1_name=texture
|r2_type=vector|r2_name=repeats
|r3_type=vector|r3_name=offsets
|r4_type=float|r4_name=rotation_in_radians|r4_disp=rot
|r5_type=vector|r5_name=tint_color
|r6_type=float|r6_name=alpha
|r7_type=integer|r7_name=alpha_mode
|r8_type=float|r8_name=alpha_mask_cutoff
|r9_type=integer|r9_name=double_sided
}}
|functions=
{{LSL DefineRow||[[llSetPrimitiveParams]]|}}
{{LSL DefineRow||[[llSetLinkPrimitiveParams]]|}}
{{LSL DefineRow||[[llGetPrimitiveParams]]|}}
|events
|location
|notes
|cat1=Texture
|cat2=
|cat3
|cat4
}}

LlIsLinkGLTFMaterial

Maestro Linden — Wed, 09 Apr 2025 00:04:25 GMT

Maestro Linden: Clarify link number behavior

{{LSL_Function
|func_id=|func_sleep=0.0|func_energy=10.0
|func=llIsLinkGLTFMaterial
|return_type=integer
|p1_type=integer|p1_name=link|p1_desc=Link to inspect for PBR, may be [[LINK_THIS]] or [[LINK_ROOT]]
|p2_type=integer|p2_name=face|p2_desc='''Face''' to examine for PBR, or [[ALL_SIDES]]
|return_text=that is [[TRUE]] if the material is PBR and [[FALSE]] if it is [[PBR_Materials#Nomenclature_changes|Blinn-Phong]] diffuse texture on '''face'''
|func_footnote
|spec
|caveats=
* Returns [[FALSE]] if link does not exist or refers to a multi-link target (such as [[LINK_SET]]).
* Returns [[FALSE]] if face does not exist.
|constants
|examples=<source lang="lsl2">
//Tells (on chat) if the materials are PBR
default
{
state_entry()
{
integer i = 0;
integer max = llGetNumberOfSides();
while(i < max)
{
string message = "Side " + (string)i + " material is ";
if (llIsLinkGLTFMaterial(LINK_THIS, i))
message += "GLTF/PBR";
else
message += "Blinn-Phong";
llSay(0, message);
++i;
}

if (llIsLinkGLTFMaterial(LINK_THIS, ALL_SIDES))
llSay(0, "All sides are PBR");
else
llSay(0, "Some sides are not PBR");
}
}
</source>
|helpers
|also_functions=
{{LSL DefineRow||[[llGetNumberOfSides]]|Gets the number of faces on the prim}}
|also_events
|also_tests
|also_articles
|notes
|history
|cat1
|cat2
|cat3
|cat4
}}

Template:LSL Constants/GroundTexture

Maestro Linden — Thu, 03 Apr 2025 22:57:40 GMT

Maestro Linden: Clarify that TERRAIN_PBR_ROTATION_ uses radians as a unit

<div style="padding: 0.5em;">
{{{!}} class="sortable" {{Prettytable}}
{{!}}- {{Hl2}}
! {{!}} Constant
! title="Value" {{!}}
! class="unsortable" {{!}} Format
! class="unsortable" {{!}} Description
{{!}}-
{{!}}{{LSL Const|TERRAIN_DETAIL_1|integer|0|c=Changes texture used to draw terrain level 1.}}
{{!}}{{#var:value}}
{{!}} rowspan="4" {{!}} [ TERRAIN_DETAIL_#, texture_id ]
{{!}} rowspan="4" {{!}}
Sets the texture to use for the current terrain detail layer. texture_id must be the UUID of a texture or material, or the name of a texture or material in the object's inventory.

Passing NULL_KEY or an empty string will set the terrain texture to the default.
{{!}}-
{{!}}{{LSL Const|TERRAIN_DETAIL_2|integer|1|c=Changes texture used to draw terrain level 2.}}
{{!}}{{#var:value}}
{{!}}-
{{!}}{{LSL Const|TERRAIN_DETAIL_3|integer|2|c=Changes texture used to draw terrain level 3.}}
{{!}}{{#var:value}}
{{!}}-
{{!}}{{LSL Const|TERRAIN_DETAIL_4|integer|3|c=Changes texture used to draw terrain level 4.}}
{{!}}{{#var:value}}
{{!}}-
{{!}}{{LSL Const|TERRAIN_HEIGHT_RANGE_SW|integer|4|c=Changes the south west blend range.}}
{{!}}{{#var:value}}
{{!}} rowspan="4" {{!}} [ TERRAIN_HEIGHT_RANGE_XX, float low, float high ]
{{!}} rowspan="4" {{!}}
Sets the height range for terrain for texture blending in the region. low is the maximum height for texture 1 and high is the minimum height for texture 4, textures 2 and 3 will mix in between these values.
{{!}}-
{{!}}{{LSL Const|TERRAIN_HEIGHT_RANGE_SE|integer|5|c=Changes the south east blend range.}}
{{!}}{{#var:value}}
{{!}}-
{{!}}{{LSL Const|TERRAIN_HEIGHT_RANGE_NW|integer|6|c=Changes the north west blend range.}}
{{!}}{{#var:value}}
{{!}}-
{{!}}{{LSL Const|TERRAIN_HEIGHT_RANGE_NE|integer|7|c=Changes the north east blend range.}}
{{!}}{{#var:value}}
{{!}}-
{{!}}{{LSL Const|TERRAIN_PBR_SCALE_1|integer|8|c=Scales terrain texture 1.}}
{{!}}{{#var:value}}
{{!}} rowspan="4" {{!}} [ TERRAIN_PBR_SCALE_#, vector uv_scale ]
{{!}} rowspan="4" {{!}}
Sets the UV scale used for each layer's terrain texture in repeats per meter.

* The Z value of the vector is ignored.
* Only works for PBR textures.
{{!}}-
{{!}}{{LSL Const|TERRAIN_PBR_SCALE_2|integer|9|c=Scales terrain texture 2.}}
{{!}}{{#var:value}}
{{!}}-
{{!}}{{LSL Const|TERRAIN_PBR_SCALE_3|integer|10|c=Scales terrain texture 3.}}
{{!}}{{#var:value}}
{{!}}-
{{!}}{{LSL Const|TERRAIN_PBR_SCALE_4|integer|11|c=Scales terrain texture 4.}}
{{!}}{{#var:value}}
{{!}}-
{{!}}{{LSL Const|TERRAIN_PBR_ROTATION_1|integer|12|c=Rotates terrain texture 1.}}
{{!}}{{#var:value}}
{{!}} rowspan="4" {{!}} [ TERRAIN_PBR_ROTATION_#, float rotation ]
{{!}} rowspan="4" {{!}}
Sets the rotation of the PBR texture for each layer, in radians.

* Only works for PBR textures.
{{!}}-
{{!}}{{LSL Const|TERRAIN_PBR_ROTATION_2|integer|13|c=Rotates terrain texture 2.}}
{{!}}{{#var:value}}
{{!}}-
{{!}}{{LSL Const|TERRAIN_PBR_ROTATION_3|integer|14|c=Rotates terrain texture 3.}}
{{!}}{{#var:value}}
{{!}}-
{{!}}{{LSL Const|TERRAIN_PBR_ROTATION_4|integer|15|c=Rotates terrain texture 4.}}
{{!}}{{#var:value}}
{{!}}-
{{!}}{{LSL Const|TERRAIN_PBR_OFFSET_1|integer|16|c=Offsets terrain texture 1.}}
{{!}}{{#var:value}}
{{!}} rowspan="4" {{!}} [ TERRAIN_PBR_OFFSET_#, vector uv_offset ]
{{!}} rowspan="4" {{!}}
Sets the UV offset for drawing each terrain layer.

* The Z value of the vector is ignored.
* Only works for PBR textures.
{{!}}-
{{!}}{{LSL Const|TERRAIN_PBR_OFFSET_2|integer|17|c=Offsets terrain texture 2.}}
{{!}}{{#var:value}}
{{!}}-
{{!}}{{LSL Const|TERRAIN_PBR_OFFSET_3|integer|18|c=Offsets terrain texture 3.}}
{{!}}{{#var:value}}
{{!}}-
{{!}}{{LSL Const|TERRAIN_PBR_OFFSET_4|integer|19|c=Offsets terrain texture 4.}}
{{!}}{{#var:value}}
{{!}}-

{{!}}}
</div></div>

Template:LSL Constants/Transfer Inventory

Maestro Linden — Fri, 28 Feb 2025 19:20:09 GMT

Maestro Linden: add newline

===Transfer Options===

{{{!}} class="sortable" {{Prettytable|style=margin-top:0;}}
{{!}}-{{Hl2}}
! {{!}} Flags
! title="Value" {{!}}
{{!}} Parameters
! class="unsortable"{{!}} Description
{{!}}-
{{!}}{{LSL Const|TRANSFER_DEST|integer|0|c=Destination root path in inventory.}}
{{!}}{{#var:value}}
{{!}} [ TRANSFER_DEST, string ]
{{!}}Sets a root path that will be used as the parent for folder. If the root path does not exist it will be created.
If it already exists in the target inventory it will be reused. Path folders are separated by a "|" character. The path
may have have up to 4 folders in it.

Note that transfers to certain system folders (such as 'Trash') are disallowed.

Examples:<br>
"Objects|Vehicles|My Motorcycle Company"<br>
"Clothing|Shoes|Breedables"<br>
"My Store|Home & Garden|"
{{!}}-
{{!}}{{LSL Const|TRANSFER_FLAGS|integer|1|c=Flags for inventory transfer}}
{{!}}{{#var:value}}
{{!}} [ TRANSFER_FLAGS, integer ]
{{!}} There are no flags defined at this time.
{{!}}}

Template:LSL Constants/Transfer Inventory

Maestro Linden — Fri, 28 Feb 2025 19:19:34 GMT

Maestro Linden: Added note that some system folders can't be transferred to

===Transfer Options===

{{{!}} class="sortable" {{Prettytable|style=margin-top:0;}}
{{!}}-{{Hl2}}
! {{!}} Flags
! title="Value" {{!}}
{{!}} Parameters
! class="unsortable"{{!}} Description
{{!}}-
{{!}}{{LSL Const|TRANSFER_DEST|integer|0|c=Destination root path in inventory.}}
{{!}}{{#var:value}}
{{!}} [ TRANSFER_DEST, string ]
{{!}}Sets a root path that will be used as the parent for folder. If the root path does not exist it will be created.
If it already exists in the target inventory it will be reused. Path folders are separated by a "|" character. The path
may have have up to 4 folders in it. Note that transfers to certain system folders (such as 'Trash') are disallowed.

Examples:<br>
"Objects|Vehicles|My Motorcycle Company"<br>
"Clothing|Shoes|Breedables"<br>
"My Store|Home & Garden|"
{{!}}-
{{!}}{{LSL Const|TRANSFER_FLAGS|integer|1|c=Flags for inventory transfer}}
{{!}}{{#var:value}}
{{!}} [ TRANSFER_FLAGS, integer ]
{{!}} There are no flags defined at this time.
{{!}}}

LlGiveAgentInventory

Maestro Linden — Fri, 28 Feb 2025 19:16:45 GMT

Maestro Linden: Remove reference to Template:LSL_Function/give , which introduces a bunch of misleading caveats for the function, and added applicable caveats

{{LSL_Function
|func_id=|func_sleep=3.0|func_energy=10.0|return_type=integer
|func=llGiveAgentInventory
|p1_type=key|p1_name=agent|p1_desc=agent to receive inventory offer.
|p2_type=string|p2_name=folder|p2_desc=destination folder name to use.
|p3_type=list|p3_name=inventory|p3_desc=list of inventory items to give to the agent
|p4_type=list|p4_name=options|p4_desc=list of options for inventory transfer.
|func_footnote
|return_text
|func_desc=Gives '''inventory''' items to '''agent''', creating a new '''folder''' to put them in.
|spec=
* The target must be an avatar in the same region as the sending object, or must have recently been in the region.
* Places the inventory items in a newly created folder in the avatar's inventory (even if there is a folder by the same name, a new one is created).
* If a path of root folders has been specified, the function will ensure that those folders exist but will not recreate them if they already exist.
|constants={{LSL Constants/Transfer Inventory}}

{{LSL Constants/Transfer Errors}}

|caveats=* Any no-copy items in '''inventory''' will be excluded from transfer.
* Any no-transfer items in '''inventory''' will be excluded from transfer if '''agent''' is not the script owner.
|examples=
In this example, the object inventory needs to contain two objects named ''Item 1'' and ''Item 2''. The destination folder will be named ''Destination Folder'' and will be created under the main folder ''Objects'', in the sub-folder ''Subfolder''. If ''Subfolder'' does not exist, it will be created.

If the object gets touched for a second time, the sub-folder ''Subfolder'' will '''not''' be duplicated, however the destination folder ''Destination Folder'' '''will''' be duplicated.

If ''Item 1'' and/or ''Item 2'' do not exist, the transfer will silently fail partially or completely.
<syntaxhighlight lang="lsl2">default
{
touch_start(integer total_number)
{
llGiveAgentInventory(llDetectedKey(0), "Destination Folder", ["Item 1","Item 2"], [0, "Objects|Subfolder"] );
}
}</syntaxhighlight>
|helpers
|also_functions={{LSL DefineRow||[[llGiveInventory]]}}
{{LSL DefineRow||[[llGiveInventoryList]]}}
|also_events={{LSL DefineRow||[[changed]]}}
|also_tests
|also_articles
|notes|cat1=Inventory
|cat2
|cat3
|cat4
}}

LlSetClickAction

Maestro Linden — Tue, 28 Jan 2025 18:56:46 GMT

Maestro Linden: Fixed a caveat point that mentioned CLICK_ACTION_NONE but should have said CLICK_ACTION_DISABLED instead.

Template:LSL Constants/Object Details

Maestro Linden — Thu, 23 Jan 2025 23:38:08 GMT

Maestro Linden: remove trailing comma from OBJECT_PERMS results list

{{{!}} class="sortable" {{Prettytable|style=margin-top:0;}}
{{!}}-{{Hl2}}
! {{!}} Flags
! title="Value" {{!}}
! class="unsortable"{{!}} Description
! class="unsortable"{{!}} Length when [[typecast]] to a [[string]]
! Return
! class="unsortable"{{!}} Alternatives
! Local
{{!}}-
{{!}}{{LSL Const|OBJECT_NAME|integer|1|c=Gets the prim's name.}}
{{!}}{{#var:value}}
{{!}}{{#var:comment}}<br/>If '''id''' is an avatar, the {{LSLGC|Legacy Name}} is returned.
{{!}}max. 63 characters
{{!}}[[string]] {{LSL PL|type=string|name}}
{{!}}
*[[llKey2Name]]
*[[llDetectedName]]
{{!}} [[llGetObjectName]]
{{!}}-
{{!}}{{LSL Const|OBJECT_DESC|integer|2|c=Gets the prim's description.}}
{{!}}{{#var:value}}
{{!}}{{#var:comment}}<br/>If '''id''' is an avatar, an empty string is returned.
{{!}}max. 127 characters
{{!}}[[string]] {{LSL PL|type=string|desc}}
{{!}}
{{!}} [[llGetObjectDesc]]
{{!}}-
{{!}}{{LSL Const|OBJECT_POS|integer|3|c=Gets the prim's position in region coordinates.}}
{{!}}{{#var:value}}
{{!}}Gets the prim's position in [[Viewer_coordinate_frames#Region|region coordinates]].<br/>If '''id''' is an avatar outside the region (see above), this position is relative to the region the script is [[llGetRegionName|running in]].
{{!}}max. 37 characters
{{!}}[[vector]] {{LSL PL|type=vector|pos}}
{{!}}
*[[llDetectedPos]]
{{!}} [[llGetPos]]
{{!}}-
{{!}}{{LSL Const|OBJECT_ROT|integer|4|c=Gets the prim's rotation.}}
{{!}}{{#var:value}}
{{!}}{{#var:comment}}
{{!}}max. 48 characters
{{!}}[[rotation]] {{LSL PL|type=rotation|rot}}
{{!}}
*[[llDetectedRot]]
{{!}} [[llGetRot]]
{{!}}-
{{!}}{{LSL Const|OBJECT_VELOCITY|integer|5|c=Gets the object's velocity.}}
{{!}}{{#var:value}}
{{!}}{{#var:comment}}
{{!}}36 characters
{{!}}[[vector]] {{LSL PL|type=vector|vel}}
{{!}}
*[[llDetectedVel]]
{{!}} [[llGetVel]]
{{!}}-
{{!}}{{LSL Const|OBJECT_OWNER|integer|6|c=Gets the object's owner key.}}
{{!}}{{#var:value}}
{{!}}Gets an object's {{LSLGC|Owner|owner}} key.<br/>If '''id''' is an avatar, that avatar's key is returned (which is the same as '''id''').<br/>If '''id''' is group-owned, a {{LSL Constant/NULL_KEY}} is returned.
{{!}}36 characters
{{!}}[[key]] {{LSL PL|type=key|subtype=owner}}
{{!}}
*[[llDetectedOwner]]
*[[llGetOwnerKey]]
{{!}} [[llGetOwner]]
{{!}}-
{{!}}{{LSL Const|OBJECT_GROUP|integer|7|c=Gets the prim's group key.}}
{{!}}{{#var:value}}
{{!}}Gets the prim's {{LSLGC|Group|group}} key.<br/>If '''id''' is an avatar, a {{LSL Constant/NULL_KEY}} is returned.{{Footnote|There are at least 3 JIRA's about OBJECT_GROUP and avatars, LL has refused all of them. Most recently on December 5th 2013 in {{JIRA|BUG-4654}}.|There are at least 3 JIRA's about OBJECT_GROUP and avatars, LL has refused all of them. Most recently on December 5th 2013 in BUG-4654.}}
{{!}}36 characters
{{!}}[[key]] {{LSL PL|type=key|group}}
{{!}}{{LSLGC|Group}}
{{!}}
{{!}}-
{{!}}{{LSL Const|OBJECT_CREATOR|integer|8|c=Gets the prim's creator key.}}
{{!}}{{#var:value}}
{{!}}Gets the prim's {{LSLGC|Creator|creator}} key.<br/>If '''id''' is an avatar, a {{LSL Constant/NULL_KEY}} is returned.
{{!}}36 characters
{{!}}[[key]] {{LSL PL|creator}}
{{!}}{{LSLGC|Creator}}
{{!}} [[llGetCreator]]
{{!}}-
{{!}}{{LSL Const|OBJECT_RUNNING_SCRIPT_COUNT|integer|9|c=Gets the number of running scripts attached to the object or agent.}}
{{!}}{{#var:value}}
{{!}}Gets the number of [[llGetScriptState|running]] scripts attached to the object or agent.
{{!}}max. 11 characters
{{!}}[[integer]] {{LSL PL|script_count|disp=count}}
{{!}}
{{!}}[[llGetScriptState]]
{{!}}-
{{!}}{{LSL Const|OBJECT_TOTAL_SCRIPT_COUNT|integer|10|c=Gets the number of scripts, both running and stopped, attached to the object or agent.}}
{{!}}{{#var:value}}
{{!}}Gets the number of scripts, both running and stopped, attached to the object or agent.
{{!}}max. 11 characters
{{!}}[[integer]] {{LSL PL|script_count|disp=count}}
{{!}}
{{!}}[[llGetInventoryNumber]]
{{!}}-
{{!}}{{LSL Const|OBJECT_SCRIPT_MEMORY|integer|11|c=Gets the total amount of script memory allocated to the object or agent, in bytes.}}
{{!}}{{#var:value}}
{{!}}Gets the total amount of [[LSL Script Memory|script memory]] allocated to the object or agent, in bytes. [[OBJECT_SCRIPT_MEMORY|See page for more info.]]
{{!}}max. 11 characters
{{!}}[[integer]] {{LSL PL|bytes}}
{{!}}
{{!}}
{{!}}-
{{!}}{{LSL Const|OBJECT_SCRIPT_TIME|integer|12|c=Gets the total amount of average script CPU time used by the object or agent, in seconds.}}
{{!}}{{#var:value}}
{{!}}Gets the total amount of average script CPU time used by the object or agent, in seconds. [[OBJECT_SCRIPT_TIME|See page for more info.]]
{{!}}max. 15 characters
{{!}}[[float]] {{LSL PL|seconds}}
{{!}}[[Viewerhelp:Top_Colliders_and_Top_Scripts|Top Scripts]]
{{!}}
{{!}}-
{{!}}{{LSL Const|OBJECT_PRIM_EQUIVALENCE|integer|13|c=Gets the prim equivalence of the object.}}
{{!}}{{#var:value}}
{{!}}Gets the prim equivalence of the object.
{{!}}max. 11 characters
{{!}}[[integer]] {{LSL PL|prim_count|disp=count}}
{{!}}[http://community.secondlife.com/t5/English-Knowledge-Base/Calculating-land-impact/ta-p/974163 Calculating land impact]
{{!}}
{{!}}-
{{!}}{{LSL Const|OBJECT_SERVER_COST|integer|14|c=Gets the server cost of the object.}}
{{!}}{{#var:value}}
{{!}}Gets the [[Mesh/Mesh_Server_Weight|server cost]] of the object.
{{!}}max. 15 characters
{{!}}[[float]] {{LSL PL|type=float|cost}}
{{!}}[[Mesh/Mesh_Server_Weight|Server cost]]
{{!}}
{{!}}-
{{!}}{{LSL Const|OBJECT_STREAMING_COST|integer|15|c=Gets the streaming (download) cost of the object.}}
{{!}}{{#var:value}}
{{!}}Gets the [[Mesh/Mesh_Streaming_Cost|streaming (download) cost]] of the object.
{{!}}max. 15 characters
{{!}}[[float]] {{LSL PL|cost}}
{{!}}[[Mesh/Mesh_Streaming_Cost|Streaming (download) cost]]
{{!}}
{{!}}-
{{!}}{{LSL Const|OBJECT_PHYSICS_COST|integer|16|c=Gets the physics cost of the object.}}
{{!}}{{#var:value}}
{{!}}Gets the [[Mesh/Mesh_physics#Physics_Resource_Cost|physics cost]] of the object.
{{!}}max. 15 characters
{{!}}[[float]] {{LSL PL|cost}}
{{!}}[[Mesh/Mesh_physics|Physics cost]]
{{!}}
{{!}}-
{{!}}{{LSL Const|OBJECT_CHARACTER_TIME|integer|17|c=Gets the average CPU time (in seconds) used by the object for navigation, if the object is a pathfinding character.}}
{{!}}{{#var:value}}
{{!}}Gets the average CPU time (in seconds) used by the object for navigation, if the object is a pathfinding character. Returns 0 for non-characters.
{{!}}max. 15 characters
{{!}}[[float]] {{LSL PL|seconds}}
{{!}}[[Viewerhelp:Pathfinding_characters|Pathfinding characters]]
{{!}}
{{!}}-
{{!}}{{LSL Const|OBJECT_ROOT|integer|18|c=Gets the id of the root prim of the object requested.}}
{{!}}{{#var:value}}
{{!}}Gets the id of the [[Link#Root_Prim|root prim]] of the object requested.<br/>If '''id''' is an avatar, returns the id of the [[Link#Root_Prim|root prim]] of the [[Link#Link_Set|linkset]] the avatar is sitting on and linked to (or the avatar's own id if the avatar is not sitting on an object within the region).
{{!}}36 characters
{{!}}[[key]] {{LSL PL|root|type=key}}
{{!}}
{{!}}[[llGetLinkKey]]
{{!}}-
{{!}}{{LSL Const|OBJECT_ATTACHED_POINT|integer|19|c=Gets the attachment point to which the object is attached.}}
{{!}}{{#var:value}}
{{!}}Gets the attachment point to which the object is attached. It returns an integer matching one of the {{LSLGC|Integer/attach point|ATTACH_*}} constants.
{{!}}max. 11 characters
{{!}}[[integer]] {{LSL PL|type=integer|subtype=attach_point}}
{{!}}
{{!}}[[llGetAttached]]
{{!}}-
{{!}}{{LSL Const|OBJECT_PATHFINDING_TYPE|integer|20|c=Gets the pathfinding setting of the object in the region. It returns an integer matching one of the OPT_* constants.}}
{{!}}{{#var:value}}
{{!}}Gets the pathfinding setting of the object in the region. It returns an integer matching one of the {{LSLGC|Pathfinding Types|OPT_*}} constants.
{{!}}max. 11 characters
{{!}}[[integer]] {{LSL PL|pathfinding_type|type=integer|disp=type}}
{{!}}[[Pathfinding_Quick_Start_Guide|Pathfinding types]]
{{!}}
{{!}}-
{{!}}{{LSL Const|OBJECT_PHYSICS|integer|21|c=Gets the boolean detailing if physics is enabled or disabled on the object.}}
{{!}}{{#var:value}}
{{!}}Gets the integer boolean detailing if physics is enabled or disabled on the object.<br/>If '''id''' is an {{LSLGC|Avatar|avatar}} or {{LSLGC|Attachment|attachment}}, {{HoverText|0|FALSE aka, Zero}} is returned.
{{!}}1 character
{{!}}[[integer]] {{LSL PL|type=integer|subtype=boolean}}
{{!}}
{{!}}[[llGetStatus]] [[PRIM_PHYSICS]]
{{!}}-
{{!}}{{LSL Const|OBJECT_PHANTOM|integer|22|c=Gets the boolean detailing if phantom is enabled or disabled on the object.}}
{{!}}{{#var:value}}
{{!}}Gets the integer boolean detailing if phantom is enabled or disabled on the object.<br/>If '''id''' is an {{LSLGC|Avatar|avatar}} or {{LSLGC|Attachment|attachment}}, {{HoverText|0|FALSE aka, Zero}} is returned.
{{!}}1 character
{{!}}[[integer]] {{LSL PL|type=integer|subtype=boolean}}
{{!}}
{{!}}[[llGetStatus]] [[PRIM_PHANTOM]]
{{!}}-
{{!}}{{LSL Const|OBJECT_TEMP_ON_REZ|integer|23|c=Gets the boolean detailing if temporary is enabled or disabled on the object.}}
{{!}}{{#var:value}}
{{!}}Gets the integer boolean detailing if temporary is enabled or disabled on the object.
{{!}}1 character
{{!}}[[integer]] {{LSL PL|type=integer|subtype=boolean}}
{{!}}
{{!}}[[PRIM_TEMP_ON_REZ]]
{{!}}-
{{!}}{{LSL Const|OBJECT_RENDER_WEIGHT|integer|24|c=Gets the avatar's render weight.}}
{{!}}{{#var:value}}
{{!}}{{#var:comment}}<br/>If '''id''' is an object, {{HoverText|0|FALSE aka, Zero}} is returned. If '''id''' is an avatar whose render weight is unknown to the simulator, -1 is returned. The maximum render weight reported by the server is 500000<ref>On July 2016, {{u|Rolig Loon}} commented on [[Talk:LlGetObjectDetails#new_constants_Sep._2013|the talk page for llGetObjectDetails()]] that allegedly SL viewers are showing render weights of 1,300,000.</ref>.
{{!}}max. 6 characters
{{!}}[[integer]] {{LSL PL|type=integer|weight}}
{{!}} [[Avatar_Rendering_Cost]]
{{!}}
{{!}}-
{{!}}{{LSL Const|OBJECT_HOVER_HEIGHT|integer|25|c=Gets the hover height of the avatar.}}
{{!}}{{#var:value}}
{{!}}Gets the [[Hover Height|hover height]] of the avatar.<br>If '''id''' is not an avatar, 0.0 is returned. Normal values are in the range {{Interval|gte=-2.0|lte=2.0|center=hover_height}} with a default of 0.0. This value does ''not'' reflect the avatar shape's "Hover" slider, only the dynamic viewer setting.
{{!}}max. 9 characters
{{!}}[[float]] {{LSL PL|type=float|height}}
{{!}}
{{!}}
{{!}}-
{{!}}{{LSL Const|OBJECT_BODY_SHAPE_TYPE|integer|26|c=Gets a float which describes the sex of the body shape of the avatar.}}
{{!}}{{#var:value}}
{{!}}Gets a float which describes the sex setting of the avatar's currently worn shape.<br>If '''id''' is not an avatar, -1.0 is returned.<br>Normal operational values are in the range {{Interval|gte=0.0|lte=1.0|center=shape}}.
* 0.0 is standard female setting,
* 1.0 is standard male setting.
Intermediate values with visible differences are possible with manually crafted shapes.
{{!}}max. 9 characters
{{!}}[[float]] {{LSL PL|type=float|body_shape|disp=shape}}
{{!}}
{{!}}
{{!}}-
{{!}}{{LSL Const|OBJECT_LAST_OWNER_ID|integer|27|c=Gets the UUID of the object's previous owner, if known.}}
{{!}}{{#var:value}}
{{!}}Gets the UUID of the object's previous owner, if known.
* For group-owned objects, this is the avatar that deeded the object.
* Returns [[NULL_KEY]] for avatars, or objects that were never transferred.
* A rezzed object taken back to inventory, then re-rezzed, will return its current owner key.
{{!}}36 characters
{{!}}[[key]] {{LSL PL|type=key|subtype=owner|last_owner}}
{{!}}
{{!}}
{{!}}-
{{!}}{{LSL Const|OBJECT_CLICK_ACTION|integer|28|c=Gets the click action of the prim.}}
{{!}}{{#var:value}}
{{!}}Gets the [[llSetClickAction|click action]] of the prim. It returns an integer matching one of the {{LSLGC|Click Action|CLICK_ACTION_*}} constants.
{{!}}max. 3 characters
{{!}}[[integer]] {{LSL PL|type=integer|subtype=click_action|action}}
{{!}}
{{!}}
{{!}}-
{{!}}{{LSL Const|OBJECT_OMEGA|integer|29|c=Gets the object's omega.}}
{{!}}{{#var:value}}
{{!}}Gets the object's rotational velocity (radians per second).
{{!}}36 characters
{{!}}[[vector]] {{LSL PL|type=vector|omega}}
{{!}}
{{!}} [[llGetOmega]]
{{!}}-
{{!}}{{LSL Const|OBJECT_PRIM_COUNT|integer|30|c=Gets the object's prim count.}}
{{!}}{{#var:value}}
{{!}}Gets the object's prim count
{{!}}max. 3 characters
{{!}}[[integer]] {{LSL PL|type=integer|count}}
{{!}} [[llGetObjectPrimCount]]
{{!}} [[llGetNumberOfPrims]]
{{!}}-
{{!}}{{LSL Const|OBJECT_TOTAL_INVENTORY_COUNT|integer|31|c=Gets the object's total number of inventory items.}}
{{!}}{{#var:value}}
{{!}}Gets the object's total number of [[llGetInventoryNumber|inventory items]].
{{!}}max. 10 characters
{{!}}[[integer]] {{LSL PL|type=integer|count}}
{{!}}
{{!}} [[llGetInventoryNumber]]{{PBR}}([[INVENTORY_ALL]])
{{!}}-
{{!}}{{LSL Const|OBJECT_REZZER_KEY|integer|32|c=Gets the key of the object that rezzed the object.}}
{{!}}{{#var:value}}
{{!}}Gets the key of the object that rezzed this object be it an object or an avatar.
{{!}}36 characters
{{!}}[[key]] {{LSL PL|type=key|rezzer}}
{{!}}
{{!}}
{{!}}-
{{!}}{{LSL Const|OBJECT_GROUP_TAG|integer|33|c=Gets the avatar's group tag text.}}
{{!}}{{#var:value}}
{{!}}Gets the avatar's group tag text.<br>If '''id''' is not an avatar, an empty string is returned.
{{!}}max. 20 bytes
{{!}}[[string]] {{LSL PL|type=string|text}}
{{!}}
{{!}}
{{!}}-
{{!}}{{LSL Const|OBJECT_TEMP_ATTACHED|integer|34|c=Gets the integer boolean detailing if the object is temporarily attached.}}
{{!}}{{#var:value}}
{{!}}Gets the integer boolean detailing if the object is [[llAttachToAvatarTemp|temporarily attached]].
{{!}}1 character
{{!}}[[integer]] {{LSL PL|type=integer|subtype=boolean}}
{{!}}
{{!}}
{{!}}-
{{!}}{{LSL Const|OBJECT_ATTACHED_SLOTS_AVAILABLE|integer|35|c=Gets the avatar's available attachment slot count.}}
{{!}}{{#var:value}}
{{!}}Gets the avatar's available attachment slot count.<br>If '''id''' is not an avatar, 0 is returned.
{{!}}max. 2 characters
{{!}}[[integer]] {{LSL PL|type=integer|count}}
{{!}}
{{!}}
{{!}}-
{{!}}{{LSL Const|OBJECT_CREATION_TIME|integer|36|c=Gets the object's creation time.}}
{{!}}{{#var:value}}
{{!}}Gets the object's creation time. This time is established with raw material rezzing through the build menu and with mesh uploads.<br>This time is NOT established with inventory rezzes, scripted rezzes, object modifying, copying or transferring.<br>If '''id''' is an avatar, an empty string is returned.
{{!}}max. 27 bytes
{{!}}[[string]] {{LSL PL|type=string|timestamp}}
{{!}}
{{!}}
{{!}}-
{{!}}{{LSL Const|OBJECT_SELECT_COUNT|integer|37|c=Gets the total number of agents selecting any links in the object.}}
{{!}}{{#var:value}}
{{!}}Gets the total number of agents selecting any links in the object.<br>If '''id''' is an avatar, 0 is returned.
{{!}}max. 3 characters
{{!}}[[integer]] {{LSL PL|type=integer|count}}
{{!}}
{{!}}
{{!}}-
{{!}}{{LSL Const|OBJECT_SIT_COUNT|integer|38|c=Gets the total number of agents sitting on any links in the object.}}
{{!}}{{#var:value}}
{{!}}Gets the total number of agents sitting on any links in the object.<br>If '''id''' is an avatar, 0 is returned.
{{!}}max. 3 characters
{{!}}[[integer]] {{LSL PL|type=integer|count}}
{{!}}
{{!}}
{{!}}-
{{!}}{{LSL Const|OBJECT_ANIMATED_COUNT|integer|39|c=Gets the integer boolean detailing if the object'root is set to "Animated Mesh" or gets the total number of "Animated Mesh" attachments worn by an agent.}}
{{!}}{{#var:value}}
{{!}}Gets the integer boolean detailing if the object's root is set to "Animated Mesh" or gets the total number of "Animated Mesh" attachments worn by an agent.
{{!}}max. 1 character
{{!}}[[integer]] {{LSL PL|type=integer|count}}
{{!}}
{{!}}
{{!}}-
{{!}}{{LSL Const|OBJECT_ANIMATED_SLOTS_AVAILABLE|integer|40|c=Gets the avatar's available "Animated Mesh" attachment slot count.}}
{{!}}{{#var:value}}
{{!}}Gets the avatar's available "Animated Mesh" attachment slot count.<br>If '''id''' is not an avatar, 0 is returned.
{{!}}max. 2 characters
{{!}}[[integer]] {{LSL PL|type=integer|count}}
{{!}}
{{!}}
{{!}}-
{{!}}{{LSL Const|OBJECT_ACCOUNT_LEVEL|integer|41|c=Gets the account level of an avatar.}}
{{!}}{{#var:value}}
{{!}}Gets the account level of an avatar.<br>If '''id''' is not an avatar, -1 is returned.
* 0 is Basic account level.
* 1 is Premium account level.
* 5 is Plus account level.
* 10 is Premium Plus account level.
{{!}}max. 1 character
{{!}}[[integer]] {{LSL PL|type=integer|level}}
{{!}}
{{!}}
{{!}}-
{{!}}{{LSL Const|OBJECT_MATERIAL|integer|42|c=Gets the physics material for this object.}}
{{!}}{{#var:value}}
{{!}}Retrieves the physics material set on this object. It returns an integer matching one of the {{LSLGC|Prim/Materials|PRIM_MATERIAL_*}} constants.
{{!}}
{{!}}[[integer]] {{LSL PL|type=integer|material}}
{{!}}
{{!}} [[llGetPrimitiveParams]]<br>[[PRIM_MATERIAL]]
{{!}}-
{{!}}{{LSL Const|OBJECT_MASS|integer|43|c=Gets the physics mass of this object's linkset.}}
{{!}}{{#var:value}}
{{!}}Gets the mass (in Kilograms) of this object's linkset.
{{!}}
{{!}}[[float]] {{LSL PL|type=float|mass}}
{{!}}
{{!}} [[llGetMassMKS]]
{{!}}-
{{!}}{{LSL Const|OBJECT_TEXT|integer|44|c=Gets the floating text string on this object.}}
{{!}}{{#var:value}}
{{!}}Gets the floating text displayed above this object.
{{!}}
{{!}}[[string]] {{LSL PL|type=string|text}}
{{!}}
{{!}} [[llGetPrimitiveParams]]<br>[[PRIM_TEXT]]
{{!}}-
{{!}}{{LSL Const|OBJECT_REZ_TIME|integer|45|c=Retrieves the time that this object was rezzed.}}
{{!}}{{#var:value}}
{{!}}{{#var:comment}}
{{!}}
{{!}}[[string]] time
{{!}}
{{!}}
{{!}}-
{{!}}{{LSL Const|OBJECT_LINK_NUMBER|integer|46|c=Get this object's index in the linkset.}}
{{!}}{{#var:value}}
{{!}}{{#var:comment}}
{{!}}
{{!}}[[integer]] link_number
{{!}}
{{!}} [[llGetLinkNumber]]
{{!}}-
{{!}}{{LSL Const|OBJECT_SCALE|integer|47|c=Get the size of this object.}}
{{!}}{{#var:value}}
{{!}}{{#var:comment}}
{{!}}
{{!}}[[vector]] scale
{{!}}
{{!}} [[llGetScale]]
{{!}}-
{{!}}{{LSL Const|OBJECT_TEXT_COLOR|integer|48|c=Gets the color of the floating text displayed above this object.}}
{{!}}{{#var:value}}
{{!}}{{#var:comment}}
{{!}}
{{!}}[[vector]] color
{{!}}
{{!}} [[llGetPrimitiveParams]]<br>[[PRIM_TEXT]]
{{!}}-
{{!}}{{LSL Const|OBJECT_TEXT_ALPHA|integer|49|c=Gets the alpha value of the floating text displayed above this object.}}
{{!}}{{#var:value}}
{{!}}{{#var:comment}}
{{!}}
{{!}}[[float]] alpha
{{!}}
{{!}} [[llGetPrimitiveParams]]<br>[[PRIM_TEXT]]
{{!}}-
{{!}}{{LSL Const|OBJECT_HEALTH|integer|50|c=Retrieves the health of an avatar or prim.}}
{{!}}{{#var:value}}
{{!}}{{#var:comment}}
{{!}}
{{!}}[[float]] health
{{!}}
{{!}} [[llGetPrimitiveParams]]<br>[[PRIM_HEALTH]]<br>
[[llGetHealth]]
{{!}}-
{{!}}{{LSL Const|OBJECT_DAMAGE|integer|51|c=Retrieves the amount of damage a prim inflicts on collision.}}
{{!}}{{#var:value}}
{{!}}{{#var:comment}}
{{!}}
{{!}}[[float]] damage
{{!}}
{{!}} [[llGetPrimitiveParams]]<br>[[PRIM_DAMAGE]]
{{!}}-
{{!}}{{LSL Const|OBJECT_DAMAGE_TYPE|integer|52|c=Retrieves the type of damage a prim inflicts on collision.}}
{{!}}{{#var:value}}
{{!}}Retrieves the type of damage a prim inflicts on collision. It returns an integer that can match one of the [[:Category:LSL_Combat2#Damage_Types|DAMAGE_TYPE_*]] constants, be a custom damage type or be repurposed by a combat system.
{{!}}
{{!}}[[integer]] damage_type
{{!}}
{{!}} [[llGetPrimitiveParams]]<br>[[PRIM_DAMAGE]]
{{!}}-
{{!}}{{LSL Const|OBJECT_PERMS|integer|53|c=Retrieves the permissions for this object.}}
{{!}}{{#var:value}}
{{!}} Retrieves the permissions for this object as 5 integers.
{{!}} rowspan=2 |
{{!}} rowspan=2 |[[integer]] base, [[integer]] owner, [[integer]] group, [[integer]] everyone, [[integer]] next_owner
{{!}} rowspan=2 |
{{!}} rowspan=2 | [[llGetObjectPermMask]]
{{!}}-
{{!}}{{LSL Const|OBJECT_PERMS_COMBINED|integer|54|c=Retrieves the permissions for this object and all of its contents.}}
{{!}}{{#var:value}}
{{!}} Retrieves the permissions for this object combined with all of its inventory items as 5 integers.

{{!}}-
{{!}}}

LlGetInventoryPermMask

Maestro Linden — Thu, 23 Jan 2025 23:28:49 GMT

Maestro Linden: added note that MASK_COMBINED is not meaningful to this function - it exists for llGetObjectPermMask

{{LSL_Function
|inject-2={{LSL_Function/inventory|item|uuid=false}}
|func_id=289|func_sleep=0.0|func_energy=10.0
|func=llGetInventoryPermMask|return_type=integer|return_subtype=bit field
|p1_type=string|p1_name=item
|p2_type=integer|p2_name=category|p2_desc=MASK_* flag
|func_footnote
|func_desc
|return_text=of the requested permission {{LSLP|category}} for the inventory {{LSLP|item}}
|spec
|caveats=
* Note that including the [[MASK_COMBINED]] bit does not impact the output of this function, as the combined permissions are the only accessible permissions for inventory items.
|constants={{LSL Constants Perm Mask}}
|examples=
<source lang="lsl2">
if ((permsYouHave & permsYouWant) == permsYouWant)
llSay(PUBLIC_CHANNEL, "You have the perms you want.");
else
llSay(PUBLIC_CHANNEL, "You don't have the perms you want.");
</source>
<source lang="lsl2">
integer ownerPerms = llGetInventoryPermMask("inventory item name goes here", MASK_OWNER);
integer copyAndModPerms = PERM_COPY | PERM_MODIFY;

if ((ownerPerms & copyAndModPerms) == copyAndModPerms)
llSay(PUBLIC_CHANNEL, "Owner has copy & modify perms.");
else
llSay(PUBLIC_CHANNEL, "Owner does not have copy & modify perms.");
</source>
<source lang="lsl2">
string getPermsAsReadableString(integer perm)
{
integer fullPerms = PERM_COPY | PERM_MODIFY | PERM_TRANSFER;
integer copyModPerms = PERM_COPY | PERM_MODIFY;
integer copyTransPerms = PERM_COPY | PERM_TRANSFER;
integer modTransPerms = PERM_MODIFY | PERM_TRANSFER;

string output = " perms: ";

if ((perm & fullPerms) == fullPerms)
output += "full";
else if ((perm & copyModPerms) == copyModPerms)
output += "copy & modify";
else if ((perm & copyTransPerms) == copyTransPerms)
output += "copy & transfer";
else if ((perm & modTransPerms) == modTransPerms)
output += "modify & transfer";
else if ((perm & PERM_COPY) == PERM_COPY)
output += "copy";
else if ((perm & PERM_TRANSFER) == PERM_TRANSFER)
output += "transfer";
else
output += "none";

// Remember, items in Second Life must have either
// PERM_COPY or PERM_TRANSFER when "talking about"
// owner perms or perms for next owner.

return output;
}

default
{
state_entry()
{
string inventoryItemName = "inventory item name goes here";

integer basePerms = llGetInventoryPermMask(inventoryItemName, MASK_BASE);
integer ownerPerms = llGetInventoryPermMask(inventoryItemName, MASK_OWNER);
integer nextOwnerPerms = llGetInventoryPermMask(inventoryItemName, MASK_NEXT);
integer groupPerms = llGetInventoryPermMask(inventoryItemName, MASK_GROUP);
integer everyonePerms = llGetInventoryPermMask(inventoryItemName, MASK_EVERYONE);

llSay(0, "/me [" + inventoryItemName
+ "]: base" + getPermsAsReadableString(basePerms));
llSay(0, "/me [" + inventoryItemName
+ "]: owner" + getPermsAsReadableString(ownerPerms));
llSay(0, "/me [" + inventoryItemName
+ "]: next owner" + getPermsAsReadableString(nextOwnerPerms));
llSay(0, "/me [" + inventoryItemName
+ "]: group" + getPermsAsReadableString(groupPerms));
llSay(0, "/me [" + inventoryItemName
+ "]: everyone" + getPermsAsReadableString(everyonePerms));
}
}
</source>
To test for the opposite (e.g. to see if something is NOT copy):
<source lang="lsl2">
if (!(PERM_COPY & llGetInventoryPermMask(myitem, MASK_OWNER)))
llSay(PUBLIC_CHANNEL, "/me [" + myitem + "]: owner doesn't have copy perms.");
</source>

To remind the next owner what permissions to set before selling on
choose which need to be set;

<source lang="lsl2">
CheckPerms()
{
string item = llGetScriptName();
integer nextOwnerPerms = llGetInventoryPermMask(item, MASK_NEXT);

if(PERM_COPY & nextOwnerPerms)
llOwnerSay("Set no copy");

if(PERM_MODIFY & nextOwnerPerms)
llOwnerSay("Set no mod");

if(PERM_TRANSFER & nextOwnerPerms)
llOwnerSay("Set no transfer");
}

default
{
on_rez(integer start_param)
{
llResetScript();
}

state_entry()
{
if(llGetOwner() != llGetInventoryCreator(llGetScriptName()))
CheckPerms();
}
}
</source>

|helpers
|also_functions=
{{LSL DefineRow||[[llGetObjectPermMask]]|}}
{{LSL DefineRow||[[llGetInventoryAcquireTime]]|Returns the time the item was added to the prim's inventory}}
{{LSL DefineRow||[[llGetInventoryName]]|Returns the inventory item's name}}
{{LSL DefineRow||[[llGetInventoryType]]|Tests to see if an inventory item exists and returns its type}}
{{LSL DefineRow||[[llGetInventoryNumber]]|Returns the number of items of a specific type in inventory}}
{{LSL DefineRow||[[llGetInventoryKey]]|Returns the inventory item's [[UUID]] (if full perm)}}
{{LSL DefineRow||[[llGetInventoryCreator]]|Returns the inventory item's creator}}
|also_events
|also_tests=
{{LSL DefineRow||[[llGetInventoryPermMask Test]]}}
|also_articles=
{{LSL DefineRow||[[hex]]}}
|notes=
* In effect, the perms for articles published on this Wiki are [[PERM_COPY]] and [[PERM_TRANSFER]] until you log in, then [[PERM_MODIFY]], [[PERM_MOVE]], [[PERM_COPY]] and [[PERM_TRANSFER]].
* The default perms of a newly created script are: Base = [[PERM_ALL]], Owner = [[PERM_ALL]], Next = [[PERM_MOVE]] or [[PERM_TRANSFER]], Group = 0 (none), Everyone = 0 (none). These perms are the same, no matter if the script is created in user inventory or in an object.
** However, an option in the ''[[Preferences window|Preferences]] > Advanced'' menu allows to set the '''Default Creation Permissions''' of all items that can be created or uploaded in-world.
|cat1=Inventory
|cat2=Permissions/Asset
|cat3
|cat4
}}

Template:LSL Constants Sensor

Maestro Linden — Thu, 05 Sep 2024 21:10:35 GMT

Maestro Linden: Clarify that the DAMAGEABLE bit can be set on agents.

{{#if:{{{no_wrapper|}}}||{{{!}} }}
{{!}}- valign="top"
{{!}} <div style="display:inline-block;">
{{{!}} {{Prettytable|style=margin-bottom:0;{{{tstyle|}}}}}
{{!}}-{{Hl2}}
! colspan="2" {{!}} '''{{{1|}}} Flag Mask'''
! '''Description ([[llDetectedType]]())'''
! '''Description ([[llSensor]]() and [[llSensorRepeat]]() mask)'''
{{!}}-{{#if:
{{!}} {{#vardefine:AGENT_BY_LEGACY_NAME|{{LSL Const|AGENT_BY_LEGACY_NAME|integer|1|hex=0x1|c=Agents}}}}{{#var:AGENT_BY_LEGACY_NAME}}
{{!}} {{#var:value}}
{{!}} {{#var:comment}}
{{!}} This is used to find agents by {{LSLGC|Avatar/Name|legacy name}}.
{{!}}-
{{!}} {{#vardefine:AGENT|{{LSL Const|AGENT|integer|1|hex=0x1|c=Agents}}}}{{#var:AGENT}}
{{!}} {{#var:value}}
{{!}} {{#var:comment}}
{{!}} This is also used to find agents by {{LSLGC|Avatar/Name|legacy name}}, and is functionally identical to [[AGENT_BY_LEGACY_NAME]]
{{!}}-
{{!}} {{#vardefine:AGENT_BY_USERNAME|{{LSL Const|AGENT_BY_USERNAME|integer|16|hex=0x10|c=Agents}}}}{{#var:AGENT_BY_USERNAME}}
{{!}} {{#var:value}}
{{!}} ''{{HoverText|Reserved|This value is currently not used by llDetectedType}}''
{{!}} This is used to find agents by {{LSLGC|Avatar/Name|username}}.
{{!}}-
{{!}} {{#vardefine:ACTIVE|{{LSL Const|ACTIVE|integer|2|hex=0x2|c=Physical tasks. (Physical objects & agents) }}}}{{#var:ACTIVE}}
{{!}} {{#var:value}}
{{!}} {{#var:comment}}
{{!}} Physical objects that are moving or objects containing an active script. Thus, it is using SL server resources now.
{{!}}-
{{!}} {{#vardefine:PASSIVE|{{LSL Const|PASSIVE|integer|4|hex=0x4|c=Non-physical objects.}}}}{{#var:PASSIVE}}
{{!}} {{#var:value}}
{{!}} {{#var:comment}}
{{!}} Non-scripted or script is inactive and non-physical or, if physical, not moving. Thus, it is not using SL server resources now.
{{!}}-
{{!}} {{#vardefine:SCRIPTED|{{LSL Const|SCRIPTED|integer|8|hex=0x8|c=Objects containing any active script.}}}}{{#var:SCRIPTED}}
{{!}} {{#var:value}}
{{!}} {{#var:comment}}
{{!}} Objects that has any script, which is doing anything in simulator just now.
{{!}}-
{{!}} {{#vardefine:DAMAGEABLE|{{LSL Const|DAMAGEABLE|integer|32|hex=0x20|c=Objects & agents that are able to process damage.}}}}{{#var:DAMAGEABLE}}
{{!}} {{#var:value}}
{{!}} {{#var:comment}}
{{!}} Filter for objects in world that have a script with [[on_damage]] or a [[final_damage]] event (able to process damage)
{{!}}}
</div><div style="display:inline-block;">
{{{!}} {{Prettytable}}
{{!}}-{{Hl2}}
![[llDetectedType]]()
!Scripted
!Not Scripted
!Agent Standing
!title="Agent sitting on object"|Agent Sitting
{{!}}-
! Physical Movement
{{!}} 10 ({{#var:ACTIVE}}|{{#var:SCRIPTED}})
{{!}} 2 ({{#var:ACTIVE}})
{{!}} 3 ({{#var:ACTIVE}}|{{#var:AGENT}})
{{!}} 3 ({{#var:ACTIVE}}|{{#var:AGENT}})
{{!}}-
! title="Not moving" | Non-Physical
{{!}} 12 ({{#var:PASSIVE}}|{{#var:SCRIPTED}})
{{!}} 4 ({{#var:PASSIVE}})
{{!}} 1 ({{#var:AGENT}})
{{!}} 5 ({{#var:PASSIVE}}|{{#var:AGENT}})
{{!}}}</div>
{{#if:{{{no_wrapper|}}}||{{!}}} }}{{#if:

{{#vardefine:also_articles|{{#var:also_articles}}
{{LSL DefineRow|2=[http://lslwiki.net/lslwiki/wakka.php?wakka=ObjectType Object Type]}}}}

{{#if:{{{examples|}}}<noinclude>*</noinclude>|
{{#vardefine:examples|{{#var:examples}}
'''Using [[llDetectedType]] in [[collision]] event:'''
<source lang="lsl2">
integer type;

default
{
state_entry()
{
llVolumeDetect(TRUE);
}
collision_start(integer detected)
{
type = llDetectedType(0);
if (type == AGENT)// = 1
{
llSay(0, "This is impossible. Since there is no avatar who doesn't require the physical calculation.");
}
else if (type == ACTIVE)// = 2
{
llSay(0, "I have been struck by a physical object not containing any script.");
}
else if (type == PASSIVE)// = 4
{
llSay(0, "This is impossible. Non-physical objects cannot trigger this event.");
}
else if (type == SCRIPTED)// = 8
{
llSay(0, "This is impossible. Since there is no object which isn't physical nor non-physical.");
}
else if (type == (AGENT | ACTIVE) ) // 1 + 2
{
llSay(0, "I have been struck by an avatar.");
}
else if (type == (SCRIPTED | ACTIVE) ) // = 8 + 2
{
llSay(0, "I have been struck by a physical object containing any script.");
}
else if (type == (SCRIPTED | PASSIVE) ) // = 8 + 4
{
llSay(0, "This is impossible. Non-physical objects cannot trigger this event.");
}
}
}
</source>
'''Using [[llDetectedType]] in [[sensor]] event:'''
<source lang="lsl2">
default
{
touch_start(integer numberDetected)
{
llSensor("", "", ACTIVE | PASSIVE | AGENT, 20.0, PI); // activates the sensor.
}

sensor (integer numberDetected)
{
integer i;
while(i < numberDetected)
{
integer type = llDetectedType(i);
string message;
message += (string)i + ", " + llDetectedName(i) + ", ";
list typeList;
if (type & AGENT)
{
typeList += "AGENT";
}
if (type & ACTIVE)
{
typeList += "ACTIVE";
}
if (type & PASSIVE)
{
typeList += "PASSIVE";
}
if (type & SCRIPTED)
{
typeList += "SCRIPTED";
}
message += llDumpList2String(typeList, "|");
llWhisper(0, message);
++i;
}
}

no_sensor()
{
// This is impossible if range = 20.0 and you are standing within 10m!
llWhisper(0, "Nothing is near me at present.");
}
}
</source>
'''Using filter in {{LSLGC|Sensor|llSensor*}} functions:'''
<source lang="lsl2">
// Report nearby sensed objects and avatars under sundry categories

list SenseTypes;
integer gIndex;

SenseNextType()
{
string text = llList2String( SenseTypes, gIndex);
integer tipe = llList2Integer(SenseTypes, gIndex + 1);
if (tipe)
{
llWhisper(0, text);
llSensor("", NULL_KEY, tipe, 20.0, PI);
gIndex += 2; // increment by stride
}
else
llWhisper(0, "--- Finished ---");
}

default
{
touch_start(integer detected)
{
// Make a Strided list of text and sensor type combinations
// (Can't use '|' in Global, unfortunately)
SenseTypes = [
"AGENT_BY_LEGACY_NAME", AGENT_BY_LEGACY_NAME,
"ACTIVE", ACTIVE,
"AGENT_BY_LEGACY_NAME|ACTIVE", AGENT_BY_LEGACY_NAME|ACTIVE,
"PASSIVE", PASSIVE,
"AGENT_BY_LEGACY_NAME|PASSIVE", AGENT_BY_LEGACY_NAME|PASSIVE,
"ACTIVE|PASSIVE", ACTIVE|PASSIVE,
"AGENT_BY_LEGACY_NAME|ACTIVE|PASSIVE", AGENT_BY_LEGACY_NAME|ACTIVE|PASSIVE,
"SCRIPTED", SCRIPTED,
"AGENT|SCRIPTED", AGENT|SCRIPTED,
"ACTIVE|SCRIPTED", ACTIVE|SCRIPTED,
"AGENT_BY_LEGACY_NAME|ACTIVE|SCRIPTED", AGENT_BY_LEGACY_NAME|ACTIVE|SCRIPTED,
"PASSIVE|SCRIPTED", PASSIVE|SCRIPTED,
"", 0 ];
gIndex = 0;
SenseNextType(); // Kick off the sensing sequence
}
sensor(integer detected)
{
integer x;
while (x < detected)
{
llWhisper(0, (string) (x+1) + ": " + llDetectedName(x) );
++x;
}
SenseNextType();
}
no_sensor()
{
llWhisper(0, "none");
SenseNextType();
}
}
</source>
See [http://lslwiki.net/lslwiki/wakka.php?wakka=ObjectType Object Type] for details
}}}}

}}<noinclude>{{#var:examples}}</noinclude>

DAMAGEABLE

Maestro Linden — Thu, 05 Sep 2024 21:06:43 GMT

Maestro Linden: Created page with "{{LSL Constant |name=DAMAGEABLE |type=integer |hvalue=0x20 |desc=If it is contained in the result of llDetectedType(), it means what was detected is either an agent th..."

{{LSL Constant
|name=DAMAGEABLE
|type=integer
|hvalue=0x20
|desc=If it is contained in the result of [[llDetectedType]](), it means what was detected is either an [[agent]] that can take damage, or is an object containing a script with either [[on_damage]]() or [[final_damage]]() events (able to process damage).<br />If it is used as a filter of [[llSensor]]() or [[llSensorRepeat]](), it will search for agents or objects which match the same criteria mentioned above.
|constants={{LSL Constants Sensor|no_wrapper=true|examples=*}}
|functions=
{{LSL DefineRow||[[llDetectedType]]|}}
{{LSL DefineRow||[[llSensor]]|}}
{{LSL DefineRow||[[llSensorRepeat]]|}}
|events=
|cat1=Sensor
|cat2
|cat3
|cat4
}}

Template:LSL Constants/Vehicle Flags

Maestro Linden — Tue, 27 Aug 2024 20:14:04 GMT

Maestro Linden: add VEHICLE_FLAG_BLOCK_INTERFERENCE

{{#if:{{{no_wrapper|}}}||{{{!}} class="sortable" {{Prettytable}}
{{!}}-{{Hl2}}
! Flags
! title="Value" {{!}}
! class="unsortable" {{!}}Description
{{!}}-}}
{{!}} {{LSL Const|VEHICLE_FLAG_NO_DEFLECTION_UP|integer|hex=0x001|ihex=1}}
{{!}} {{#var:value}}
{{!}} This flag prevents linear deflection parallel to world z-axis. This is useful for preventing ground vehicles with large linear deflection, like {{Wikipedia|Bumper car|bumper cars}}, from climbing their linear deflection into the sky.
{{!}}-
{{!}} {{LSL Const|VEHICLE_FLAG_LIMIT_ROLL_ONLY|integer|hex=0x002|ihex=2}}
{{!}} {{#var:value}}
{{!}} For vehicles with vertical attractor that want to be able to climb/dive, for instance, airplanes that want to use the banking feature.
{{!}}-
{{!}} {{LSL Const|VEHICLE_FLAG_HOVER_WATER_ONLY|integer|hex=0x004|ihex=4}}
{{!}} {{#var:value}}
{{!}} Ignore terrain height when hovering.
{{!}}-
{{!}} {{LSL Const|VEHICLE_FLAG_HOVER_TERRAIN_ONLY|integer|hex=0x008|ihex=8}}
{{!}} {{#var:value}}
{{!}} Ignore water height when hovering.
{{!}}-
{{!}} {{LSL Const|VEHICLE_FLAG_HOVER_GLOBAL_HEIGHT|integer|hex=0x010|ihex=16}}
{{!}} {{#var:value}}
{{!}} Hover at global height instead of height above ground or water.
{{!}}-
{{!}} {{LSL Const|VEHICLE_FLAG_HOVER_UP_ONLY|integer|hex=0x020|ihex=32}}
{{!}} {{#var:value}}
{{!}} Hover doesn't push down. Use this flag for hovering vehicles that should be able to jump above their hover height.
{{!}}-
{{!}} {{LSL Const|VEHICLE_FLAG_LIMIT_MOTOR_UP|integer|hex=0x040|ihex=64}}
{{!}} {{#var:value}}
{{!}} Prevents ground vehicles from motoring into the sky. This flag has a subtle effect when used with conjunction with banking: the strength of the banking will decay when the vehicle no longer experiences collisions. The decay timescale is the same as [[VEHICLE_BANKING_TIMESCALE]]. This is to help prevent ground vehicles from steering when they are in mid jump.
{{!}}-
{{!}} {{LSL Const|VEHICLE_FLAG_MOUSELOOK_STEER|integer|hex=0x080|ihex=128}}
{{!}} {{#var:value}}
{{!}} Steer the vehicle using the mouse. Use this flag to make the angular motor try to make the vehicle turn such that its local x-axis points in the same direction as the client-side camera.
{{!}}-
{{!}} {{LSL Const|VEHICLE_FLAG_MOUSELOOK_BANK|integer|hex=0x100|ihex=256}}
{{!}} {{#var:value}}
{{!}} Same as above, but relies on banking. It remaps left-right motions of the client camera (also known as "yaw") to rotations about the vehicle's local x-axis.
{{!}}-
{{!}} {{LSL Const|VEHICLE_FLAG_CAMERA_DECOUPLED|integer|hex=0x200|ihex=512}}
{{!}} {{#var:value}}
{{!}} Makes [[mouselook]] {{LSLGC|Camera|camera}} rotate independently of the vehicle. By default the client mouselook camera will rotate about with the vehicle, however when this flag is set the camera direction is independent of the vehicle's rotation.
{{!}}-
{{!}} {{LSL Const| VEHICLE_FLAG_BLOCK_INTERFERENCE|integer|hex=0x400|ihex=1024}}
{{!}} {{#var:value}}
{{!}} Prevents attachments worn by the vehicle's passengers from pushing the vehicle via [[llPushObject]] and similar functions.
{{#if:{{{no_wrapper|}}}||{{!}}} }}

VEHICLE FLAG BLOCK INTERFERENCE

Maestro Linden — Tue, 27 Aug 2024 20:09:05 GMT

Maestro Linden: comma

{{LSL Constant
|name=VEHICLE_FLAG_BLOCK_INTERFERENCE
|type=integer
|value=0x400
|desc=When set, this flag prevents the vehicle you're sitting on from being pushed by an attachment you're wearing.
|example
|functions=
{{LSL DefineRow||[[llSetVehicleFlags]]|}}
{{LSL DefineRow||[[llRemoveVehicleFlags]]|}}
|events=

|articles={{LSL DefineRow||[[Linden Vehicle Tutorial]]}}
|cat1=Vehicle/Flags
|cat2
|cat3
|cat4
}}

Estate Manager

Maestro Linden — Fri, 23 Aug 2024 19:17:30 GMT

Maestro Linden: Corrected relationship between 'allow damage' setting and per-parcel damage settings

{{Help|LandSim=*|Glossary=*}}<div style="float:right;">__TOC__</div>
An Estate Manager is a land manager for a privately owned island, much like a landlord. Estate managers have control over settings for the entire island (sim) which they manage, and settings that they change occur on a global level, therefore affecting all parcels of land on that particular island.

== Appointment ==
Estate Managers are employed by owners of private islands (estate owners) to assist in the day-to-day operations of managing their island(s).

== Responsibilities ==
While individual responsibilities differ from island to island, many estate managers share a basic set of common responsibilities, as listed below...

=== Covenant Enforcement ===
Most privately owned islands have established covenants which describe to the Residents that occupy the parcels within which types of activities are acceptable, and which are not. It is often the responsibility of the estate manager to monitor the island(s) for violations of this covenant and not only notify the owner of the parcel which is in violation, but also provide consequences if the violation is not remedied in a acceptable amount of time from said notification. In some cases, the estate manager is also responsible for assisting the parcel owner in resolving the violation in any way they can.

=== Land Sales ===
Many estate managers are responsible for selling available parcels of land on islands which they manage. This is generally only required when a privately owned island is first placed on the market, as once the parcels have been purchased by individual users, it commonly becomes their responsibility to sell the parcel when they desire to move away from it.
=== Dispute Resolution ===
As privately owned islands are commonly divided into separate parcels of land for purchase by many different residents, those occupying neighboring parcels of land can have complaints to lodge against one another, or even worse, get into disputes with each other. The estate manager is often bestowed the responsibility of mediating such disputes so that an acceptable resolution for all parties is reached.

=== Performance Monitoring ===
Since many parcel owners use an abundance of scripts and/or physical objects on their land, issues which affect the overall performance of the island can arise. An island which performs poorly not only becomes unattractive to potential buyers, but to its current Residents as well. As a result, it is often the responsibility of an estate manager to detect what is causing these performance issues and rectify the situation immediately.

=== Combating Griefers ===
Griefers are a common occurrence in Second Life, and they can wreak havoc on an island should they choose to do so. An essential responsibility of an estate manager is to identify, and remove, griefers that may be attacking the island(s) they manage, whether it is a particular parcel of land, or the island as a whole.

== Abilities ==
As abilities for estate managers are assigned by the estate owner, they vary from position to position. Many of these abilities are described below, but may not be available to all estate managers. Each of these abilities apply to the estate as a whole, and '''every parcel''' on the estate (island) is affected when enabling/disabling these options...
*'''Kick User''' - Ejects a user from the estate
*'''Ban User''' - Bans a user from the estate. The user is ejected and banned, and should the user try to return to any parcel on the estate, they will be denied access
*'''Send Message''' - Sends a message to the entire estate, which will cause all users currently on the island to receive the message in a blue popup window in the upper right corner of their screen
*'''Public Access''' - Toggles whether or not avatars which do not own parcels on the estate are allowed to teleport to the island
*'''Allow Voice Chat''' - Toggles whether or not parcel owners have the ability to enable voice chat on their parcels
*'''Deny Access On Payment Status''' - Allows the estate manager to restrict access to the island to those who meet certain payment status requirements, such as "payment information on file", or "payment information used", etc
*'''Block Terraform''' - Prevents parcel owners from being able to terraform the parcels that they occupy
*'''Block Fly''' - Prevents all visitors and parcel owners from being able to fly; overrides any individual parcel settings when disabled
*'''Allow Damage''' - Toggles the whether or not damage can be inflicted on avatars either visiting or occupying parcels on the island. Individual parcels may override this setting
*'''Restrict Pushing''' - Toggles whether or not physical objects have the ability to "push", or move, avatars on the island; overrides any individual parcel settings when disabled
*'''Allow Land Resell''' - Toggles whether or not parcel owners have the ability to place their individual parcels for sale to others
*'''Allow Parcel Join/Divide''' - Toggles whether or not parcel owners have the ability to join two or more parcels they own into one, or to split a parcel into multiple separate parcels
*'''Agent Limit''' - Allows the estate manager to set the number of agents (avatars) that are allowed to be on the island simultaneously. If the agent limit has been reached, avatars will not be permitted to teleport to the island
*'''Teleport Home''' - Allows the estate manager to teleport an avatar that is presently on the island back to their Home Location
*'''Disable Scripts''' - Disables all running scripts on the island. If a script is causing issues, but cannot be reached to be disabled, disabling all scripts will allow the estate manager to get to the object containing the script which is causing the issue and return it to its owner, then re-enable all running scripts on the island
*'''Disable Collisions''' - Prevents objects from colliding into one another, which is often a cause of lag on the island
*'''Disable Physics''' - Allows Physical Objects to be disabled. Griefers typically use an abundance of physical objects to slow island performance, as having many physical objects present causes the server on which the island resides to become very bogged down with commands to process, causing severe lag to the point where avatars on the island cannot even move
*'''Return Scripted Objects''' - Returns all scripted objects owned by a specified user from an island
*'''Get Top Colliders''' - Lists all of the colliding objects on the island which may be causing severe lag. Each object has an associated "collision score"; the higher this number, the more likely the object is to cause lag
*'''Get Top Scripts''' - Lists all of the scripts on the island which may be causing lag. Each script has an associated "time" in milliseconds; the higher this time, the more lag the script creates
*'''Restart Region''' - Allows the estate manager to restart the computer on which the island resides, thus rectifying performance issues. This is what is done to each island when Linden Lab performs their "rolling restarts", and all avatars on the island will receive a warning that the region is being restarted and that they will be logged out if they are present during the restart. The typical restart takes the island offline for 5 minutes or less.
*'''Terrain Edit Limits''' - Allows the estate manager to set limits as to how far up or down terrain on the island can be adjusted by parcel owners, in meters. The "Block Terraform" setting explained above must not be checked in order for this setting to have an effect
*'''Water Height''' - Sets the water height for the entire island
*'''Covenant''' - Allows the estate manager to edit the island's established covenant, if permitted by the estate owner.

Game control

Maestro Linden — Fri, 28 Jun 2024 21:23:32 GMT

Maestro Linden: Try to clarify default alignment of axes

{{LSL_Event|event_id=40|event_delay|event=game_control
|p1_type=key|p1_name=id|p1_desc=avatar UUID
|p2_type=integer|p2_name=button_levels|p2_desc=bitfield of buttons held down
|p3_type=list|p3_name=axes|p3_desc=list of axes float values in range [-1, 1]
|event_desc='''Experimental''' event only available in some testing regions (soon). Triggered when compatible viewer sends fresh '''GameControlInput''' message, but only for scripts on attachments or seat.
|constants={{LSL Constants/GameControlButtonFlags}} {{LSL Constants/GameControlAxisIndices}}
|spec={{LSL Warnings/Game Control}}
|caveats=* If enabled at the client: unhandled keystrokes will be treated as button presses.
* There is room for 32 buttons [bits 0 through 31] however at most only 16 buttons can be simultaneously held down at any one time.
* There are always 6 '''axes''' values, even when the controller device has more or less
** All '''axes''' elements will be in range [-1,1] except for '''GAME_CONTROL_AXIS_TRIGGERLEFT''' and '''GAME_CONTROL_AXIS_TRIGGERRIGHT''' which range [0, 1]
** By default,
*** Left-tilting a thumbstick on '''GAME_CONTROL_AXIS_LEFTX''' or '''GAME_CONTROL_AXIS_RIGHTX''' yields a positive value, while right-tilting yields a negative value
*** Up-tilting a thumbstick on '''GAME_CONTROL_AXIS_LEFTY''' or '''GAME_CONTROL_AXIS_RIGHTY''' yields a positive value, while down-tilting yields a negative value
*** Pulling a trigger will increase the value of '''GAME_CONTROL_AXIS_TRIGGERLEFT''' or '''GAME_CONTROL_AXIS_TRIGGERRIGHT''', while releasing will decrease the value
|examples=
<syntaxhighlight lang="lsl2">
integer prev_button_levels = 0;
integer print_list(string name, integer type, list data)
{
integer data_length = llGetListLength(data);
string text = name + " : ";
if (data_length > 0)
{
integer use_comma = FALSE;
integer i = 0;
for (i = 0; i < data_length; i++)
{
if (!use_comma)
{
use_comma = TRUE;
}
else
{
text += ",";
}
if (type == TYPE_INTEGER)
{
integer b = (llList2Integer(data, i));
text += (string)(b);
llOwnerSay("pack i=" + (string)(i) + " b=" + (string)(b));
}
else if (type == TYPE_FLOAT)
{
text += (string)(llList2Float(data, i));
}
}
}
llOwnerSay(text);
return data_length;
}

string bits2nybbles(integer bits)
{
integer lsn; // least significant nybble
string nybbles = "";
do
nybbles = llGetSubString("0123456789ABCDEF", lsn = (bits & 0xF), lsn) + nybbles;
while (bits = (0xfffFFFF & (bits >> 4)));
return nybbles;
}

default
{
state_entry()
{
llOwnerSay("Ready for game_control events");
}

game_control(key id, integer button_levels, list axes)
{
integer button_edges = button_levels ^ prev_button_levels;
prev_button_levels = button_levels;

string button_levels_hex = bits2nybbles(button_levels);
string button_edges_hex = bits2nybbles(button_edges);
llOwnerSay("game_control :");
llOwnerSay(" button_levels=0x" + button_levels_hex);
llOwnerSay(" button_edges=0x" + button_edges_hex);
print_list(" axes", TYPE_FLOAT, axes);
}
}
</syntaxhighlight>
|helpers
|also_header
|also_events={{LSL DefineRow||[[control]]|}}
|also_functions
|also_articles=[[LSL Game Control Beta]]
|also_footer
|notes
|mode
|deprecated
|cat1=Controls
}}

PRIM REFLECTION PROBE MIRROR

Maestro Linden — Mon, 22 Apr 2024 22:15:48 GMT

Maestro Linden:

{{LSL Constant
|type=integer
|name=PRIM_REFLECTION_PROBE_MIRROR
|value=4
|desc=Used with [[PRIM_REFLECTION_PROBE]]. When enabled, objects with low-roughness PBR materials objects act as a mirror. Note that mirrors do not reflect avatars unless [[PRIM_REFLECTION_PROBE_DYNAMIC]] is also set. Rendering mirrors has a performance cost.
|examples
|constants
|functions
|events
|location
|cat1=Prim
|cat2=ReflectionProbe
|cat3
|cat4
}}

[[Category:glTF]]

PRIM REFLECTION PROBE MIRROR

Maestro Linden — Mon, 22 Apr 2024 22:15:36 GMT

Maestro Linden: initial version

{{LSL Constant
|type=integer
|name=PRIM_REFLECTION_PROBE_MIRROR
|value=2
|desc=Used with [[PRIM_REFLECTION_PROBE]]. When enabled, objects with low-roughness PBR materials objects act as a mirror. Note that mirrors do not reflect avatars unless [[PRIM_REFLECTION_PROBE_DYNAMIC]] is also set. Rendering mirrors has a performance cost.
|examples
|constants
|functions
|events
|location
|cat1=Prim
|cat2=ReflectionProbe
|cat3
|cat4
}}

[[Category:glTF]]

PRIM REFLECTION PROBE

Maestro Linden — Mon, 22 Apr 2024 22:11:33 GMT

Maestro Linden: Add PRIM_REFLECTION_PROBE_MIRROR flag

<onlyinclude>{{#if:
{{LSL_Function/boolean|boolean}}
{{#vardefine:reflection_probe_const|{{LSL Const|PRIM_REFLECTION_PROBE|integer|44|c=Used to {{GetSet|{{{1|}}}|get|set|/}} the prim's reflection probe configuration}}}}
{{#vardefine:p_ambiance_desc|Ranges from 0.0 to 100.0. Is the brightness of lighting effects from the probe, but not reflection effects. If the environment settings has nonzero reflection probe ambiance, the effective probe ambiance is the greater of the two. }}
{{#vardefine:p_clip_distance_desc|Ranges from 0.0 to 1024.0. Is the minimum distance from the probe's center where the surroundings are included for imaging.}}
{{#vardefine:p_flags_desc|PRIM_REFLECTION_PROBE_* flags}}
}}
{{#vardefine:reflection_probe_flags_rows|
!{{!}} {{LSLPT|pstype|type}} Flags
! title="value" {{!}} V
! colspan="3" {{!}} Description
! colspan="3" {{!}} Notes
{{!}}-
{{!}} {{LSL Const|PRIM_REFLECTION_PROBE_BOX|integer|1|c=Determines if the reflection probe is a box or a sphere.}}
{{!}} {{#var:value}}
{{!}} colspan="3" {{!}} {{#var:comment}}
{{!}} colspan="3" {{!}} Unset by default (probe is a sphere)
{{!}}-
{{!}} {{LSL Const|PRIM_REFLECTION_PROBE_DYNAMIC|integer|2|c=Determines if avatars are included by the probe for imaging.}}
{{!}} {{#var:value}}
{{!}} colspan="3" {{!}} {{#var:comment}}
{{!}} colspan="3" {{!}} Unset by default (probe does not image avatars). Imaging avatars in probes has a performance cost.
{{!}}-
{{!}} {{LSL Const|PRIM_REFLECTION_PROBE_MIRROR|integer|4|c=Determines if objects intersecting the probe act as a mirror.}}
{{!}} {{#var:value}}
{{!}} colspan="3" {{!}} {{#var:comment}}
{{!}} colspan="3" {{!}} Unset by default (probe does not act as a mirror). Rendering mirrors has a performance cost.
}}
</onlyinclude>
{{LSL Constant
|inject-2={{LSL PrimitiveParam Categorize|Prim}}
|name=PRIM_REFLECTION_PROBE
|type=integer
|value=44
|desc=PRIM_REFLECTION_PROBE is used to change the reflection probe configuration of the prim.

A reflection probe is a volume used for image-based lighting (IBL). It takes an image of its surroundings and uses it as the basis for reflection effects (shiny surfaces) and ambiance effects (light bouncing).

Typically, the viewer automatically places reflection probes. Prim-based probes enable artists to provide hints to the render engine to improve the quality of image based lighting. Only objects in the probe's influence volume are affected.

Lighting is most accurate when the edges of a probe volume are near the geometry that appears in reflections. For example, objects inside a room with a box shaped reflection probe that hugs the walls, floor, and ceiling would show accurate reflections and ambient lighting from the walls of the room.
|pa={{LSL Constant/List|i_front=[ {{#var:reflection_probe_const}}, |i_end= ]
|text=When used with [[llSetPrimitiveParams]] & [[llSetLinkPrimitiveParams]] & [[llSetLinkPrimitiveParamsFast]]
|toc=llSetPrimitiveParams
|i1_type=integer|i1_subtype=boolean|i1_name=boolean
|i2_type=float|i2_name=ambiance
|i3_type=float|i3_name=clip_distance
|i4_type=integer|i4_name=flags
|pc=
{{{!}} class="sortable" {{Prettytable|style=margin-top:0;}}
{{!}}- {{Hl2}}
{{#var:reflection_probe_flags_rows}}
{{!}}}
}}
|pb={{LSL Constant/List|i_front=[[llGetPrimitiveParams]]([ {{#var:reflection_probe_const}}|i_end= ]);|
|r_front=Returns the list [ |r_end= ]
|text
|toc=llGetPrimitiveParams
|r1_type=integer|r1_subtype=boolean|r1_name=boolean
|r2_type=float|r2_name=ambiance
|r3_type=float|r3_name=clip_distance
|r4_type=integer|r4_name=flags
}}
|pc=
{{{!}} class="sortable" {{Prettytable|style=margin-top:0;}}
{{!}}- {{Hl2}}
{{#var:reflection_probe_flags_rows}}
{{!}}}
|examples=
Increase the prim's reflection probe ambiance when an agent is detected in the sensor range of the prim. Decrease the probe ambiance when an agent is no longer detected.
<syntaxhighlight lang="lsl2">
integer probe_enabled = TRUE;
float probe_no_agent_ambiance = 0.0;
float probe_agent_ambiance = 1.0;
float probe_clip_distance = 0.0;
integer probe_flags = 0;

default
{
state_entry()
{
integer sensor_type = AGENT;
float sensor_range = 3.0;
float sensor_rate = 5.0;
llSensorRepeat("", "", sensor_type, sensor_range, PI, sensor_rate);
}

sensor(integer num_detected)
{
llSetPrimitiveParams([PRIM_REFLECTION_PROBE, probe_enabled, probe_agent_ambiance, probe_clip_distance, probe_flags]);
}

no_sensor()
{
llSetPrimitiveParams([PRIM_REFLECTION_PROBE, probe_enabled, probe_no_agent_ambiance, probe_clip_distance, probe_flags]);
}
}

</syntaxhighlight>
|constants
|caveats=
* A viewer must have reflections enabled to see the effects of reflection probes.
* By default, the viewer auto-places reflection probes with 0.0 ambiance. Environment settings for the region or parcel can be adjusted to increase reflection probe ambiance for these auto-placed probes.
* Automatically-placed reflection probes do not image avatars. Imaging avatars in probes has a performance cost.
|functions=
{{LSL DefineRow||[[LlSetEnvironment]]|}}
{{LSL DefineRow||[[LlReplaceEnvironment]]|}}
{{LSL DefineRow||[[llSetPrimitiveParams]]|}}
{{LSL DefineRow||[[llSetLinkPrimitiveParams]]|}}
{{LSL DefineRow||[[llSetLinkPrimitiveParamsFast]]|}}
{{LSL DefineRow||[[llGetPrimitiveParams]]|}}
{{LSL DefineRow||[[llGetLinkPrimitiveParams]]|}}
|events
|location
|cat1=ReflectionProbe
|cat2
|cat3
|cat4
}}

[[Category:glTF]]

PRIM RENDER MATERIAL

Maestro Linden — Sat, 13 Apr 2024 00:00:43 GMT

Maestro Linden: fixed reference to INVENTORY_MATERIAL constant in examples

[[Category:glTF]]

<onlyinclude>{{#if:

{{#vardefine:render_material_return|an empty list.}}

{{#vardefine:render_material_const|{{LSL Const|PRIM_RENDER_MATERIAL|integer|49|c=Used to {{GetSet|{{{1|}}}|get|set|/}} the material settings of a prim's face}}}}

{{LSL_Function/inventory|render_material|uuid=true|type=material|no_caveat={{#ifeq:{{{1|}}}|get|true|<noinclude>*</noinclude>}}|full={{{remote|}}}|remote={{#ifeq:{{{1|set}}}|get|*}}|target=PRIM_RENDER_MATERIAL#Target}}

{{#ifeq:{{{1|}}}|none||

{{#vardefine:facetable|{{#var:facetable}}
{{!}}-
{{!}} [ {{#var:render_material_const}} ]
{{!}} {{#var:render_material_return}} }}

{{#vardefine:caveats_set|
* If {{LSLP|render_material}} is provided as [[NULL_KEY]], the [[PBR_Materials|glTF Material]] is removed from {{LSLP|face}}, reverting back to any underlying [[PBR_Materials#Nomenclature_changes|Blinn-Phong]] materials.
}}

{{#vardefine:caveats_get|
* With {{LSLP|render_material}} as with [[llGetRenderMaterial]], {{LSL Constant/NULL KEY}} is returned when the {{LSLGC|Owner|owner}} does not have {{LSLGC|Permissions/Asset|full permissions}} to the object and the [[PRIM_RENDER_MATERIAL|material]] is not in the prim's inventory.}}

{{#ifeq:{{{1|}}}|get|

{{#vardefine:caveats|{{#var:caveats}}
{{#var:caveats_get}}
}}

|

{{Issues/SVC-914}}
{{#vardefine:caveats|{{#var:caveats}}
{{#var:caveats_set}}
}}

}}

<noinclude>
{{:PRIM TEXGEN|{{{1|}}}}}
</noinclude>

}}

{{#vardefine:caveats|{{#var:caveats}}
{{#var:shared_caveat}}}}

}}</onlyinclude>{{#if:

{{#vardefine:caveats_set|{{#var:caveats}}{{#vardefine:caveats|}}}}
{{#vardefine:issues_set|{{#var:issues}}{{#vardefine:issues|}}}}

{{LSL_Function/face|face|{{#var:render_material_const}}|!footer=*|return={{#var:render_material_return}}}}

{{#vardefine:caveats_get|{{#var:caveats}}{{#vardefine:caveats|}}
{{#var:caveats_get}}
{{#var:shared_caveat}}}}
{{#vardefine:issues_get|{{#var:issues}}{{#vardefine:issues|}}}}

}}{{LSL Constant
|inject-2={{LSL PrimitiveParam Categorize|Face}}
|name=PRIM_RENDER_MATERIAL
|type=integer
|value=49
|desc=Used to get or set the material settings of a prim's {{LSLP|face}}.
|examples=
|pa={{LSL Constant/List|i_front=[ {{#var:render_material_const}}, |i_end= ]|
|inject-1={{#vardefine:p_render_material_desc|}}
{{#vardefine:p_render_material_hover|}}
{{#vardefine:direction|_set}}
{{LSL_Function/inventory|render_material|uuid=true|type=material}}
|text=Used with [[llSetPrimitiveParams]] & [[llSetLinkPrimitiveParams]].

{{LSL Generic/Caveats|caveats={{#var:caveats_set}}{{#vardefine:caveats_set}}|issues={{#var:issues_set}}|title=*|h=4}}

====Examples====
<syntaxhighlight lang="lsl2">llSetPrimitiveParams([ PRIM_RENDER_MATERIAL, ALL_SIDES, my_render_material ]);
llSetPrimitiveParams([ PRIM_RENDER_MATERIAL, ALL_SIDES, llGetInventoryName(INVENTORY_MATERIAL, 0) ]);
llSetPrimitiveParams([ PRIM_RENDER_MATERIAL, 0, my_render_material ]);</syntaxhighlight>

|toc=llSetPrimitiveParams
|i1_type=integer|i1_name=face
|i2_type=string|i2_name=render_material
}}
|pb={{LSL Constant/List|i_front=[[llGetPrimitiveParams]]([ {{#var:render_material_const}}, |i_end= ]);|
|inject-1={{#vardefine:p_render_material_desc|}}
{{#vardefine:p_render_material_hover|}}
{{#vardefine:direction|_get}}
{{LSL_Function/inventory|render_material|uuid=true|type=material|no_caveat=true|full={{{remote|}}}|remote=*|target=#Target}}
{{LSL Function/link|link|nogroup=*|nocaveats=*}}
|r_front=Returns the list [ |r_end= ]
|text=
{{LSL Generic/Caveats|caveats={{#var:caveats_get}}{{#vardefine:caveats_get}}|issues={{#var:issues_get}}|title=*|h=4}}
====Target====
In the case of llGetPrimitiveParams is either the prim the script resides in, or the prim specified by the immediately prior [[PRIM_LINK_TARGET]] call. However in the case of llGetLinkPrimitiveParams, it is either the value of the {{LSLP|link}} parameter, or the prim specified by the immediately prior [[PRIM_LINK_TARGET]] call.
|toc=llGetPrimitiveParams
|i1_type=integer|i1_name=face
|r1_type=string|r1_name=render_material
}}
|constants=
{{LSL DefineRow||[[CHANGED_RENDER_MATERIAL]]|}}
|functions=
{{LSL DefineRow||[[llSetPrimitiveParams]]|}}
{{LSL DefineRow||[[llSetLinkPrimitiveParams]]|}}
{{LSL DefineRow||[[llGetPrimitiveParams]]|}}
{{LSL DefineRow||[[llSetRenderMaterial]]|}}
{{LSL DefineRow||[[llSetLinkRenderMaterial]]|}}
|events=
{{LSL DefineRow||[[changed]]|}}
|location
|notes
|cat1=RenderMaterial
|cat2
|cat3
|cat4
}}

PRIM REFLECTION PROBE DYNAMIC

Maestro Linden — Thu, 04 Apr 2024 19:35:17 GMT

Maestro Linden: Remove future feature warning

{{LSL Constant
|type=integer
|name=PRIM_REFLECTION_PROBE_DYNAMIC
|value=2
|desc=Used with [[PRIM_REFLECTION_PROBE]]. A reflection probe does not image avatars by default, otherwise it images avatars if this flag is set on the corresponding prim. Imaging avatars in reflection probes has a performance cost.
|examples
|constants
|functions
|events
|location
|cat1=Prim
|cat2=ReflectionProbe
|cat3
|cat4
}}

[[Category:glTF]]

PRIM REFLECTION PROBE BOX

Maestro Linden — Thu, 04 Apr 2024 19:34:53 GMT

Maestro Linden: Remove future feature warning

{{LSL Constant
|type=integer
|name=PRIM_REFLECTION_PROBE_BOX
|value=1
|desc=Used with [[PRIM_REFLECTION_PROBE]]. A reflection probe is a sphere by default, otherwise a box if this flag is set on the corresponding prim.
|examples
|constants
|functions
|events
|location
|cat1=Prim
|cat2=ReflectionProbe
|cat3
|cat4
}}

[[Category:glTF]]

PRIM REFLECTION PROBE

Maestro Linden — Thu, 04 Apr 2024 19:34:28 GMT

Maestro Linden: Remove warning about the feature being experimental

<onlyinclude>{{#if:
{{LSL_Function/boolean|boolean}}
{{#vardefine:reflection_probe_const|{{LSL Const|PRIM_REFLECTION_PROBE|integer|44|c=Used to {{GetSet|{{{1|}}}|get|set|/}} the prim's reflection probe configuration}}}}
{{#vardefine:p_ambiance_desc|Ranges from 0.0 to 100.0. Is the brightness of lighting effects from the probe, but not reflection effects. If the environment settings has nonzero reflection probe ambiance, the effective probe ambiance is the greater of the two. }}
{{#vardefine:p_clip_distance_desc|Ranges from 0.0 to 1024.0. Is the minimum distance from the probe's center where the surroundings are included for imaging.}}
{{#vardefine:p_flags_desc|PRIM_REFLECTION_PROBE_* flags}}
}}
{{#vardefine:reflection_probe_flags_rows|
!{{!}} {{LSLPT|pstype|type}} Flags
! title="value" {{!}} V
! colspan="3" {{!}} Description
! colspan="3" {{!}} Notes
{{!}}-
{{!}} {{LSL Const|PRIM_REFLECTION_PROBE_BOX|integer|1|c=Determines if the reflection probe is a box or a sphere.}}
{{!}} {{#var:value}}
{{!}} colspan="3" {{!}} {{#var:comment}}
{{!}} colspan="3" {{!}} Unset by default (probe is a sphere)
{{!}}-
{{!}} {{LSL Const|PRIM_REFLECTION_PROBE_DYNAMIC|integer|2|c=Determines if avatars are included by the probe for imaging.}}
{{!}} {{#var:value}}
{{!}} colspan="3" {{!}} {{#var:comment}}
{{!}} colspan="3" {{!}} Unset by default (probe does not image avatars). Imaging avatars in probes has a performance cost.
}}
</onlyinclude>
{{LSL Constant
|inject-2={{LSL PrimitiveParam Categorize|Prim}}
|name=PRIM_REFLECTION_PROBE
|type=integer
|value=44
|desc=PRIM_REFLECTION_PROBE is used to change the reflection probe configuration of the prim.

A reflection probe is a volume used for image-based lighting (IBL). It takes an image of its surroundings and uses it as the basis for reflection effects (shiny surfaces) and ambiance effects (light bouncing).

Typically, the viewer automatically places reflection probes. Prim-based probes enable artists to provide hints to the render engine to improve the quality of image based lighting. Only objects in the probe's influence volume are affected.

Lighting is most accurate when the edges of a probe volume are near the geometry that appears in reflections. For example, objects inside a room with a box shaped reflection probe that hugs the walls, floor, and ceiling would show accurate reflections and ambient lighting from the walls of the room.
|pa={{LSL Constant/List|i_front=[ {{#var:reflection_probe_const}}, |i_end= ]
|text=When used with [[llSetPrimitiveParams]] & [[llSetLinkPrimitiveParams]] & [[llSetLinkPrimitiveParamsFast]]
|toc=llSetPrimitiveParams
|i1_type=integer|i1_subtype=boolean|i1_name=boolean
|i2_type=float|i2_name=ambiance
|i3_type=float|i3_name=clip_distance
|i4_type=integer|i4_name=flags
|pc=
{{{!}} class="sortable" {{Prettytable|style=margin-top:0;}}
{{!}}- {{Hl2}}
{{#var:reflection_probe_flags_rows}}
{{!}}}
}}
|pb={{LSL Constant/List|i_front=[[llGetPrimitiveParams]]([ {{#var:reflection_probe_const}}|i_end= ]);|
|r_front=Returns the list [ |r_end= ]
|text
|toc=llGetPrimitiveParams
|r1_type=integer|r1_subtype=boolean|r1_name=boolean
|r2_type=float|r2_name=ambiance
|r3_type=float|r3_name=clip_distance
|r4_type=integer|r4_name=flags
}}
|pc=
{{{!}} class="sortable" {{Prettytable|style=margin-top:0;}}
{{!}}- {{Hl2}}
{{#var:reflection_probe_flags_rows}}
{{!}}}
|examples=
Increase the prim's reflection probe ambiance when an agent is detected in the sensor range of the prim. Decrease the probe ambiance when an agent is no longer detected.
<syntaxhighlight lang="lsl2">
integer probe_enabled = TRUE;
float probe_no_agent_ambiance = 0.0;
float probe_agent_ambiance = 1.0;
float probe_clip_distance = 0.0;
integer probe_flags = 0;

default
{
state_entry()
{
integer sensor_type = AGENT;
float sensor_range = 3.0;
float sensor_rate = 5.0;
llSensorRepeat("", "", sensor_type, sensor_range, PI, sensor_rate);
}

sensor(integer num_detected)
{
llSetPrimitiveParams([PRIM_REFLECTION_PROBE, probe_enabled, probe_agent_ambiance, probe_clip_distance, probe_flags]);
}

no_sensor()
{
llSetPrimitiveParams([PRIM_REFLECTION_PROBE, probe_enabled, probe_no_agent_ambiance, probe_clip_distance, probe_flags]);
}
}

</syntaxhighlight>
|constants
|caveats=
* A viewer must have reflections enabled to see the effects of reflection probes.
* By default, the viewer auto-places reflection probes with 0.0 ambiance. Environment settings for the region or parcel can be adjusted to increase reflection probe ambiance for these auto-placed probes.
* Automatically-placed reflection probes do not image avatars. Imaging avatars in probes has a performance cost.
|functions=
{{LSL DefineRow||[[LlSetEnvironment]]|}}
{{LSL DefineRow||[[LlReplaceEnvironment]]|}}
{{LSL DefineRow||[[llSetPrimitiveParams]]|}}
{{LSL DefineRow||[[llSetLinkPrimitiveParams]]|}}
{{LSL DefineRow||[[llSetLinkPrimitiveParamsFast]]|}}
{{LSL DefineRow||[[llGetPrimitiveParams]]|}}
{{LSL DefineRow||[[llGetLinkPrimitiveParams]]|}}
|events
|location
|cat1=ReflectionProbe
|cat2
|cat3
|cat4
}}

[[Category:glTF]]

LlReplaceEnvironment

Maestro Linden — Wed, 27 Mar 2024 18:41:39 GMT

Maestro Linden: Clarify that modifying a group parcel requires the script to be group-owned or for the owner to have the appropriate ability and be present in the sim.

{{LSL_Function
|func=llReplaceEnvironment
|func_desc=The llReplaceEnvironment function replaces the environment in a parcel or a region. Either for a single elevation track or the entire environment. The owner of the script must have permission to edit the environment on the destination parcel, or be an estate manage in the case of an entire region.
In most cases errors are reported as a return value from the function (see table below). However, issues with the environment assets may be reported in the debug chat.
|return_type=Integer
|p1_type=vector|p1_name=position|p1_desc=The position in the region of the parcel that will receive the new environment. To change the entire region use <-1, -1, -1>. The z component of the vector is ignored.
|p2_type=string|p2_name=environment|p2_desc=The name of an environmental setting in the object's inventory or the asset ID for an environment. NULL_KEY or empty string to remove the environment.
|p3_type=integer|p3_name=track_no|p3_desc=The elevation zone to change. 0 for water, 1 for ground level, 2 for sky 1000m, 3 for sky 2000m, 4 for sky 3000m. -1 to change all tracks.
|p4_type=integer|p4_name=day_length|p4_desc=The length in seconds for the day cycle. -1 to leave unchanged.
|p5_type=integer|p5_name=day_offset|p5_desc=The offset in seconds from UTC. -1 to leave unchanged.
|constants=
{{{!}} class="sortable" {{Prettytable|style=margin-top:0;}}
{{!}}+ '''Return Values'''
{{!}}-{{Hl2}}
!Value
!Constant
!Description
{{!}}-
{{!}} {{!!}} 1 {{!!}} The parcel or region will attempt to change the applied environment.
{{!}}-
{{!}} ENV_NO_ENVIRONMENT {{!!}} -3 {{!!}} The environment inventory object could not be found.
{{!}}-
{{!}} ENV_THROTTLE {{!!}} -8 {{!!}} The scripts have exceeded the throttle. Wait and retry the request.
{{!}}-
{{!}} ENV_NO_PERMISSIONS{{!!}} -9 {{!!}} The script does not have permission to change the environment at the selected location. <br>OR<br> there was an attempt to remove altitude track 0 or 1 (in this case a message will also be chatted to the debug channel).
{{!}}}
|caveats=
* An environment set locally on the viewer will override any environment set from this function.
* A parameter override set by [[llSetEnvironment]] will be preserved after the environment is replaced by this function. Call [[llSetEnvironment]] with an empty list parameter to clear any straggling overrides.
* The environment specified by this function is applied asynchronously, as the simulator must download the environment asset before applying it. This means that [[llGetEnvironment]] will not immediately reflect the new environment's parameters, although the delay is typically quite small.
* If a UUID is passed as the environment parameter and that UUID does not specify an environment setting or one can not be constructed, the function will return success (1) but will post a message to the debug channel.
* If the parcel is group-owned, the script must either be deeded to the group, or the script owner must have "Modify environment settings and day cycle" group ability '''and''' have an active agent in the sim.
|examples=<source lang="lsl2">
// Will set the entire region to the "Tropicalia" EEP from the Linden inventory when touched.
// It will set all the tracks to the same EEP with 24 hour day and a -8 hour Day Offset.
// The "Tropicalia" must be in the prims inventory with the script.
//
// Limited to Estate Managers or Region owners.
// Madi Perth - 4/17/2023

default
{

touch_start(integer total_number)
{
llReplaceEnvironment(<-1, -1, -1>, "Tropicalia", -1, 86400, (86400-28800));
}
}
</source>
|helpers
|also_functions={{LSL DefineRow||[[llSetAgentEnvironment]]|}}
{{LSL DefineRow||[[llGetEnvironment]]|}}
{{LSL DefineRow||[[llSetEnvironment]]|}}
|notes
|history = Date of Release [https://releasenotes.secondlife.com/simulator/2022-08-12.574216.html 12/08/2022]
}}

LlSetEnvironment

Maestro Linden — Wed, 27 Mar 2024 18:41:24 GMT

Maestro Linden: Clarify that modifying a group parcel requires the script to be group-owned or for the owner to have the appropriate ability and be present in the sim.

{{LSL_Function
|func=llSetEnvironment
|func_desc=This function overrides the environmental settings for a region or a parcel. The owner of the script must have permission to modify the environment on the parcel or be an estate manager to change the entire region.

An override for a given parameter can be set at the region scope or parcel scope. It can also be set for a single sky track, all sky tracks, or both. If an override of a given parameter is specified for both an individual track and all tracks, the individual track's override takes priority.

Note that the list of valid parameters differs from those available for [[llGetEnvironment]].
|return_type=Integer
|p1_type= vector|p1_name= position|p1_desc= The location on the region of the parcel to be changed. Use <-1, -1, z> for the entire region. The z-component specifies which sky track to change, based on elevation. Use z=-1 to set an override on the special 'all tracks' slot.
|p2_type= list|p2_name= params|p2_desc= A list of parameters to change for the parcel or region. Passing an empty list will remove any modifications from previous calls to llSetEnvironment.
|constants=
{{{!}} class="sortable" {{Prettytable|style=margin-top:0;}}
{{!}}+ '''Return Values'''
{{!}}-{{Hl2}}
!Value
!Constant
!Description
{{!}}-
{{!}} {{!!}} 1 {{!!}} The parcel or region will attempt to change the applied environment.
{{!}}-
{{!}} ENV_NO_ENVIRONMENT {{!!}} -3 {{!!}} There is no environment on this parcel to modify.
{{!}}-
{{!}} ENV_INVALID_RULE {{!!}} -5 {{!!}} There was an issue with one of the rules.
{{!}}-
{{!}} ENV_VALIDATION_FAIL {{!!}} -6 {{!!}} Unable to validate values passed.
{{!}}-
{{!}} ENV_THROTTLE {{!!}} -8 {{!!}} The scripts have exceeded the throttle. Wait and retry the request.
{{!}}-
{{!}} ENV_NO_PERMISSIONS {{!!}} -9 {{!!}} The script does not have rights to modify this parcel or region.
{{!}}}

{{:LSL Constants/llSetEnvironment}}

|caveats=
* An environment set locally on the viewer will override any environment set from this function.
* When changing a parcel's environment it must first have had an environment set.
* If the parcel is group-owned, the script must either be deeded to the group, or the script owner must have "Modify environment settings and day cycle" group ability '''and''' have an active agent in the sim.
|examples=
|helpers
|also_functions={{LSL DefineRow||[[llReplaceAgentEnvironment]]|}}
{{LSL DefineRow||[[llGetEnvironment]]|}}
|notes
|history = Date of Release [https://releasenotes.secondlife.com/simulator/2022-08-12.574216.html 12/08/2022]
}}

LlSetLinkSitFlags

Maestro Linden — Thu, 14 Mar 2024 20:30:21 GMT

Maestro Linden: Added note that SIT_FLAG_NO_COLLIDE is applied at sit time only.

{{LSL_Function
|inject-2={{LSL Function/link-face|link}}
|func_id=|func_sleep=0.0|func_energy=10.0
|func=llSetLinkSitFlags|return_type=
|p1_type=integer|p1_name=link|p1_desc=The link ID
|p2_type=integer|p2_name=flags|p2_desc=Flags to set
|func_desc=Sets flags on the link's sittarget.
|return_text
|spec=Sets the sit flags for the sit target in the link. Sit flags only apply when a sit target is present in the link.
{{LSL Constants/SitFlags}}
|caveats=
* [[SIT_FLAG_NO_COLLIDE]] is applied at the time of sitting. Updating this flag will not change the collision behavior of an agent that was previously seated on the sit target.
|examples
|helpers
|also_functions
|also
|notes
|cat1=Script
|cat2
|cat3
|cat4
}}

LlSetLinkSitFlags

Maestro Linden — Thu, 14 Mar 2024 18:30:16 GMT

Maestro Linden: Clarify that llSetLinkSitFlags does not fail when there is no sit target present, but that various sit flags simply are not applied in that case (but will be applied if a sit target is added later on)

{{LSL_Function
|inject-2={{LSL Function/link-face|link}}
|func_id=|func_sleep=0.0|func_energy=10.0
|func=llSetLinkSitFlags|return_type=
|p1_type=integer|p1_name=link|p1_desc=The link ID
|p2_type=integer|p2_name=flags|p2_desc=Flags to set
|func_desc=Sets flags on the link's sittarget.
|return_text
|spec=Sets the sit flags for the sit target in the link. Sit flags only apply when a sit target is present in the link.
{{LSL Constants/SitFlags}}
|caveats=
|examples
|helpers
|also_functions
|also
|notes
|cat1=Script
|cat2
|cat3
|cat4
}}

Template:LSL Constants/SitFlags

Maestro Linden — Thu, 14 Mar 2024 18:13:15 GMT

Maestro Linden: Add notes about limitations of SIT_FLAG_ALLOW_UNSIT and SIT_FLAG_SIT_TARGET

<div style="padding: 0.5em;">
{{{!}} class="sortable" {{Prettytable}}
{{!}}- {{Hl2}}
! {{!}} Flag
! title="Value" {{!}}
! class="unsortable" {{!}} Description
{{!}}-
{{!}}{{LSL Const|SIT_FLAG_SIT_TARGET|integer|1|ihex=1|c=Read-only flag to indicate whether the link has a sit target. Use [[llSitTarget]], [[llLinkSitTarget]], or [[PRIM_SIT_TARGET]] to disable or enable this flag.}}
{{!}}{{#var:hvalue}}
{{!}}{{#var:comment}}
{{!}}-
{{!}}{{LSL Const|SIT_FLAG_ALLOW_UNSIT|integer|2|ihex=2|c=Allow an avatar to manually unsit from a sit target. Only applies to agents who had been seated via an LSL script.}}
{{!}}{{#var:hvalue}}
{{!}}{{#var:comment}}
{{!}}-
{{!}}{{LSL Const|SIT_FLAG_SCRIPTED_ONLY|integer|4|ihex=4|c=Only allow scripted sits on this sit target.}}
{{!}}{{#var:hvalue}}
{{!}}{{#var:comment}}
{{!}}-
{{!}}{{LSL Const|SIT_FLAG_NO_COLLIDE|integer|16|ihex=16|c=Disable the avatar's collision volume when they are seated on this sit target.}}
{{!}}{{#var:hvalue}}
{{!}}{{#var:comment}}
{{!}}}
</div></div>

PRIM ALLOW UNSIT

Maestro Linden — Thu, 14 Mar 2024 17:55:10 GMT

Maestro Linden: Clarify that this flag only affects agents who were seated on the object using experience permissions

{{LSL Constant
|name=PRIM_ALLOW_UNSIT
|type=integer
|value= 39
|desc=When set on a prim that is running a script as part of an experience an avatar that is seated on the sit target and has agreed to participate in the experience will be unable to stand or select another prim to sit on. The restriction remains in place until one of the following conditions is met:
* PRIM_ALLOW_UNSIT is changed to TRUE
* llUnSit( ) is called forcing the avatar to stand.
* llSitOnLink( ) is called moving this avatar to a new sit target.
* The avatar teleports or is teleported by the experience.
* The agent signs off.
* The agent disables the experience.
* The prim the avatar is seated on is destroyed.
* The agent is unseated for any reason.

This flag has no effect on agents who had seated manually (i.e. '''not''' via [[llSitOnLink]] using experience permissions).

If the linkset moves to a region that has not enabled the experience this value will be ignored and standing will behave as normal, without restriction. If the linkset moves to a parcel that the avatar does not have access to, the avatar will be forced to stand and the unsit restriction will be removed.

|functions=
{{LSL DefineRow||[[llSetPrimitiveParams]]|}}
{{LSL DefineRow||[[llSetLinkPrimitiveParams]]|}}
{{LSL DefineRow||[[llGetPrimitiveParams]]|}}
{{LSL DefineRow||[[llGetLinkPrimitiveParams]]|}}
|cat1=Experience
|cat2=Permissions/Experience
}}
[[Category:Experience Tools]]

GLTF Overrides

Maestro Linden — Tue, 21 Nov 2023 16:12:23 GMT

Maestro Linden: removed 'terrain' typo

{{hint
|mode=warning
|title_desc=Future feature
|desc=This function will be supported in the upcoming PBR project.</b><br/>Currently it will only work in supported testing areas with a supported test viewer.
}}

[[Category:glTF]]

== What are they? ==

GLTF overrides are an implementation detail of [[PBR_Materials|PBR materials]], which only makes sense when a GLTF material is applied to a face of a prim.

A GLTF override is a collection of changes applied on top of a GLTF material asset, plus texture transforms.

== Texture transforms ==

GLTF texture transforms behave differently than their Blinn-Phong counterparts, and instead follow the [[https://github.com/KhronosGroup/glTF/tree/main/extensions/2.0/Khronos/KHR_texture_transform KHR_texture_transform spec]]. Because of this, [[LlSetTextureAnim|texture animations]] are animated independently of the texture transforms.

== Applying a GLTF material from LSL ==

These prim params affect the GLTF material on a face:

* [[PRIM_RENDER_MATERIAL]]
* [[PRIM_GLTF_BASE_COLOR]]
* [[PRIM_GLTF_NORMAL]]
* [[PRIM_GLTF_METALLIC_ROUGHNESS]]
* [[PRIM_GLTF_EMISSIVE]]

When setting [[PRIM_RENDER_MATERIAL]] on a face, most of the GLTF overrides will be cleared on that face, with the exception of texture transforms (repeats, offsets, and rotation_in_radians).

The rest of these prim params are for GLTF overrides. For example, [[PRIM_GLTF_BASE_COLOR]] includes the GLTF base color property overrides as well as the base color texture transform. Setting nearly any GLTF override to the empty string ("") will unset it, causing the property of the underlying GLTF material asset to be used instead. Currently, setting a texture transform to empty strings ("") will set them to the default value instead.

Note that it is not possible to read properties of the underlying GLTF material asset from scripts. If a property is unset, it will be the empty string ("") when read from a script.

Attempting to set a GLTF override when [[PRIM_RENDER_MATERIAL]] is [[NULL_KEY]] will clear most GLTF overrides on that face, with the exceptions of texture transforms.

== Permissions ==

When a no-mod GLTF material is applied to a prim face, its GLTF overrides cannot be modified, with the exception of texture transforms.

PRIM GLTF EMISSIVE

Maestro Linden — Fri, 27 Oct 2023 18:59:55 GMT

Maestro Linden: Redirected page to GLTF Overrides

#REDIRECT [[GLTF_Overrides]]

PRIM GLTF METALLIC ROUGHNESS

Maestro Linden — Fri, 27 Oct 2023 18:59:49 GMT

Maestro Linden: Redirected page to GLTF Overrides

#REDIRECT [[GLTF_Overrides]]

PRIM GLTF NORMAL

Maestro Linden — Fri, 27 Oct 2023 18:59:42 GMT

Maestro Linden: Redirected page to GLTF Overrides

#REDIRECT [[GLTF_Overrides]]

PRIM GLTF BASE COLOR

Maestro Linden — Fri, 27 Oct 2023 18:59:34 GMT

Maestro Linden: Redirected page to GLTF Overrides

#REDIRECT [[GLTF_Overrides]]

Template:LSL Constants/PrimitiveParams/sculpt types

Maestro Linden — Thu, 26 Oct 2023 17:46:41 GMT

Maestro Linden: Added note that PRIM_SCULPT_FLAG_ANIMESH is read-only

{{#if:{{{table|}}}<noinclude>1</noinclude>|
{{{!}} {{#if:{{{sortable|}}}<noinclude>1</noinclude>|class="sortable"}} {{Prettytable|style={{{style|}}}}}}}
{{!}}- {{#if:{{{table|}}}<noinclude>1</noinclude>|{{Hl2}}}}
! {{#if:{{{sortable|}}}<noinclude>1</noinclude>||colspan="2"}} {{!}} {{LSL Param|type}} Flags
{{#if:{{{sortable|}}}<noinclude>1</noinclude>|! title="Value" {{!}}}}
! class="unsortable" {{!}} Style
! colspan="3" class="unsortable" {{!}} Description
{{!}}-
{{LSL ConstTB|PRIM_SCULPT_TYPE_SPHERE|integer|1}}
{{!!}}Sphere
{{!}} colspan="3" {{!}} Converge top & bottom, stitch left side to right
{{!}}-
{{LSL ConstTB|PRIM_SCULPT_TYPE_TORUS|integer|2}}
{{!!}}Torus
{{!}} colspan="3" {{!}} Stitch top to bottom, stitch left side to right
{{!}}-
{{LSL ConstTB|PRIM_SCULPT_TYPE_PLANE|integer|3}}
{{!!}}Plane
{{!}} colspan="3" {{!}} No stitching or converging
{{!}}-
{{LSL ConstTB|PRIM_SCULPT_TYPE_CYLINDER|integer|4}}
{{!!}}Cylinder
{{!}} colspan="3" {{!}} Stitch left side to right.
{{!}}-
{{LSL ConstTB|PRIM_SCULPT_TYPE_MESH|integer|5}}
{{!!}}[[Mesh]] model
{{!}} colspan="3" {{!}} See: [[Mesh]]
{{!}}- style="background-color: rgba(0, 0, 0, 0.1);"
{{LSL ConstTB|PRIM_SCULPT_FLAG_ZZZZZZZZ|integer|63|s=style="display:none;"}}
{{!}} colspan="6" {{!}}
{{!}}-
{{LSL ConstTB|PRIM_SCULPT_FLAG_ANIMESH|integer|hex=0x20}}
{{!!}}Animesh
{{!}} colspan="3" {{!}} Read-only flag to query [[Animesh_User_Guide|Animated mesh]] status.
{{!}}-
{{LSL ConstTB|PRIM_SCULPT_FLAG_INVERT|integer|hex=0x40}}
{{!!}}Invert
{{!}} colspan="3" {{!}} Render inside out (inverts the normals).
{{!}}-
{{LSL ConstTB|PRIM_SCULPT_FLAG_MIRROR|integer|hex=0x80}}
{{!!}}Mirror
{{!}} colspan="3" {{!}} Render an X axis mirror of the sculpty.
{{!}}-
{{#if:{{{table|}}}<noinclude>1</noinclude>|{{!}}} }}
<noinclude>
{| {{Prettytable}}
{{LSL_Constants/PrimitiveParams/sculpt_types}}
|}
{| class="sortable" {{Prettytable}}
{{LSL_Constants/PrimitiveParams/sculpt_types|sortable=*}}
|}
{{LSL_Constants/PrimitiveParams/sculpt_types|table=*|sortable=*}}
</noinclude>

CLICK ACTION IGNORE

Maestro Linden — Wed, 06 Sep 2023 16:37:10 GMT

Maestro Linden: Create page

{{LSL Constant
|name=CLICK_ACTION_IGNORE
|type=integer
|value=9
|desc
|examples
|functions=
{{LSL DefineRow||[[llSetClickAction]]|}}
{{LSL DefineRow||[[llGetObjectDetails]]|}}
|events
|cat1=Click Action
|cat2
|cat3
|cat4
|self
}}

LlSetClickAction

Maestro Linden — Wed, 06 Sep 2023 16:34:24 GMT

Maestro Linden: Fixed table formatting

{{LSL_Function
|inject-2={{Issues/VWR-640}}{{Issues/VWR-10829}}
|func_id=333|func_sleep=0.0|func_energy=10.0
|func=llSetClickAction
|p1_type=integer|p1_subtype=click_action|p1_name=action|p1_desc=CLICK_ACTION_* flag
|func_desc=Sets the action performed when a prim is clicked upon (aka [[click action]]).
|func_footnote=When the cursor hovers over the prim, its image changes to reflect the action.
|caveats= *When set in the root of an object the chosen CLICK_ACTION_* will be that for the children also even if they have their own [[llSetClickAction]] set (it will be over-ridden). However (in the case of [[touch]] for example) if the CLICK_ACTION_* is set in the root but not at all in the children (including not having [[touch]] [[event]] [[script]]s in them (this creates a default [[CLICK_ACTION_TOUCH]])) the effect of the roots CLICK_ACTION_* is not ''seen'' but the CLICK_ACTION_* is ''used'' on clicking. To both use '''and see''' the correct cursor the CLICK_ACTION_* flags must match in the children and root.
*If [[llSetClickAction]] is [[CLICK_ACTION_PAY]] then you must have a [[money]] event, or it will revert to [[CLICK_ACTION_NONE]].
*While this function works or attached objects (click action can be changed), the configured click action of an attachment is ignored by the viewer (with exceptions). The viewer always* behaves as though an attached object has [[CLICK_ACTION_TOUCH]] set.
*The only exception to the above rule is when the chosen click action is [[CLICK_ACTION_NONE]], which will disable the cursor changing from the standard pointer arrow to the touch pointer.
* [[llSetClickAction]] has to be called '''before''' an avatar clicks on an object. Calling it while an avatar is clicking (click & holding) will cause this function to silently fail. You ''can'' set the click action after an avatar touches an object, but bear in mind that there may be some delay before the given avatar's viewer will update due to ping times, etc.
|examples={{{!}} width="100%" {{Prettytable}}
{{!}}- {{Hl2}}
! '''make sitting easier'''
! '''make unpacking for next owner easier'''
! '''make buying for customers easier'''
{{!}}- valign="bottom"
{{!!}}<syntaxhighlight lang="lsl2">
default
{
state_entry()
{
llSetClickAction(CLICK_ACTION_SIT);
llRemoveInventory(llGetScriptName());
}
}
</syntaxhighlight>
{{!!}}
<syntaxhighlight lang="lsl2">
default
{
state_entry()
{
llSetClickAction(CLICK_ACTION_OPEN);
llRemoveInventory(llGetScriptName());
}
}
</syntaxhighlight>
{{!!}}
<syntaxhighlight lang="lsl2">
// remember you'll have to set a price
// in the general tab of the edit window
// for your object before using this script

default
{
state_entry()
{
llSetClickAction(CLICK_ACTION_BUY);
llRemoveInventory(llGetScriptName());
}
}
</syntaxhighlight>
{{!}}}
<syntaxhighlight lang="lsl2">
// simple tipjar

default
{
state_entry()
{
llSetClickAction(CLICK_ACTION_PAY);

// enabled edit field to put own amount, all quick-pay-buttons hidden
llSetPayPrice(PAY_DEFAULT, [PAY_HIDE, PAY_HIDE, PAY_HIDE, PAY_HIDE]);
}

money(key id, integer amount)
{
string name = llKey2Name(id);

llInstantMessage(id, "Thank you for the tip, " + name + "!");
}
}
</syntaxhighlight>

<syntaxhighlight lang="lsl2">
//Sit Only with Permission

list gAvWhitelist = ["953d10f1-44ce-462a-8bc1-f634333ee031", "599dce91-a2b8-48c5-b96d-54965433022b"];

default
{
state_entry()
{
llSitTarget(<0.0, 0.0, 0.5>, ZERO_ROTATION);
}

changed(integer change)
{
if (change & CHANGED_LINK)
{
list Properties = llGetObjectDetails(llGetKey(), [OBJECT_CLICK_ACTION]);
integer Click = llList2Integer(Properties, 0);
key Av = llAvatarOnSitTarget();
if ((Av != NULL_KEY) && (!Click))
{
llSay(0, "Please click first for permission to sit.");
llUnSit(Av);
}
}
}
touch_start(integer total_number)
{
list Properties = llGetObjectDetails(llGetKey(), [OBJECT_CLICK_ACTION]);
integer Click = llList2Integer(Properties, 0);
if (!Click && (~llListFindList(gAvWhitelist, [(string)llDetectedKey(0)])))
{
llSetClickAction(CLICK_ACTION_SIT);
llSetTimerEvent(10.0);
llSay(0, "Please take a seat.");
}
else
{
llSetClickAction(CLICK_ACTION_TOUCH);
if (llAvatarOnSitTarget() != NULL_KEY)
{
llSay(0, "Good bye!");
}
else
{
llSay(0, "Sorry. You are not allowed to sit here.");
}
llUnSit(llDetectedKey(0));
}
}

timer()
{
llSetTimerEvent(0.0);
llSetClickAction(CLICK_ACTION_TOUCH);
}
}
</syntaxhighlight>

|spec
|constants=<div id="box">
==Constants==
<div style="padding: 0.5em;">
{{{!}} class="sortable" {{Prettytable}}
{{!}}- {{Hl2}}
! {{!}} Flag
! title="Value" {{!}}
! class="unsortable" {{!}} Description
! class="unsortable" {{!}} Cursor
{{!}}-
{{!}}{{LSL Const|CLICK_ACTION_NONE|integer|0|c=Performs the default action: when the prim is touched, touch events are triggered}}
{{!}}{{#var:value}}
{{!}}{{#var:comment}}
{{!}}
{{!}}-
{{!}}{{LSL Const|CLICK_ACTION_TOUCH|integer|0|c=When the prim is touched, touch events are triggered}}
{{!}}{{#var:value}}
{{!}}{{#var:comment}}
{{!}}
{{!}}-
{{!}}{{LSL Const|CLICK_ACTION_SIT|integer|1|c=When the prim is touched, the avatar sits upon it}}
{{!}}{{#var:value}}
{{!}}{{#var:comment}}
{{!}}[[File:SitActionCursor.png‎]]
{{!}}-
{{!}}{{LSL Const|CLICK_ACTION_BUY|integer|2|c=When the prim is touched, the buy dialog is opened}}
{{!}}{{#var:value}}
{{!}}{{#var:comment}}
{{!}}[[File:SaleOneclickCursor.png]]
{{!}}-
{{!}}{{LSL Const|CLICK_ACTION_PAY|integer|3|c=When the prim is touched, the pay dialog is opened}}
{{!}}{{#var:value}}
{{!}}{{#var:comment}}
{{!}}[[File:SaleOneclickCursor.png]]
{{!}}-
{{!}}{{LSL Const|CLICK_ACTION_OPEN|integer|4|c=When the prim is touched, the object inventory dialog is opened}}
{{!}}{{#var:value}}
{{!}}{{#var:comment}}
{{!}}[[File:OpenOneclickCursor.png]]
{{!}}-
{{!}}{{LSL Const|CLICK_ACTION_PLAY|integer|5|c=Play or pause parcel media on touch}}
{{!}}{{#var:value}}
{{!}}{{#var:comment}}
{{!}}[[Image:Toolplay.png]]
{{!}}-
{{!}}{{LSL Const|CLICK_ACTION_OPEN_MEDIA|integer|6|c=Play parcel media on touch, no pause}}
{{!}}{{#var:value}}
{{!}}{{#var:comment}}
{{!}}[[Image:Toolmediaopen.png]]
{{!}}-
{{!}}{{LSL Const|CLICK_ACTION_ZOOM|integer|7|c=Zoom the avatar camera on this object}}
{{!}}{{#var:value}}
{{!}}{{#var:comment}} ([[Viewer_2_Help|Viewer 2]])
{{!}}[[Image:Toolzoom.png]]
{{!}}-
{{!}}{{LSL Const|CLICK_ACTION_DISABLED|integer|8|c=No click action. No touches detected or passed.}}
{{!}}{{#var:value}}
{{!}}{{#var:comment}}
{{!}}
{{!}}-
{{!}}{{LSL Const|CLICK_ACTION_IGNORE|integer|9|c=Clicks go through the object to whatever is behind it. No touches detected.}}
{{!}}{{#var:value}}
{{!}}{{#var:comment}}
{{!}}
{{!}}}
</div></div>
|signature=
{{LSL Const/Signature|CLICK_ACTION_ZOOM|integer|7|c=Zoom}}
|helpers
|also_functions={{LSL DefineRow||[[llPassTouches]]}}
|also_tests
|also_events=
{{LSL DefineRow||[[touch_start]]}}
{{LSL DefineRow||[[touch]]}}
{{LSL DefineRow||[[touch_end]]}}
|also_articles={{LSL DefineRow||{{LSLGC|Detected}}}}
|deepnotes=*When using [[CLICK_ACTION_SIT]], an avatar who clicks the object and sits down and then clicks the object again will fire a [[touch]] event with the second click.
|history=
* Introduced in SL Client 1.19.1(0)
* [[CLICK_ACTION_ZOOM]] added in SL Server 1.32 and [[Viewer_2_Help|Viewer 2]]
|cat1=Prim
|cat2=Touch
|cat3=Sit
|cat4=Money
|cat5=Media
|cat6=Effects
|cat7=Click Action
|cat8
}}

LlSetClickAction

Maestro Linden — Wed, 06 Sep 2023 16:33:14 GMT

Maestro Linden: added CLICK_ACTION_IGNORE description

{{LSL_Function
|inject-2={{Issues/VWR-640}}{{Issues/VWR-10829}}
|func_id=333|func_sleep=0.0|func_energy=10.0
|func=llSetClickAction
|p1_type=integer|p1_subtype=click_action|p1_name=action|p1_desc=CLICK_ACTION_* flag
|func_desc=Sets the action performed when a prim is clicked upon (aka [[click action]]).
|func_footnote=When the cursor hovers over the prim, its image changes to reflect the action.
|caveats= *When set in the root of an object the chosen CLICK_ACTION_* will be that for the children also even if they have their own [[llSetClickAction]] set (it will be over-ridden). However (in the case of [[touch]] for example) if the CLICK_ACTION_* is set in the root but not at all in the children (including not having [[touch]] [[event]] [[script]]s in them (this creates a default [[CLICK_ACTION_TOUCH]])) the effect of the roots CLICK_ACTION_* is not ''seen'' but the CLICK_ACTION_* is ''used'' on clicking. To both use '''and see''' the correct cursor the CLICK_ACTION_* flags must match in the children and root.
*If [[llSetClickAction]] is [[CLICK_ACTION_PAY]] then you must have a [[money]] event, or it will revert to [[CLICK_ACTION_NONE]].
*While this function works or attached objects (click action can be changed), the configured click action of an attachment is ignored by the viewer (with exceptions). The viewer always* behaves as though an attached object has [[CLICK_ACTION_TOUCH]] set.
*The only exception to the above rule is when the chosen click action is [[CLICK_ACTION_NONE]], which will disable the cursor changing from the standard pointer arrow to the touch pointer.
* [[llSetClickAction]] has to be called '''before''' an avatar clicks on an object. Calling it while an avatar is clicking (click & holding) will cause this function to silently fail. You ''can'' set the click action after an avatar touches an object, but bear in mind that there may be some delay before the given avatar's viewer will update due to ping times, etc.
|examples={{{!}} width="100%" {{Prettytable}}
{{!}}- {{Hl2}}
! '''make sitting easier'''
! '''make unpacking for next owner easier'''
! '''make buying for customers easier'''
{{!}}- valign="bottom"
{{!!}}<syntaxhighlight lang="lsl2">
default
{
state_entry()
{
llSetClickAction(CLICK_ACTION_SIT);
llRemoveInventory(llGetScriptName());
}
}
</syntaxhighlight>
{{!!}}
<syntaxhighlight lang="lsl2">
default
{
state_entry()
{
llSetClickAction(CLICK_ACTION_OPEN);
llRemoveInventory(llGetScriptName());
}
}
</syntaxhighlight>
{{!!}}
<syntaxhighlight lang="lsl2">
// remember you'll have to set a price
// in the general tab of the edit window
// for your object before using this script

default
{
state_entry()
{
llSetClickAction(CLICK_ACTION_BUY);
llRemoveInventory(llGetScriptName());
}
}
</syntaxhighlight>
{{!}}}
<syntaxhighlight lang="lsl2">
// simple tipjar

default
{
state_entry()
{
llSetClickAction(CLICK_ACTION_PAY);

// enabled edit field to put own amount, all quick-pay-buttons hidden
llSetPayPrice(PAY_DEFAULT, [PAY_HIDE, PAY_HIDE, PAY_HIDE, PAY_HIDE]);
}

money(key id, integer amount)
{
string name = llKey2Name(id);

llInstantMessage(id, "Thank you for the tip, " + name + "!");
}
}
</syntaxhighlight>

<syntaxhighlight lang="lsl2">
//Sit Only with Permission

list gAvWhitelist = ["953d10f1-44ce-462a-8bc1-f634333ee031", "599dce91-a2b8-48c5-b96d-54965433022b"];

default
{
state_entry()
{
llSitTarget(<0.0, 0.0, 0.5>, ZERO_ROTATION);
}

changed(integer change)
{
if (change & CHANGED_LINK)
{
list Properties = llGetObjectDetails(llGetKey(), [OBJECT_CLICK_ACTION]);
integer Click = llList2Integer(Properties, 0);
key Av = llAvatarOnSitTarget();
if ((Av != NULL_KEY) && (!Click))
{
llSay(0, "Please click first for permission to sit.");
llUnSit(Av);
}
}
}
touch_start(integer total_number)
{
list Properties = llGetObjectDetails(llGetKey(), [OBJECT_CLICK_ACTION]);
integer Click = llList2Integer(Properties, 0);
if (!Click && (~llListFindList(gAvWhitelist, [(string)llDetectedKey(0)])))
{
llSetClickAction(CLICK_ACTION_SIT);
llSetTimerEvent(10.0);
llSay(0, "Please take a seat.");
}
else
{
llSetClickAction(CLICK_ACTION_TOUCH);
if (llAvatarOnSitTarget() != NULL_KEY)
{
llSay(0, "Good bye!");
}
else
{
llSay(0, "Sorry. You are not allowed to sit here.");
}
llUnSit(llDetectedKey(0));
}
}

timer()
{
llSetTimerEvent(0.0);
llSetClickAction(CLICK_ACTION_TOUCH);
}
}
</syntaxhighlight>

|spec
|constants=<div id="box">
==Constants==
<div style="padding: 0.5em;">
{{{!}} class="sortable" {{Prettytable}}
{{!}}- {{Hl2}}
! {{!}} Flag
! title="Value" {{!}}
! class="unsortable" {{!}} Description
! class="unsortable" {{!}} Cursor
{{!}}-
{{!}}{{LSL Const|CLICK_ACTION_NONE|integer|0|c=Performs the default action: when the prim is touched, touch events are triggered}}
{{!}}{{#var:value}}
{{!}}{{#var:comment}}
{{!}}
{{!}}-
{{!}}{{LSL Const|CLICK_ACTION_TOUCH|integer|0|c=When the prim is touched, touch events are triggered}}
{{!}}{{#var:value}}
{{!}}{{#var:comment}}
{{!}}
{{!}}-
{{!}}{{LSL Const|CLICK_ACTION_SIT|integer|1|c=When the prim is touched, the avatar sits upon it}}
{{!}}{{#var:value}}
{{!}}{{#var:comment}}
{{!}}[[File:SitActionCursor.png‎]]
{{!}}-
{{!}}{{LSL Const|CLICK_ACTION_BUY|integer|2|c=When the prim is touched, the buy dialog is opened}}
{{!}}{{#var:value}}
{{!}}{{#var:comment}}
{{!}}[[File:SaleOneclickCursor.png]]
{{!}}-
{{!}}{{LSL Const|CLICK_ACTION_PAY|integer|3|c=When the prim is touched, the pay dialog is opened}}
{{!}}{{#var:value}}
{{!}}{{#var:comment}}
{{!}}[[File:SaleOneclickCursor.png]]
{{!}}-
{{!}}{{LSL Const|CLICK_ACTION_OPEN|integer|4|c=When the prim is touched, the object inventory dialog is opened}}
{{!}}{{#var:value}}
{{!}}{{#var:comment}}
{{!}}[[File:OpenOneclickCursor.png]]
{{!}}-
{{!}}{{LSL Const|CLICK_ACTION_PLAY|integer|5|c=Play or pause parcel media on touch}}
{{!}}{{#var:value}}
{{!}}{{#var:comment}}
{{!}}[[Image:Toolplay.png]]
{{!}}-
{{!}}{{LSL Const|CLICK_ACTION_OPEN_MEDIA|integer|6|c=Play parcel media on touch, no pause}}
{{!}}{{#var:value}}
{{!}}{{#var:comment}}
{{!}}[[Image:Toolmediaopen.png]]
{{!}}-
{{!}}{{LSL Const|CLICK_ACTION_ZOOM|integer|7|c=Zoom the avatar camera on this object}}
{{!}}{{#var:value}}
{{!}}{{#var:comment}} ([[Viewer_2_Help|Viewer 2]])
{{!}}[[Image:Toolzoom.png]]
{{!}}-
{{!}}{{LSL Const|CLICK_ACTION_DISABLED|integer|8|c=No click action. No touches detected or passed.}}
{{!}}{{#var:value}}
{{!}}{{#var:comment}}
{{!}}
{{!}}}
{{!}}-
{{!}}{{LSL Const|CLICK_ACTION_IGNORE|integer|9|c=Clicks go through the object to whatever is behind it. No touches detected.}}
{{!}}{{#var:value}}
{{!}}{{#var:comment}}
{{!}}
{{!}}}
</div></div>
|signature=
{{LSL Const/Signature|CLICK_ACTION_ZOOM|integer|7|c=Zoom}}
|helpers
|also_functions={{LSL DefineRow||[[llPassTouches]]}}
|also_tests
|also_events=
{{LSL DefineRow||[[touch_start]]}}
{{LSL DefineRow||[[touch]]}}
{{LSL DefineRow||[[touch_end]]}}
|also_articles={{LSL DefineRow||{{LSLGC|Detected}}}}
|deepnotes=*When using [[CLICK_ACTION_SIT]], an avatar who clicks the object and sits down and then clicks the object again will fire a [[touch]] event with the second click.
|history=
* Introduced in SL Client 1.19.1(0)
* [[CLICK_ACTION_ZOOM]] added in SL Server 1.32 and [[Viewer_2_Help|Viewer 2]]
|cat1=Prim
|cat2=Touch
|cat3=Sit
|cat4=Money
|cat5=Media
|cat6=Effects
|cat7=Click Action
|cat8
}}

LlGetTimeOfDay

Maestro Linden — Tue, 29 Aug 2023 17:46:54 GMT

Maestro Linden: Made some edits to reflect how this function operates under custom environment settings

{{LSL_Function
|func=llGetTimeOfDay
|func_id=80
|func_sleep=0.0
|func_energy=10.0
|return_type=float
|func_footnote=By default (without custom environment settings), Second Life day cycles are 4 hours long (3 hours of light, 1 hour of dark). The sunrise and sunset time varies slowly.
|func_desc
|return_text=that is the time in seconds with subsecond precision since Second Life midnight (per the parcel-scoped day cycle settings) or region up-time (time since when the region was brought online/rebooted); whichever is smaller. If the parcel is configured so the sun stays in a constant position, then the returned value is the region up-time.
|spec
|caveats
|constants
|examples=<source lang="lsl2">//Time will be less than 4 hours unless the sun is locked.
default
{
touch_start(integer total_number)
{
float tod = llGetTimeOfDay( );
llOwnerSay("Time since last region restart or SL midnight (based on SL 4 hour day):");
integer hours = ((integer)tod / 3600) ;
integer minutes = ((integer)tod / 60) - (hours * 60);
llOwnerSay((string) tod + " seconds which is "+(string) hours+"h "+(string) minutes+"m");
}
}</source>
|helpers
|also_functions=
{{LSL DefineRow||[[llGetSunDirection]]|}}
{{LSL DefineRow||[[llGetRegionTimeOfDay]]|}}
|also_events
|also_tests
|also_articles
|notes
|cat1=Time
|cat2=Region
|cat3
|cat4
}}

LlGetRegionTimeOfDay

Maestro Linden — Tue, 29 Aug 2023 17:45:20 GMT

Maestro Linden:

{{LSL_Function
|func=llGetRegionTimeOfDay
|func_id=80
|func_sleep=0.0
|func_energy=10.0
|return_type=float
|func_footnote=By default (without custom environment settings), Second Life day cycles are 4 hours long (3 hours of light, 1 hour of dark). The sunrise and sunset time varies slowly.
|func_desc
|return_text=that is the time in seconds with subsecond precision since Second Life midnight (per the region-scoped day cycle settings) or region up-time (time since when the region was brought online/rebooted); whichever is smaller. If the region is configured so the sun stays in a constant position, then the returned value is the region up-time.
|spec
|caveats
|constants
|examples=<source lang="lsl2">//Time will be less than 4 hours unless the sun is locked.
default
{
touch_start(integer total_number)
{
float tod = llGetRegionTimeOfDay( );
llOwnerSay("Time since last region restart or SL midnight (based on SL 4 hour day):");
integer hours = ((integer)tod / 3600) ;
integer minutes = ((integer)tod / 60) - (hours * 60);
llOwnerSay((string) tod + " seconds which is "+(string) hours+"h "+(string) minutes+"m");
}
}</source>
|helpers
|also_functions=
{{LSL DefineRow||[[llGetSunDirection]]|}}
{{LSL DefineRow||[[llGetTimeOfDay]]|}}
|also_events
|also_tests
|also_articles
|notes
|cat1=Time
|cat2=Region
|cat3
|cat4
}}

LlGetRegionTimeOfDay

Maestro Linden — Tue, 29 Aug 2023 17:44:41 GMT

Maestro Linden: This function was created years ago but didn't have a wiki page

{{LSL_Function
|func=llGetRegionTimeOfDay
|func_id=80
|func_sleep=0.0
|func_energy=10.0
|return_type=float
|func_footnote=By default (without custom environment settings), Second Life day cycles are 4 hours long (3 hours of light, 1 hour of dark). The sunrise and sunset time varies slowly.
|func_desc
|return_text=that is the time in seconds with subsecond precision since Second Life midnight (per the region-scoped day cycle settings) or region up-time (time since when the region was brought online/rebooted); whichever is smaller. If the region is configured so the sun stays in a constant position, then the returned value is the region up-time.
|spec
|caveats
|constants
|examples=<source lang="lsl2">//Time will be less than 4 hours unless the sun is locked.
default
{
touch_start(integer total_number)
{
float tod = llGetRegionTimeOfDay( );
llOwnerSay("Time since last region restart or SL midnight (based on SL 4 hour day):");
integer hours = ((integer)tod / 3600) ;
integer minutes = ((integer)tod / 60) - (hours * 60);
llOwnerSay((string) tod + " seconds which is "+(string) hours+"h "+(string) minutes+"m");
}
}</source>
|helpers
|also_functions=
{{LSL DefineRow||[[llGetSunDirection]]|}}
|also_events
|also_tests
|also_articles
|notes
|cat1=Time
|cat2=Region
|cat3
|cat4
}}

LlPushObject

Maestro Linden — Tue, 15 Aug 2023 18:46:09 GMT

Maestro Linden: Added a caveat about energy use per BUG-234232

{{LSL_Function
|inject-2={{LSL_Function/uuid|target|sim=*|object=*|group=}}
|func_id=165|func_sleep=0.0|func_energy=10.0
|func=llPushObject
|p1_type=key|p1_name=target|p1_desc
|p2_type=vector|p2_name=impulse|p2_desc=Direction and force of push. Direction is affected by {{LSLP|local}}.|p2_hover=Direction and force of push. Direction is affected by 'local'.
|p3_type=vector|p3_name=ang_impulse|p3_desc=Rotational force.
|p4_type=integer|p4_name=local|p4_desc=boolean, if {{LSL Const|TRUE|integer|1}} uses the [[Viewer coordinate frames#Local|local]] axis of {{LSLP|target}}, if {{LSL Const|FALSE|integer|0}} uses the [[Viewer coordinate frames#Region|region]] axis.|p4_hover=boolean, if TRUE uses the local axis of 'target', if FALSE uses the region axis.
|func_footnote
|func_desc=Applies {{LSLP|impulse}} and {{LSLP|ang_impulse}} to object {{LSLP|target}}
|return_text
|spec
|caveats=*Only works on land where Push is not restricted or where the script is owned by the land owner.
**If the land is owned by a group, the scripted object must be deeded to the same group.
*The effectiveness of Push is modulated by the amount of [[Energy|script energy]] available.
**There is a [[LlPushObject/Havok4Implementation|simplified code snippet]] describing how Push is implemented in the Havok4 project and reveals some of the details of how the energy budget affects the final Push magnitude.
*In no-push areas an object can only push its owner.
*{{LSLP|ang_impulse}} is ignored when applying to agents or their attachments.
*[[Energy]] is fully depleted by this function when either {{LSLP|impulse}} or {{LSLP|ang_impulse}} is nonzero. If {{LSLP|impulse}} is nonzero, it will drain all energy in the object before {{LSLP|ang_impulse}} is processed, causing the push to be purely linear.
*The push impact is diminished with distance by a factor of distance cubed.
|constants
|examples=
<source lang="lsl2">// Pushes the collided object or avatar.
default
{
collision_start(integer num_detected)
{
llPushObject(llDetectedKey(0),<0,0,100>, <0,0,100>, TRUE);
}
}</source>
|helpers
|also_functions
|also_events
|also_tests
|also_articles
|notes
|permission
|negative_index
|cat1=Physics
|cat2=Movement
|cat3
|cat4
}}

LlListFindStrided

Maestro Linden — Fri, 07 Apr 2023 00:24:58 GMT

Maestro Linden: Clarified stride parameter meaning

{{LSL_Function
|func=llListFindStrided
|func_id=201|func_sleep=0.0|func_energy=10.0
|return_type=integer
|Return_text=index of the first instance of {{LSLP|test}} in {{LSLP|src}} matching conditions.
|p1_type=list|p1_name=src|p1_desc=what to search in (haystack)
|p2_type=list|p2_name=test|p2_desc=what to search for (needle)
|p3_type=integer|p3_name=start|p3_desc=Start of range to search
|p4_type=integer|p4_name=end|p4_desc=End of range to search
|p5_type=integer|p5_name=stride|p5_desc=Number of entries per stride within src

|func_footnote=If {{LSLP|test}} matching range and stride conditions is not found in {{LSLP|src}}, -1 is returned.<br/>
The length of {{LSLP|test}} may be equal to or less than {{LSLP|stride}} in order to generate a match.<br/>
The index of the first entry in the list is {{HoverText|0|zero}}<br>
If {{LSLP|test}} is found at the last index in {{LSLP|src}} the positive index is returned (5th entry of 5 returns 4).<br>
If {{LSLP|start}} or {{LSLP|end}} is negative, it is counted from the end list. The last element in the list is -1, the first is -list_length
|func_desc
|spec
|caveats=
* Strict type matching and case sensitivity is enforced.
** "1" != 1
** "1.0" != 1.0
** 1 != 1.0
** "a822ff2b-ff02-461d-b45d-dcd10a2de0c2" != (key)"a822ff2b-ff02-461d-b45d-dcd10a2de0c2"
** "Justice" != "justice"
* If {{LSLP|test}} is an {{HoverText|empty list|[]}} the value returned is {{HoverText|0|zero}} rather than -1.
|constants
|examples=<source lang="lsl2">list mylist = ["a",0,"b",1,"c",2,"b",1];

integer result_a = llListFindStrided(mylist, ["b"], 0, -1, 1); //Stride 1 full range functionally equivalent to llListFindList(mylist,"b");
//result_a = 2

integer result_b = llListFindStrided(mylist, ["b",1], 2, -1, 1); //Inclusive range for start and end will find 2nd list in list
//result_b = 2

integer result_e = llListFindStrided(mylist, ["b"], 3, -1, 1); //The first "b" is at index 2 and will be skipped by starting at 3
//result_c = 6

integer result_d = llListFindStrided(mylist, ["b",1], 2, -1, 1); //Inclusive range for start and end will find 2nd item in list
//result_d = 2

integer result_e = llListFindStrided(mylist, ["b",1], 3, -1, 1); //The first "b",1 series is at index 2 and will be skipped by starting at 3
//result_e = 6

integer result_f = llListFindStrided(mylist, ["b",1], 3, -2, 1); //The first "b",1 series is at index 2 and will be skipped by starting at 3. The second ["b",1] set exceeds the range criteria of the search.
//result_f = -1

integer result_g = llListFindStrided(mylist, ["b",2], 0, -1, 1); //No consecutive elements match ["b",2]
//result_g = -1

integer result_h = llListFindStrided(mylist, ["c"], 0, -1, 2); //With a stride of 2, "c" will be found.
//result_h = 4

integer result_i = llListFindStrided(mylist, ["c"], 0, -1, 3); //With a stride of 3, "c" will be found.
//result_i = -1

integer result_j = llListFindStrided(mylist, ["c"], 0, -1, 4); //With a stride of 4, "c" will be found.
//result_j = 4

integer result_k = llListFindStrided(mylist, ["c"], 1, -1, 2); //While the stride is even, starting at the 2nd element will miss this stride.
//result_k = -1

</source>
<source lang="lsl2">list numbers = [1, 2, 3, 4, 5];
default
{
state_entry()
{
integer index = llListFindStrided(numbers, [3], 0, -1, 1); //Functionally identical to llListFindList(numbers, [3]);
if (index != -1)
{
list three_four = llList2List(numbers, index, index + 1);
llOwnerSay(llDumpList2String(three_four, ","));
// Object: 3,4
}
}
}</source>
<source lang="lsl2">//You can also search for two items at once to find a pattern in a list
list avatarsWhoFoundMagicLeaves = ["Water Duck", "Green Ham", "Fire Centaur","Red Leaf"];
default
{
state_entry()
{
integer index = llListFindStrided(avatarsWhoFoundMagicLeaves, ["Fire Centaur","Red Leaf"],0,-1,2);
if (index != -1)
{
list output = llList2List(avatarsWhoFoundMagicLeaves, index, index + 1);
llOwnerSay(llDumpList2String(output, ","));
// Object: Fire Centaur, Red Leaf
}
}
}</source>
<source lang="lsl2">//It's nearly a database
list food_db = ["FIRSTNAME", "LASTNAME", "FAVORITE FOOD", "ALLERGIES",
"Awesome", "Resident","Apples",0,
"Charlie", "Kites", "Peanuts", "dogs",
"Cool", "McLastname", "Burgers","peanuts"];
default
{
state_entry()
{
list potential_allergen = ["peanuts"];
integer any_allergies = llListFindStrided(food_db, potential_allergen,4,-1,4);
if (any_allergies != -1)
{
llOwnerSay("Every can eat it");
}
else
{
list output = llList2List(food_db, any_allergens - 3, any_allergens - 2);
llOwnerSay(llDumpList2String(output, " ")+" is allergic to it!");
// Object: Cool McLastName is allergic to peanuts
}
}
}</source>

|helpers=
|also_functions=
{{LSL DefineRow||[[llSubStringIndex]]|Find a string in another string}}
|also_events
|also_tests
|also_articles
|notes
|sort=ListFindList
|cat1=List
|haiku={{Haiku|I made a database|Using Only Some Lists|Find by last name.}}
|cat2
|cat3
|cat4
}}