Difference between revisions of "LlGetAgentList"
Jump to navigation
Jump to search
All Issues ~ Search JIRA for related Bugs
m |
m |
||
| Line 26: | Line 26: | ||
{{LSL Tip|To check if an avatar is in the same sim, please check whether [[llGetAgentSize]] does NOT return [[ZERO_VECTOR]]. It's much faster and easier than calling [[llGetAgentList]] and running through the list to compare a given key with each list item.}} | {{LSL Tip|To check if an avatar is in the same sim, please check whether [[llGetAgentSize]] does NOT return [[ZERO_VECTOR]]. It's much faster and easier than calling [[llGetAgentList]] and running through the list to compare a given key with each list item.}} | ||
{{LSL Tip|As of now, this function does not have a delimiter for its option list. This means, the function MIGHT return up to a hundred avatar keys. You'll need a lot of free memory to be able to store those keys, be warned of possible STACK_HEAP_COLLISION_ERRORs.}} | {{LSL Tip|As of now, this function does not have a delimiter for its option list. This means, the function MIGHT return up to a hundred avatar keys. You'll need a lot of free memory to be able to store those keys, be warned of possible STACK_HEAP_COLLISION_ERRORs.}} | ||
< | <source lang="lsl2"> | ||
//Displays up to 100 avatar key: name pairs detected in the entire region | //Displays up to 100 avatar key: name pairs detected in the entire region | ||
| Line 54: | Line 54: | ||
} | } | ||
} | } | ||
</ | </source> | ||
< | <source lang="lsl2"> | ||
// Orders new list based on distance | // Orders new list based on distance | ||
// and returns names and distances on touch | // and returns names and distances on touch | ||
| Line 86: | Line 86: | ||
} | } | ||
} | } | ||
</ | </source> | ||
|helpers | |helpers | ||
|also_header | |also_header | ||
Revision as of 01:34, 22 January 2015
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: list llGetAgentList( integer scope, list options );| ? | Function ID |
| 0 | Forced Delay |
| 0 | Energy |
Requests a list of agents currently in the region, limited by the scope parameter.
Returns a list [key id0, key id1, ..., key idn] or [string error_msg] - returns avatar keys for all agents in the region limited to the area(s) specified by scope
| • integer | scope | – |
|
|||
| • list | options | – | Unused. |
Caveats
- There is no guaranteed understandable order or randomness to the list returned.
- Will only return up to 100 agents.
Examples
 |
Important: To check if an avatar is in the same sim, please check whether llGetAgentSize does NOT return ZERO_VECTOR. It's much faster and easier than calling llGetAgentList and running through the list to compare a given key with each list item. |
|
Important: As of now, this function does not have a delimiter for its option list. This means, the function MIGHT return up to a hundred avatar keys. You'll need a lot of free memory to be able to store those keys, be warned of possible STACK_HEAP_COLLISION_ERRORs. |
//Displays up to 100 avatar key: name pairs detected in the entire region
default
{
touch_start(integer total_number)
{
list avatarsInRegion = llGetAgentList(AGENT_LIST_REGION, []);
integer numOfAvatars = llGetListLength(avatarsInRegion);
// if no avatars, abort avatar listing process and give a short notice
if (!numOfAvatars)
{
llOwnerSay("No avatars found within the region!");
return;
}
integer index;
while (index < numOfAvatars)
{
key id = llList2Key(avatarsInRegion, index);
string name = llKey2Name(id);
llOwnerSay(name + " [ " + (string)id + " ]");
++index;
}
}
}
// Orders new list based on distance
// and returns names and distances on touch
default
{
touch_start(integer num_detected)
{
list keys = llGetAgentList(AGENT_LIST_REGION, []);
integer numberOfKeys = llGetListLength(keys);
vector currentPos = llGetPos();
list newkeys;
key thisAvKey;
integer i;
for (i = 0; i < numberOfKeys; ++i) {
thisAvKey = llList2Key(keys,i);
newkeys += [llRound(llVecDist(currentPos,
llList2Vector(llGetObjectDetails(thisAvKey, [OBJECT_POS]), 0))),
thisAvKey];
}
newkeys = llListSort(newkeys, 2, FALSE); // sort strided list by descending distance
for (i = 0; i < (numberOfKeys * 2); i += 2) {
llOwnerSay(llGetDisplayName(llList2Key(newkeys, i+1))
+" ["+ (string) llList2Integer(newkeys, i) + "m]");
}
}
}
See Also
Deep Notes
History
- New function proposed by LL, reconciling the feature suggestions SVC-805, SVC-6427, MISC-243 and SVC-5488.
- Pre-Released Release_Notes/Second_Life_RC_Magnum/12 - Original JIRA requested "llGetRegionAgents()", the name changed since the released function does more.
- Date of Release 30/04/2012
All Issues
~ Search JIRA for related Issues
|
|
SCR-311 | A | llGetAgentList() with scope AGENT_LIST_PARCEL or AGENT_LIST_PARCEL_OWNER returns empty list when attached to avatar | |
|
|
SCR-370 | A | llGetNumberOfAgents() function to return an integer count of agents | |
|
|
|
SCR-371 | A | AGENT_LIST_MAX_RESULTS option for llGetAgentList()
|
Signature |
|---|
function list llGetAgentList( integer scope, list options ); |