Difference between revisions of "LlDetectedKey"

Revision as of 03:57, 26 December 2012

Function: key llDetectedKey( integer number );


0.0	Forced Delay
10.0	Energy

Returns a key that is the UUID of the detected object or avatar number.

• integer

–

Index of detection information

number does not support negative indexes. Returns an empty key if number does not correspond to a valid sensed object or avatar.

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

<lsl> default {

   touch_start(integer num_detected)
   {
       llSay(0, "touch_start event: key of avatar touching: " + (string) llDetectedKey(0) );
   }

}

</lsl>

Signature
function key llDetectedKey( integer number );

@@ Line 5: / Line 5: @@
 |return_type=key
 |p1_type=integer|p1_name=number
-|func_footnote=Returns an {{HoverText|empty key|{{String}}}} if '''number''' is not valid sensed object or avatar.
+|func_footnote=Returns an {{HoverText|empty key|{{String}}}} if '''number''' does not correspond to a valid sensed object or avatar.
 |func_desc
 |return_text=that is the [[UUID]] of the {{LSLGC|Detected|detected}} object or avatar '''number'''.
@@ Line 17: / Line 17: @@
      touch_start(integer num_detected)
      {
-        // PUBLIC_CHANNEL has the integer value 0
+         llSay(0, "touch_start event: key of avatar touching: " + (string) llDetectedKey(0) );
-         llSay(PUBLIC_CHANNEL, "touch_start event: key of avatar touching: " + (string) llDetectedKey(0));
-    }
-    // this event is trigger WHILE clicking and holding, between touch_start and touch_end
-    touch(integer num_detected)
-    {
-        integer index;// default is 0
-        do
-        {
-            // PUBLIC_CHANNEL has the integer value 0
-            llSay(PUBLIC_CHANNEL,
-                "touch event: key of avatar touching: " + (string)llDetectedKey(index));
-        }
-        while (++index < num_detected);
      }
 }