Jump to content

LlDetectedTouchUV

From OSgrid Wiki
Revision as of 17:57, 30 December 2017 by Osgridadmin (talk | contribs) (Created page with "==Function: vector llDetectedTouchUV( integer index );== Returns a vector that is the texture coordinates for where the prim was touched. The x & y vector positions contain th...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Function: vector llDetectedTouchUV( integer index );

Returns a vector that is the texture coordinates for where the prim was touched. The x & y vector positions contain the u & v face coordinates respectively (< u, v, 0.0>).

TOUCH_INVALID_TEXCOORD is returned when the touch UV coordinates cannot be determined. See Caveats for further details.
• 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
TOUCH_INVALID_TEXCOORD is returned when...

• The avatar's viewer does not support face touch detection.
-• To check if face touch detection is supported check the return of llDetectedTouchFace.
• The touch has moved off the surface of the prim.
• The touch happened too close to the edge of the face to determine a location.
• The triggering event is not a touch event.

Examples

<source lang="lsl">

default {

   touch_start(integer UV_detected)
   {
       integer i = 0;
       for(; i<UV_detected; ++i)
           llWhisper(0, "UV clicked: " + (string)llDetectedTouchUV(i));
   }

} </source>


<source lang="lsl">

default {

   touch_start(integer total_number)
   {
       vector UV = llDetectedTouchUV(0);
       float U = UV.x;
       float V = UV.y;
       // Now you can report U and V separately, or you can compare them separately with IF statements.
       // You of course do not need to store the vector components to separate variables,
       // you can access them from the vector that used as an intermediate.
   }

} </source>


See Also
Events
• touch_start
• touch
• touch_end
Functions
• llDetectedLinkNumber
• llDetectedTouchFace
• llDetectedTouchST
• llDetectedTouchPos
• llDetectedTouchNormal
• llDetectedTouchBinormal

Deep Notes
History
• Introduced in SVN:870 r92872 Trunk 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).