llDetectedLinkNumber

Template:Needs Translation/LSL/de Template:Needs Translation/LSL/es Template:Needs Translation/LSL/el Template:Needs Translation/LSL/he Template:Needs Translation/LSL/it Template:Needs Translation/LSL/ko 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

DetectedLinkNumber

llDetectedLinkNumber

Summary

Function: integer llDetectedLinkNumber( integer number );

40	Function ID
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

number

–

Index of detection information

number does not support negative indexes. For touch and collision categories of events only.

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

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

All Issues ~ Search JIRA for related Bugs

Examples

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

See Also

Events

•	touch_start
•	touch
•	touch_end
•	collision_start
•	collision
•	collision_end

Functions

•

llDetectedTouchFace

Articles

•

Detected

Deep Notes

All Issues

~ Search JIRA for related Issues

SVC-2996

A

llDetectedLinkNumber returns 0 with llVolumeDetect(TRUE)

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 integer llDetectedLinkNumber( integer number );