Difference between revisions of "LlDetectedTouchUV"

From Second Life Wiki
Jump to navigation Jump to search
(pie, events)
Line 1: Line 1:
{{LSL_Function/detected|index|TouchUV}}{{LSL_Function
{{LSL_Function/detected|index|TouchUV|simple=*}}{{LSL_Function
|func_id=337|func_sleep=0.0|func_energy=10.0
|func_id=337|func_sleep=0.0|func_energy=10.0
|mode=pre-release
|mode=pre-release
Line 5: Line 5:
|return_type=vector|return_text=that is the texture coordinates for where the prim was touched. The x & y vector positions contain the u & v face coordinates respectively ('''{{NoWrap|{{LSL_VR|u|v|0.0}}}}''').
|return_type=vector|return_text=that is the texture coordinates for where the prim was touched. The x & y vector positions contain the u & v face coordinates respectively ('''{{NoWrap|{{LSL_VR|u|v|0.0}}}}''').


Inside [[touch_start]] or [[touch_end]], returns <-1., -1., 0.> if the avatar's viewer does not support this feature.
{{NoWrap|{{LSL_VR|-1.0|-1.0|0.0}}}} is returned when the touch UV coordinates cannot be determined. See [[#Caveats|Caveats]] for further details.
 
Inside [[Touch|touch]], also returns <-1., -1., 0.> if the mouse has moved away from the prim.
|p1_type=integer|p1_name=index
|p1_type=integer|p1_name=index
|func_footnote=For the {{LSLGC|Touch|touch}} category of events only.
|func_footnote=For the {{LSLGC|Touch|touch}} category of events only.
|func_desc
|func_desc
|spec
|spec=
|caveats=* <-1., -1., 0.> can be returned for a touch starting just outside the prim edge. To tell this case apart from an unsupported viewer, check if [[llDetectedTouchFace]] returns -1 or a valid face.
|caveats=
'''{{NoWrap|{{LSL_VR|-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
|examples
|helpers
|helpers

Revision as of 17:11, 23 August 2008

Emblem-important-red.png Pre-release Documentation Warning!

This function is not available yet. This documentation was written prior to its final release so it may not match the final implementation.

Summary

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

<-1.0, -1.0, 0.0> 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.

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.
  • 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.
All Issues ~ Search JIRA for related Bugs

Examples

See Also

Events

•  touch_start
•  touch
•  touch_end

Functions

•  llDetectedLinkNumber
•  llDetectedTouchFace
•  llDetectedTouchST
•  llDetectedTouchPos

Articles

•  Detected

Deep Notes

History

Search JIRA for related Issues

Signature

function vector llDetectedTouchUV( integer index );