Difference between revisions of "LlDetectedTouchBinormal"

Revision as of 15:30, 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 llDetectedTouchBinormal( integer index );

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

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

• integer

–

Index of detection information

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

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.

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]

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

@@ Line 5: / Line 5: @@
 |return_type=vector|return_text=that is the surface binormal (tangent to the surface) where the touch event was triggered.
-Returns [[ZERO_VECTOR]] if the avatar's viewer does not support this feature.
+Returns [[ZERO_VECTOR]] 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
 |func_footnote=For the {{LSLGC|Touch|touch}} category of events only.