Difference between revisions of "LlDetectedTouchFace"

Revision as of 18:12, 24 July 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: integer llDetectedTouchFace( integer index );

Returns an integer that is the index of the face the avatar clicked on.

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

Signature
function integer llDetectedTouchFace( integer index );

@@ Line 1: / Line 1: @@
-{{LSL_Function/negative_index|false|number|self=*}}{{LSL_Function
+{{LSL_Function/detected|index|TouchFace}}{{LSL_Function
-|func_id
+|func_id=338|func_sleep=0.0|func_energy=10.0
-|mode=request
+|mode=pre-release
-|func_sleep=0.0
+|func=llDetectedTouchFace
-|func_energy=10.0
+|return_type=integer|return_text=that is the index of the face the avatar clicked on.
-|func=llDetectedFace
+|p1_type=integer|p1_name=index
-|sort=DetectedFace
-|p1_type=integer|p1_name=number|p1_desc=touch index
 |func_footnote=For the {{LSLGC|Touch|touch}} category of events only.
 |func_desc
-|return_text=that is the number of the face the avatar clicked on. If not supported by the event, returns -1
-|return_type=integer
 |spec
 |caveats
@@ Line 21: / Line 17: @@
 {{LSL DefineRow||[[touch_end]]|}}
 |also_articles={{LSL DefineRow||{{LSLGC|Detected}}|}}
-|notes=Should reduce prim-count for all button based gadgets. The data seems to be available anyway; it's used in the texture-selection mode of the object-"Edit"
+|notes
-This feature request is posted on JIRA at {{Jira|SVC-519}}. Please go and vote for it if you want this issue implemented.
-See also {{Jira|SCV-574}} (deprecated) and {{Jira|SVC-1902}} (active) for related solutions.
 |cat1
 |cat2
+|cat3
+|cat4
 }}