Difference between revisions of "LlDetectedTouchST"

From Second Life Wiki
Jump to navigation Jump to search
(Undo revision 83556 by Strife Onizuka (Talk) the template needs work, better to just not use it)
(pie!)
Line 5: Line 5:
|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].


Returns <-1., -1., 0.> if the avatar's viewer does not support this feature.
Returns <-1., -1., 0.> if the touch did not include position information (pie menu touch, or the avatar's viewer does not support this feature).
|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.

Revision as of 14:33, 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 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].

Returns <-1., -1., 0.> if the touch did not include position information (pie menu touch, or the avatar's viewer does not support this feature).

• 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]

Examples

See Also

Events

•  touch_start
•  touch
•  touch_end

Functions

•  llDetectedLinkNumber
•  llDetectedTouchFace
•  llDetectedTouchUV
•  llDetectedTouchPos

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

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 llDetectedTouchST( integer index );