LlDetectedTouchFace - Second Life Wiki

LlDetectedTouchFace

From Second Life Wiki

Jump to: navigation, search

Contents

Summary

Function: integer llDetectedTouchFace( integer index );
338 Function ID
0.0 Delay
10.0 Energy

Returns an integer that is the index of the face the avatar clicked on.

• integer index Index of detection information

index does not support negative indexes. For the touch category of events only. The prim that was touched may not be the prim receiving the event, use llDetectedLinkNumber to check for this; likewise you can use llDetectedTouchFace to determine which face was touched.

Caveats

  • If index is out of bounds the script continues to execute without an error message.
  • TOUCH_INVALID_FACE is returned when...
    • The avatar's viewer does not support face touch detection.
    • The touch has moved off the surface of the prim.
    • The event triggered is not a touch event.

Search JIRA for related Bugs

Examples

 
default {
 
    touch_start(integer num_detected) {
        integer i;
        for (i = 0; i < num_detected; i++) {
            integer touchedFace = llDetectedTouchFace(i);      
 
            if (touchedFace == -1) {
                llWhisper(0, "Sorry, your viewer doesn't support touched faces.");
            }
            else {
                // Store away the original color
                vector oldColor = llGetColor(touchedFace);
 
                // Flash white and black on the touched face
                llSetColor(<1., 1., 1.>, touchedFace);
                llSleep(0.1);
                llSetColor(<0., 0., 0.>, touchedFace);
                llSleep(0.1);
 
                // Put the color back to how we found it.
                llSetColor(oldColor, touchedFace);
            } // if ...
        } // for ...
    } // touch_start
 
}
 

See Also

Deep Notes

History

Issues

Search JIRA for related Issues

This article wasn't helpful for you? Maybe the related article at the LSL Wiki is able to bring enlightenment.