llDetectedTouchNormal

Template:Needs Translation/LSL/de Template:Needs Translation/LSL/es Template:Needs Translation/LSL/el Template:Needs Translation/LSL/fr Template:Needs Translation/LSL/he Template:Needs Translation/LSL/it Template:Needs Translation/LSL/ko Template:Needs Translation/LSL/nl Template:Needs Translation/LSL/hu Template:Needs Translation/LSL/no Template:Needs Translation/LSL/da Template:Needs Translation/LSL/sv Template:Needs Translation/LSL/tr Template:Needs Translation/LSL/pl Template:Needs Translation/LSL/pt Template:Needs Translation/LSL/ru Template:Needs Translation/LSL/th Template:Needs Translation/LSL/uk Template:Needs Translation/LSL/zh-Hans Template:Needs Translation/LSL/zh-Hant

/LSL

DetectedTouchNormal

llDetectedTouchNormal

Summary

Function: vector llDetectedTouchNormal( integer index );

340	Function ID
0.0	Forced Delay
10.0	Energy

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

• 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.
    • To check if face touch detection is supported check the return of llDetectedTouchFace.
  • 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

Useful Snippets

<lsl>touch_start(integer total_number){

   // rotates the prim, so the touched position points upwards
   llSetRot(llGetRot()*llRotBetween(llDetectedTouchNormal(0),<0,0,1>));

}</lsl>

See Also

Events

•	touch_start
•	touch
•	touch_end

Functions

•	llDetectedLinkNumber
•	llDetectedTouchFace
•	llDetectedTouchST
•	llDetectedTouchUV
•	llDetectedTouchPos
•	llDetectedTouchBinormal

Articles

•

Detected

Deep Notes

History

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

Search JIRA for related Issues

Signature
function vector llDetectedTouchNormal( integer index );