Difference between revisions of "LlDetectedTouchPos"

From Second Life Wiki
Jump to navigation Jump to search
(states, pie)
(The statements about the events gave a false impression about when ZERO_VECTOR could be returned based on the events, specificially the first gave the impression of being limited to only touch_start)
Line 1: Line 1:
{{LSL_Function/detected|index|TouchPos}}{{LSL_Function
{{LSL_Function/detected|index|TouchPos|simple=*}}{{LSL_Function
|func_id=339|func_sleep=0.0|func_energy=10.0
|func_id=339|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 position where the object was touched in {{HoverLink|Viewer coordinate frames#Region|Origin is the origin of the region which "owns" the object.|region coordinates}}, unless it is [[llGetAttached|attached]] to the HUD, in which case it returns the position relative to the [[Viewer coordinate frames#Attachments|attach point]].
|return_type=vector|return_text=that is the position where the object was touched in {{HoverLink|Viewer coordinate frames#Region|Origin is the origin of the region which "owns" the object.|region coordinates}}, unless it is [[llGetAttached|attached]] to the HUD, in which case it returns the position relative to the [[Viewer coordinate frames#Attachments|attach point]].


Inside [[touch_start]], returns [[ZERO_VECTOR]] if the avatar's viewer does not support touch positions. If this value may be valid in your application, you can check if [[llDetectedTouchFace]] returns -1.
Inside [[Touch|touch]] and [[touch_end]], also returns [[ZERO_VECTOR]] 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
|caveats=*This function returns [[ZERO_VECTOR]] if the avatar's viewer does not support touch positions. If this value may be valid in your application, you can check if [[llDetectedTouchFace]] returns -1.
|caveats=
'''{{LSL Const|ZERO_VECTOR|vecter|{{LSL_VR|0.0|0.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 triggering event is not a touch event.
|examples
|examples
|helpers
|helpers

Revision as of 17:19, 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 llDetectedTouchPos( integer index );

Returns a vector that is the position where the object was touched in region coordinates, unless it is attached to the HUD, in which case it returns the position relative to the attach point.

• 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.ZERO_VECTOR is returned when...
  • The avatar's viewer does not support face touch detection.
  • The touch has moved off the surface of the prim.
  • 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
•  llDetectedTouchUV

Articles

•  Detected

Deep Notes

History

Search JIRA for related Issues

Signature

function vector llDetectedTouchPos( integer index );
Retrieved from "https://wiki.secondlife.com/w/index.php?title=LlDetectedTouchPos&oldid=87870"