Skip to content
lsl.devlsl.devLSL Dev

LlPassTouches

Looking for the current API? Open the llPassTouches reference →

Wiki description

Sets whether touches detected on this prim are passed to the root prim.

See also: functions

See also: events

History

  • Introduction: ?
  • Change: SVC-5923 - Server version 1.40.2 - New pass value added: 2

Shared wiki helpers

The original page also injects shared parameter notes, caveats or issue information through these helpers. Their conditional MediaWiki logic is not reproduced here; inspect the preserved helper source for additional material.

Template:Issues/SVC-3306

Original shared helper source (conditional wiki logic is not evaluated)
{{Issues|SVC-3306|Add enumeration to [[llPassCollisions]]() to provide [[PASS_ALWAYS]], [[PASS_IF_NOT_HANDLED]], and [[PASS_NEVER]] as explicit options.<br>(Was: {{LSLGC|Collision}}s passed to parent REGARDLESS [[llPassCollisions]]([[FALSE]]) in child)|type=nf|status=fixp}}

Template:LSLGC

Original shared helper source (conditional wiki logic is not evaluated)
[[:Category:LSL {{{1}}}|{{#if:{{{2|}}}|{{{2}}}|{{{1}}}}}]]<noinclude>
{{Documentation}}
</noinclude>

Template:LSL Function/Pass

Original shared helper source (conditional wiki logic is not evaluated)
<noinclude>{{Multi-lang|category=LSL}}</noinclude>{{LSL Injection Test}}{{#if:

{{#vardefine:header|{{#var:header}}
{{#switch:{{#if:{{{nc|}}}|Template|{{NAMESPACE}}}}|Template=|User=|}}}}

{{#vardefine:p_{{{1|}}}_desc|PASS_* flag&#32;}}
{{#vardefine:p_{{{1|}}}_hover|PASS_* flag&#32;}}

<!--
<includeonly>
{{#ifeq:{{#var:article-type}}|event||{{#if:{{#pos:{{#var:moded}}|r}}{{#pos:{{#var:moded}}|u}}||{{#vardefine:hidden-text|{{#var:hidden-text}}
{{LSLC|Pass{{#var:lang}}}}{{#if:{{{mode|}}}|{{LSLC|Pass/{{{mode}}}{{#var:lang}}}}}}
}}}}}}
</includeonly>
-->

{{#if:{{{noconst|}}}{{#var:pass_constants}}||
{{#vardefine:constants_nb|
{{LSL Constants/Pass|{{{1|}}}|{{{2|}}}|{{{3}}}|default={{{default|}}}}}{{#var:constants_nb}}}}
{{#vardefine:pass_constants|*}}
}}

{{#if:{{{nocaveats|}}}||
{{#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}}}}
}}

{{#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. 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}}
}}
}}

{{#if:{{{tf|<noinclude>*</noinclude>}}}|
{{#vardefine:deepnotes|{{#vardefine:deepnotes|}}{{PBR}}
==== [[TRUE]] & [[FALSE]] vs. PASS_* flags ====
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.
}}
}}

}}<noinclude>
{| {{Prettytable}}
|-{{Hl2}}
! #var
! value
|-
{{VarPair|p_{{{1|}}}_desc}}
|-
{{VarPairTable|also_functions}}
|-
{{VarPair|constants_nb}}
|-
{{VarPair|caveats}}
|-
{{VarPair|spec}}
|-
{{VarPair|deepnotes}}
|}
</noinclude>
Original wiki source

Some wiki templates and tables need their original context. View this article on the Second Life Wiki. Technical wording and examples are retained from the source; historical guidance may differ from current behavior.