Osgridadmin: Created page with "==Function: vector llDetectedTouchST( integer index );== Returns a vector that is the surface coordinates for where the prim was touched. The x & y vector positions contain th..."

2017-12-30T17:56:05Z

Created page with "==Function: vector llDetectedTouchST( integer index );== Returns a vector that is the surface coordinates for where the prim was touched. The x & y vector positions contain th..."

New page

==Function: vector llDetectedTouchST( integer index );==
Returns a vector that is the surface coordinates for where the prim was touched. The x & y vector positions contain the horizontal (s) & vertical (t) face coordinates respectively (< s, t, 0.0>). Each component is in the interval [0.0, 1.0]. 
[[TOUCH_INVALID_TEXCOORD]] is returned when the surface 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''' 
{|border="1" cellpadding="5" cellspacing="0"
|<source lang="lsl">
default {

touch_start(integer num_detected) {
integer i = 0;
for(; i < num_detected; ++i ) {
vector touchedpos = llDetectedTouchST(i);

if (llDetectedTouchFace(i) == -1) {
llWhisper(0, "Sorry, your viewer doesn't support touched faces.");
}
else if ( touchedpos == TOUCH_INVALID_TEXCOORD ) {
llWhisper(0, "Sorry, the surface touch position could not be determined.");
}
else {
llWhisper(0, (string) touchedpos);
}
} // while ...
} // touch_start

}
</source>
|}
 
{|border="1" cellpadding="5" cellspacing="0"
|<source lang="lsl">
vector touchedLoc;

default {
//Draws a cross-hair at the detected Location on the detected face.

touch(integer num_detected) {
integer i;
for (i = 0; i < num_detected; i++) {
touchedLoc = llDetectedTouchST(i); //What location has been touched?
llSetPrimitiveParams([PRIM_TEXTURE, llDetectedTouchFace(i), "5ac7995c-4c24-8b60-ae61-6a837619dc75",
<1.0,1.0,0.0>, touchedLoc, 180*DEG_TO_RAD]); //Set the Texture Location at the touched location
}
}

}
</source>
|}
 
See Also 
'''Events''' 
• [[touch_start]] 
• [[touch]] 
• [[touch_end]] 
'''Functions''' 
• [[llDetectedLinkNumber]] 
• [[llDetectedTouchFace]] 
• [[llDetectedTouchUV]] 
• [[llDetectedTouchPos]] 
• [[llDetectedTouchNormal]] 
• [[llDetectedTouchBinormal]] 
Deep Notes 
'''History''' 
Introduced in Viewer SVN:870 r92872 Branch:Release Wednesday, 23 July 2008, Supported by Beta Server 1.24.0.93754 (Wenesday 6th August 2008), and viewer binary 1.20.15 (93532).

LlDetectedTouchST - Revision history

Osgridadmin: Created page with "==Function: vector llDetectedTouchST( integer index );== Returns a vector that is the surface coordinates for where the prim was touched. The x & y vector positions contain th..."