llDetectedKey

Template:Needs Translation/LSL/es Template:Needs Translation/LSL/el Template:Needs Translation/LSL/he Template:Needs Translation/LSL/it Template:Needs Translation/LSL/nl Template:Needs Translation/LSL/hu Template:Needs Translation/LSL/no Template:Needs Translation/LSL/da Template:Needs Translation/LSL/sv Template:Needs Translation/LSL/tr Template:Needs Translation/LSL/pl Template:Needs Translation/LSL/pt Template:Needs Translation/LSL/ru Template:Needs Translation/LSL/th Template:Needs Translation/LSL/uk Template:Needs Translation/LSL/zh-Hans Template:Needs Translation/LSL/zh-Hant

/LSL

DetectedKey

llDetectedKey

Summary

Function: key llDetectedKey( integer number );

32	Function ID
0.0	Forced Delay
10.0	Energy

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

• integer

number

–

Index of detection information

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

Specification

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.

Caveats

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

All Issues ~ Search JIRA for related Bugs

Examples

<lsl> default {

   touch_start(integer num_detected)
   {
       // PUBLIC_CHANNEL has the integer value 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);
   }

}

</lsl>

See Also

Articles

•

Detected

Deep Notes

Search JIRA for related Issues

Footnotes

1. ^ The exception is no_sensor but it doesn't enable llDetected* functions.
2. ^ Like all event parameters, the user can overwrite the initial value.

Signature
function key llDetectedKey( integer number );