Difference between revisions of "LlDetectedLinkNumber"

Revision as of 23:57, 26 December 2013

Function: integer llDetectedLinkNumber( integer number );


0.0	Forced Delay
10.0	Energy

Returns the link_number (an integer) of the triggered event. If not supported by the event, returns zero.

• integer

–

Index of detection information

number does not support negative indexes. For touch and collision categories 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.

llDetectedLinkNumber will return 0 in collision_start and collision_end events of VolumeDetect objects (SVC-2996).
If number is out of bounds this function returns 0 and 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]

<lsl> default { // Drop this script into the root prim of of a build // Touch any prim to learn its link number

   touch_start(integer num_detected)
   {
       llOwnerSay("Link number clicked: " + (string)llDetectedLinkNumber(0) );       
   }

}

</lsl>

Signature
function integer llDetectedLinkNumber( integer number );

@@ Line 4: / Line 4: @@
 |func=llDetectedLinkNumber
 |return_type=integer
+|return_subtype=link
+|return_subtype_disp=link_number
+|Return_text=of the triggered event. If not supported by the event, returns zero.
 |p1_type=integer|p1_name=number
 |func_footnote=For {{LSLGC|Touch|touch}} and {{LSLGC|Collision|collision}} categories of events only.
 |func_desc
-|Return_text=link number of the triggered event. If not supported by the event, returns zero.
 |spec
 |caveats