Difference between revisions of "LlDetectedTouchNormal"

Revision as of 17:20, 23 August 2008

	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.

Function: vector llDetectedTouchNormal( integer index );

Returns a vector that is the surface normal (perpendicular to the surface) where the touch event was triggered.

• integer

–

Index of detection information

index does not support negative indexes. For the touch category of events only.

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

Introduced in Viewer ~~SVN:870 r92872 Branch:Release Wednesday, 23 July 2008~~, no server support, no viewer binary released.
Server support available on preview grid in Second Life Beta Server 1.24, client support in Preview Grid viewer 1.20.15 (93532)

Signature
function vector llDetectedTouchNormal( integer index );

@@ Line 1: / Line 1: @@
-{{LSL_Function/detected|index|TouchNormal}}{{LSL_Function
+{{LSL_Function/detected|index|TouchNormal|simple=*}}{{LSL_Function
 |func_id=340|func_sleep=0.0|func_energy=10.0
 |mode=pre-release
 |func=llDetectedTouchNormal
 |return_type=vector|return_text=that is the surface normal (perpendicular to the surface) where the touch event was triggered.
-Inside [[touch_start]], returns [[ZERO_VECTOR]] if the avatar's viewer does not support touch positions.
-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
 |func_footnote=For the {{LSLGC|Touch|touch}} category of events only.
 |func_desc
 |spec
-|caveats
+|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
 |helpers