Difference between revisions of "LlDetectedTouchBinormal"
m (added date of release server) |
(The documentation wrongly stated that the binormal points in the U direction; that is the 'Tangent'. Instead the return binormal (correctly) points in the positive V (or T) direction of tangent space.) |
||
| Line 3: | Line 3: | ||
|func_id=341|func_sleep=0.0|func_energy=10.0 | |func_id=341|func_sleep=0.0|func_energy=10.0 | ||
|func=llDetectedTouchBinormal | |func=llDetectedTouchBinormal | ||
|return_type=vector|return_text=that is the surface binormal (tangent to the surface pointing along the | |return_type=vector|return_text=that is the surface binormal (tangent to the surface, pointing along the positive T (V) direction of tangent space) where the touch event was triggered. Along with [[llDetectedTouchNormal]], this information can be used to find the [http://en.wikipedia.org/wiki/Tangent_space tangent space] at the touch location. | ||
|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.{{PBR}}To find the third tangent vector, [[LSL Cross Product|cross]] this vector with the [[llDetectedTouchNormal|normal]]. | |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.{{PBR}}To find the third tangent vector, [[LSL Cross Product|cross]] this vector with the [[llDetectedTouchNormal|normal]]. | ||
Revision as of 17:03, 22 March 2014
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
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, pointing along the positive T (V) direction of tangent space) where the touch event was triggered. Along with llDetectedTouchNormal, this information can be used to find the tangent space at the touch location.
| • 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.To find the third tangent vector, cross this vector with the normal.
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.
- 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.
- The avatar's viewer does not support face touch detection.
Examples
<lsl> default {
touch_start(integer total_num)
{
llOwnerSay((string)llDetectedTouchBinormal(0));
}
}
</lsl>See Also
Events
| • | touch_start | |||
| • | touch | |||
| • | touch_end |
Functions
| • | llDetectedLinkNumber | |||
| • | llDetectedTouchFace | |||
| • | llDetectedTouchST | |||
| • | llDetectedTouchUV | |||
| • | llDetectedTouchPos | |||
| • | 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)
- Date of Release Server 29-08-2008
- Date of Release Client 16-10-2008
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 ); |