LlDetectedTouchPos: Difference between revisions

From Second Life Wiki
Jump to navigation Jump to search
Strife Onizuka (talk | contribs)
Sorry but no bug is important enough to interrupt the description. Maybe at the end of the desc-footnote but not before the parameter description. Please try to keep the bugs in the bug sections.
No edit summary
Line 2: Line 2:
|func_id=339|func_sleep=0.0|func_energy=10.0
|func_id=339|func_sleep=0.0|func_energy=10.0
|func=llDetectedTouchPos
|func=llDetectedTouchPos
|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 in screen space coordinates.
|p1_type=integer|p1_name=index
|p1_type=integer|p1_name=index
|func_footnote=For the {{LSLGC|Touch|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.
|func_footnote=For the {{LSLGC|Touch|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.

Revision as of 15:56, 27 February 2010

Summary

Function: vector llDetectedTouchPos( integer index );
0.0 Forced Delay
10.0 Energy

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 in screen space coordinates.

• 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

  • HUD attachments currently return coordinates relative to the center of the screen rather than the attachment point. SVC-3425
  • 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.

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

Signature

function vector llDetectedTouchPos( integer index );