Difference between revisions of "LlDetectedTouchBinormal"
Jump to navigation
Jump to search
(pie, events) |
m |
||
| Line 4: | Line 4: | ||
|func=llDetectedTouchBinormal | |func=llDetectedTouchBinormal | ||
|return_type=vector|return_text=that is the surface binormal (tangent to the surface) where the touch event was triggered. | |return_type=vector|return_text=that is the surface binormal (tangent to the surface) where the touch event was triggered. | ||
|p1_type=integer|p1_name=index | |p1_type=integer|p1_name=index | ||
|func_footnote=For the {{LSLGC|Touch|touch}} category of events only. | |func_footnote=For the {{LSLGC|Touch|touch}} category of events only. | ||
|func_desc | |func_desc | ||
|spec | |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 | |examples | ||
|helpers | |helpers | ||
Revision as of 16:20, 23 August 2008
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
|
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. |
Summary
Function: vector llDetectedTouchBinormal( integer index );| 0.0 | Forced Delay |
| 10.0 | Energy |
Returns a vector that is the surface binormal (tangent 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.
Specification
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.
Caveats
- 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]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.
Examples
See Also
Events
| • | touch_start | |||
| • | touch | |||
| • | touch_end |
Functions
| • | llDetectedLinkNumber | |||
| • | llDetectedTouchPos | |||
| • | llDetectedTouchFace | |||
| • | llDetectedTouchNormal |
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)
Footnotes
- ^ The exception is no_sensor but it doesn't enable llDetected* functions.
- ^ Like all event parameters, the user can overwrite the initial value.
Signature |
|---|
function vector llDetectedTouchBinormal( integer index ); |