llDetectedTouchFace

Template:Needs Translation/LSL/de Template:Needs Translation/LSL/es Template:Needs Translation/LSL/el Template:Needs Translation/LSL/fr Template:Needs Translation/LSL/he Template:Needs Translation/LSL/it Template:Needs Translation/LSL/ko Template:Needs Translation/LSL/nl Template:Needs Translation/LSL/hu Template:Needs Translation/LSL/no Template:Needs Translation/LSL/da Template:Needs Translation/LSL/sv Template:Needs Translation/LSL/tr Template:Needs Translation/LSL/pl Template:Needs Translation/LSL/pt Template:Needs Translation/LSL/ru Template:Needs Translation/LSL/th Template:Needs Translation/LSL/uk Template:Needs Translation/LSL/zh-Hans Template:Needs Translation/LSL/zh-Hant

/LSL

DetectedTouchFace

llDetectedTouchFace

Summary

Function: integer llDetectedTouchFace( integer index );

0.0	Forced 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.

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 triggering event is not a touch event.

Examples

<lsl> 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

}

</lsl>

See Also

Events

•	touch_start
•	touch
•	touch_end

Functions

•	llDetectedLinkNumber
•	llDetectedTouchST
•	llDetectedTouchUV
•	llDetectedTouchPos
•	llDetectedTouchNormal
•	llDetectedTouchBinormal

Articles

•

Detected

Deep Notes

History

• Introduced in Viewer SVN:870 r92872 Branch:Release Wednesday, 23 July 2008, no server support, no viewer binary released.
• Server support available on preview grid in Second Life Beta Server 1.24, client support in Preview Grid viewer 1.20.15 (93532)

Signature
function integer llDetectedTouchFace( integer index );