llDetectedTouchPos

From Second Life Wiki
Revision as of 13:53, 26 July 2009 by Hewee Zetkin (talk | contribs) (Note on important bug that currently breaks llDetectedTouchPos() for HUD attachments)
Jump to navigation Jump to search

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.

(Note: HUD attachments currently return coordinates relative to the center of the screen rather than the attachment point due to SVC-3425.)
• integer index Index of detection information

index does not support negative indexes. For the touch category of events only. The prim that was touched may not be the prim receiving the event, use llDetectedLinkNumber to check for this; likewise you can use llDetectedTouchFace to determine which face was touched.

Caveats

  • If index is out of bounds the script continues to execute without an error message.
  • TOUCH_INVALID_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 event triggered is not a touch event.
All Issues ~ Search JIRA for related Bugs

Examples

<lsl> default {

   touch_start(integer pos_detected)
   {
       integer i = 0;
       for(; i<pos_detected; ++i)
           llWhisper(0, "Pos clicked: " + (string)llDetectedTouchPos(i));
   }

}

</lsl>

See Also

Deep Notes

History

Search JIRA for related Issues

Signature

function vector llDetectedTouchPos( integer index );