Difference between revisions of "LlDetectedLinkNumber"

Revision as of 05:16, 26 December 2012

Function: integer llDetectedLinkNumber( integer number );


0.0	Forced Delay
10.0	Energy

Returns the integer link number 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 15: / Line 15: @@
 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));
-        }
      }
 }