Template:LSL Function/Pass: Difference between revisions

Latest revision as of 09:37, 3 December 2025

#var

value

p__desc

PASS_* flag

also_functions

constants_nb

Constant	Value	Script	No Script	Description
PASS_IF_NOT_HANDLED	0	not passed	passed	{{{3}}} are passed if there is no script handling the event in the prim.
PASS_ALWAYS	1	passed	passed	{{{3}}} are always passed to the root.
PASS_NEVER	2	not passed	not passed	{{{3}}} are never passed to the root.

caveats

Has no known effect if called from within the root prim.
The script must be located in the prim whose pass-touch behavior is being changed; if not, the prim reverts to the default pass-touch setting.

spec

deepnotes

TRUE & FALSE vs. PASS_* flags

Prior to Server Version 1.40.2, was couched in terms of being a boolean and the only meaningful values were 0 and 1. The best practice at that time was to use the integer constants TRUE and FALSE. The design of this function left much to be desired. The problem was that while TRUE always caused all {{{3}}} to be passed along to the the root, FALSE would only not pass {{{3}}} if there the prim had a script that handled a {{{2}}} event. This meant to fully utilize this function the prim must contain a script that handled {{{2}}} events! With the release of Server Version 1.40.2, the PASS_* flags were introduced and the subtype of the was changed. Specifically the introduction of PASS_NEVER solved this problem, allowing content creators to eliminate scripts that were only in the object to tweak the passing of {{{2}}} events.

@@ Line 15: / Line 15: @@
 -->
-{{#if:{{{nlf|}}}{{{noconst|}}}{{#var:pass_constants}}||
+{{#if:{{{noconst|}}}{{#var:pass_constants}}||
 {{#vardefine:constants_nb|
-{{{!}} class="sortable" {{prettytable}}
+{{LSL Constants/Pass|{{{1|}}}|{{{2|}}}|{{{3}}}|default={{{default|}}}}}{{#var:constants_nb}}}}
-{{!}}-{{hl2}}
-! {{LSLPT|{{{1|}}}}} Constant
-! Value
-! {{{2|}}} Script
-! No {{{2|}}} Script
-! Description
-{{!}}-
-{{!}} {{#vardefineecho:PASS_IF_NOT_HANDLED|{{LSL Const|PASS_IF_NOT_HANDLED|integer|0|c={{{3|}}} are not passed to the root while there is a {{{3|}}} handling script in the prim.}}}}
-{{!}} {{#var:value}}
-{{!}} {{no|not passed}}
-{{!}} {{yes|passed}}
-{{!}} {{#ifeq:{{{default|}}}|{{#var:cname}}|'''Default:'''}} {{#var:comment}}
-{{!}}-
-{{!}} {{#vardefineecho:PASS_ALWAYS|{{LSL Const|PASS_ALWAYS|integer|1|c={{{3|}}} are passed to the root.}}}}
-{{!}} {{#var:value}}
-{{!}} {{yes|passed}}
-{{!}} {{yes|passed}}
-{{!}} {{#ifeq:{{{default|}}}|{{#var:cname}}|'''Default:'''}} {{#var:comment}}
-{{!}}-
-{{!}} {{#vardefineecho:PASS_NEVER|{{LSL Const|PASS_NEVER|integer|2|c={{{3|}}} are never passed to the root.}}}}
-{{!}} {{#var:value}}
-{{!}} {{no|not passed}}
-{{!}} {{no|not passed}}
-{{!}} {{#ifeq:{{{default|}}}|{{#var:cname}}|'''Default:'''}} {{#var:comment}}
-{{!}}}{{#var:constants_nb}}}}
 {{#vardefine:pass_constants|*}}
 }}
@@ Line 49: / Line 24: @@
 {{#vardefine:caveats|
 * Has no known effect if called from within the root prim.
+* The script must be located in the prim whose pass-touch behavior is being changed; if not, the prim reverts to the default pass-touch setting.
 {{#var:caveats}}}}
 }}
@@ Line 54: / Line 30: @@
 {{#if:{{{default|}}}|
 {{#vardefine:header_footnote|{{#var:header_footnote}}{{PBR}}
-Whether {{{3|}}} are passed to the root prim depends not only on which PASS_* flag is selected, but may also depend on if there is a script that in the prim that handles one of the {{{2|}}} events. Most users will want to use {{#var:PASS_ALWAYS}} or {{#var:PASS_NEVER}}.
+Whether {{{3|}}} are passed to the root prim depends not only on which PASS_* flag is selected, but may also depend on if there is a script that in the prim that handles one of the {{{2|}}} events. For this reason most users will want to use {{#var:PASS_ALWAYS}} or {{#var:PASS_NEVER}} as they do not have this variable behavior.
 The default value for this attribute is {{#var:{{{default|}}}}}.{{PBR}}
@@ Line 63: / Line 39: @@
 {{#vardefine:deepnotes|{{#vardefine:deepnotes|}}{{PBR}}
 ==== [[TRUE]] & [[FALSE]] vs. PASS_* flags ====
-Prior to Server Version 1.40.2, for this function 0 and 1 were the only meaningful values and {{LSLPT|{{{1|}}}}} was couched in terms of being a [[:Category:LSL_Integer/boolean|boolean]]. The best practice at that time was to use the integer constants [[TRUE]] and [[FALSE]]. The design of this function left much to be desired. The problem was that while [[TRUE]] always caused all {{{3}}} to be passed along to the the root, [[FALSE]] would only not pass {{{3}}} if there the prim had a script that handled a {{{2}}} event. This meant to fully utilize this function the prim must contain a script that handled {{{2}}} events! With the release of Server Version 1.40.2, the PASS_* flags were introduced and the subtype of the {{LSLPT|{{{1|}}}}} was changed. Specifically the introduction of {{#var:PASS_NEVER}} solved this problem, allowing content creators to eliminate scripts that were only in the object to tweak the passing of {{{2}}} events.
+Prior to Server Version 1.40.2, {{LSLPT|{{{1|}}}}} was couched in terms of being a [[:Category:LSL_Integer/boolean|boolean]] and the only meaningful values were 0 and 1. The best practice at that time was to use the integer constants [[TRUE]] and [[FALSE]]. The design of this function left much to be desired. The problem was that while [[TRUE]] always caused all {{{3}}} to be passed along to the the root, [[FALSE]] would only not pass {{{3}}} if there the prim had a script that handled a {{{2}}} event. This meant to fully utilize this function the prim must contain a script that handled {{{2}}} events! With the release of Server Version 1.40.2, the PASS_* flags were introduced and the subtype of the {{LSLPT|{{{1|}}}}} was changed. Specifically the introduction of {{#var:PASS_NEVER}} solved this problem, allowing content creators to eliminate scripts that were only in the object to tweak the passing of {{{2}}} events.
 }}
 }}

Template:LSL Function/Pass: Difference between revisions

Latest revision as of 09:37, 3 December 2025

TRUE & FALSE vs. PASS_* flags

Navigation menu

Search