Difference between revisions of "LlDetectedTouchST"
Jump to navigation
Jump to search
m |
m |
||
| Line 1: | Line 1: | ||
{{LSL_Function/detected|index|TouchST|simple=*}}{{LSL_Function | {{LSL_Function/detected|index|TouchST|simple=*}}{{LSL_Function | ||
|func_id=342|func_sleep=0.0|func_energy=10.0 | |func_id=342|func_sleep=0.0|func_energy=10.0 | ||
|func=llDetectedTouchST | |func=llDetectedTouchST | ||
|return_type=vector|return_text=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 ('''{{NoWrap|{{LSL_VR|s|t|0.0}}}}'''). Each component is in the interval [0.0, 1.0]. | |return_type=vector|return_text=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 ('''{{NoWrap|{{LSL_VR|s|t|0.0}}}}'''). Each component is in the interval [0.0, 1.0]. | ||
Revision as of 15:14, 6 September 2008
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: vector llDetectedTouchST( integer index );| 0.0 | Forced Delay |
| 10.0 | Energy |
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].
<-1.0, -1.0, 0.0> 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.
Caveats
- If index is out of bounds the script continues to execute without an error message.<-1.0, -1.0, 0.0> 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
<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 == <-1.0, -1.0, 0.0> ) {
llWhisper(0, "Sorry, the surface touch position could not be determined.");
}
else {
llWhisper(0, (string) touchedpos);
}
} // while ...
} // touch_start
}</lsl>
See Also
Events
| • | touch_start | |||
| • | touch | |||
| • | touch_end |
Functions
| • | llDetectedLinkNumber | |||
| • | llDetectedTouchFace | |||
| • | llDetectedTouchUV | |||
| • | llDetectedTouchPos | |||
| • | llDetectedTouchNormal | |||
| • | llDetectedTouchBinormal |
Articles
| • | Detected |
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).
Signature |
|---|
function vector llDetectedTouchST( integer index ); |