Difference between revisions of "LlDetectedGroup"

From Second Life Wiki
Jump to navigation Jump to search
m
m (Undo revision 1166823 by Rene Oldrich (Talk))
Line 6: Line 6:
|func_footnote=Returns [[FALSE]] if '''number''' is out of range.
|func_footnote=Returns [[FALSE]] if '''number''' is out of range.
|func_desc
|func_desc
|return_text=that is a {{HoverText|boolean|TRUE or FALSE}} representing if the {{LSLGC|Detected|detected}} object or avatar has the same active group that the prim containing the script is set to.
|return_text=that is [[TRUE]] if the detected [[object]] or [[agent]] has the same active [[group]] as the prim containing the script. It will return [[FALSE]] if the [[object]] or [[agent]] is in the [[group]], but the group is not active.
|spec
|spec
|caveats
|caveats

Revision as of 03:17, 4 May 2012

Summary

Function: integer llDetectedGroup( integer number );

Returns an integer that is TRUE if the detected object or agent has the same active group as the prim containing the script. It will return FALSE if the object or agent is in the group, but the group is not active.

• integer number Index of detection information

number does not support negative indexes. Returns FALSE if number is out of range.

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 this function returns FALSE 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]

Important Issues

~ All Issues ~ Search JIRA for related Bugs
   Attachments only change/inherit the active group when they're "rezzed"

Examples

<lsl>//Gives inventory only to agents with the same active group default {

   touch_start(integer total_number)
   {
       integer number = 0;
       do
       {
           if (llDetectedGroup(number)) //same as llSameGroup(llDetectedKey(number)) (with llSameGroup, detected must be in the sim)
               llGiveInventory(llDetectedKey(number), llGetInventoryName(INVENTORY_OBJECT,0));
           else
               llSay(0, "Wrong active group!");
       }while(total_number > ++number);
   }
}</lsl>

Notes

Child Prims

It is possible for the group of a child prim to differ from that of the root prim. To build such an object it must first be unlinked, the groups set, and then relinked. Rezzing an object resets the group of the object to that of the group that the user currently has activated. Changing the group of an object changes the group for the entire object. This may only be an artifact or manifestation of VWR-5044.

See Also

Functions

•  llSameGroup

Articles

•  Detected

Deep Notes

All Issues

~ Search JIRA for related Issues
   Attachments only change/inherit the active group when they're "rezzed"

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