Difference between revisions of "LlDetectedLinkNumber"

Revision as of 00:57, 27 December 2013

Function: integer llDetectedLinkNumber( integer number );

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>

A

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
@@ Line 15: / Line 17: @@
 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)
      {
-         integer i;
+         llOwnerSay("Link number clicked: " + (string)llDetectedLinkNumber(0) );
-        for(i=0; i<num_detected; ++i) {
-            llOwnerSay("Link number clicked: " + (string)llDetectedLinkNumber(i));
-        }
      }
 }