llDetectedTouchPos

From Second Life Wiki
Revision as of 17:14, 6 August 2008 by Viktoria Dovgal (talk | contribs) (returns zero_vector for unsupported viewers)
Jump to navigation Jump to search
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.

Specification

llDetected* functions only work if called from within Detection events (collision, collision_start, collision_end, sensor, touch, touch_start, touch_end) or in functions called by Detection events. They will fail silently and return unusable values if called during other events.

Caveats

  • If index is out of bounds the script continues to execute without an error message.
  • Events that enable the llDetected* functions always return at least one detected item.
    • Detection events are not raised if there is nothing detected.[1]
    • The detection event's items detected parameter is initially never less than 1.[2]
  • 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 llDetectedFace returns -1.
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

Introduced in Viewer SVN:870 r92872 Branch:Release Wednesday, 23 July 2008, no server support, no viewer binary released.
Search JIRA for related Issues

Footnotes

  1. ^ The exception is no_sensor but it doesn't enable llDetected* functions.
  2. ^ Like all event parameters, the user can overwrite the initial value.

Signature

function vector llDetectedTouchPos( integer index );