llPassTouches(integer pass)

Indicates whether a child prim in a linkset should let the root know that it has been touched.

When a script in the root prim has one of the touch events (touch_start, touch or touch_end) active, the whole object becomes touchable. However, when a child prim has at least one script that has a touch event active and that prim is touched, by default only that prim will receive the touch, and the root will not receive it. This function allows changing that default, so that both the root and the child can receive the touches, or so that the root won't receive them even if the child has no active touch event.

An integer value indicating whether to pass touches to the root.

A value of PASS_IF_NOT_HANDLED makes the root receive touches from the child prim the script is in, only if none of the scripts in that child has an active touch event. If there is one, the root won't receive touches; only the child will. This is the default value when no script in the child calls llPassTouches.

A value of PASS_ALWAYS makes the root receive touches from the child prim the script is in, even if a script in that child prim has an active touch event (in which case both will receive it).

A value of PASS_NEVER makes the root not receive touches from the child prim the script is in, regardless of the presence or absence of an active touch event in the child. Conceptually, it works the same as adding an empty touch event to the script in the child and passing a parameter of PASS_IF_NOT_HANDLED to llPassTouches.

• The setting only takes place for the prim where the script is in; it doesn't affect any other prims.
• If there is a touch event in the child, it will always receive touches, regardless of this setting.
• A value of PASS_NEVER does not make the hand cursor disappear for the child prim the script is in.
• This setting is NOT a prim property, it is per script. Deleting or stopping all scripts that changed it from default will cause the effect to cease, and the behaviour to revert to default.

llPassTouches(TRUE); // Enables touch passing for this prim.

llPassTouches(FALSE); // Disables touch passing.

When this simple script is dropped into a child prim that has more scripts, one of them with a touch event, it will let the root know that it has been touched. Imagine, for example, a swing where the seat is a child prim, which has a script that activates a pose menu, and the root has a script that starts and stops swinging, but the seat where the pose menu is, is easier to touch than other prims. In that case, dropping this script into the seat will make both the swing script and the menu activate with a single touch of the seat.

Removing or stopping the script will make the effect disappear.

llPassTouches-example.lsl

default
{
    state_entry()
    {
        llPassTouches(TRUE);
    }
}

• Touch events: touch_start, touch, touch_end.
• llPassCollisions is similar but for collision events.