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

Examples

<lsl> default {

   touch_start(integer num_detected)
   {
       integer touchedFace = llDetectedTouchFace(0);

       // PUBLIC_CHANNEL has the integer value 0
       if (touchedFace == -1)
           llSay(PUBLIC_CHANNEL, "Sorry, your viewer doesn't support touched faces.");
       else
       {
           // store the original color
           vector originalColor = llGetColor(touchedFace);

           // color detected face white
           llSetColor(<1.0, 1.0, 1.0>, touchedFace);
           llSleep(0.1);

           // color detected face black
           // ZERO_VECTOR has the vector value <0.0, 0.0, 0.0>
           llSetColor(ZERO_VECTOR, touchedFace);
           llSleep(0.1);

           // color detected face back to original color
           llSetColor(originalColor, touchedFace);
       }
   }

}

</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.
• Server support available in Second Life Server 1.24.7.98039, client support in Release Candidate viewer 1.21.4 (98167)

Signature
function integer llDetectedTouchFace( integer index );