llPassTouches(integer pass)

Indicates whether a child prim in a linkset should let the root know that it has been touched, when there is at least one script in the same child prim that has one of the touch events.

When a script in the root prim has a touch event, the whole object becomes touchable. However, when a child prim has at least one script that has a touch event and it's 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.

A boolean value indicating whether to pass touches to the root.

• The setting only takes place for the prim where the script is in; it doesn't affect any other prims.
• This setting is NOT a prim property, it is per script. Deleting or stopping all scripts that enabled it will cause the effect to cease. It will be enabled while at least one running script has it set to TRUE. If a script that has set this to TRUE is set to not running, the flag for that script will be disabled while so, and restored when set to running again.

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, and it 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 will make both the swing script and the menu activate with a single touch of the seat.

llPassTouches-example.lsl

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

• touch events (touch_start, touch, touch_end)