Difference between revisions of "LlGetAgentList"
Jump to navigation
Jump to search
Kelly Linden (talk | contribs) |
Kelly Linden (talk | contribs) |
||
| Line 14: | Line 14: | ||
|return_text=[key id0, key id1, ..., key idn] or [string error_msg] - returns avatar keys for all agents in the region limited to the area specified by flags | |return_text=[key id0, key id1, ..., key idn] or [string error_msg] - returns avatar keys for all agents in the region limited to the area specified by flags | ||
|spec= | |spec= | ||
|p1_type=integer|p1_name=max_agents|p1_desc=Maximum number of agents to return in the list.|p1_hover=max agents to return | |p1_type=integer|p1_name=max_agents|p1_desc=Maximum number of agents to return in the list. Must be greater than 0 and less than 200. |p1_hover=max agents to return | ||
|p2_type=integer|p2_name=flags|p2_desc=selection flags|p2_hover=selection flags | |p2_type=integer|p2_name=flags|p2_desc=selection flags|p2_hover=selection flags | ||
|constants= | |constants= | ||
Revision as of 13:32, 20 March 2012
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
|
LSL Feature Request |
| The described function does not exist. This article is a feature request. |
Summary
Function: list llGetAgentList( integer max_agents, integer flags );| REQUEST | Function ID |
| 0.0 | Forced Delay |
| 0 | Energy |
Requests a list of agents currently in the region, limited by the flags parameter.
- AGENT_LIST_PARCEL - returns only agents on the same parcel where the script is running.
- AGENT_LIST_PARCEL_OWNER - returns only agents on any parcel in the region where the parcel owner is the same as the owner of the parcel under the scripted object.
- AGENT_LIST_REGION - returns any/all agents in the region.
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 specified by flags
| • integer | max_agents | – | Maximum number of agents to return in the list. Must be greater than 0 and less than 200. | |
| • integer | flags | – | selection flags |
Caveats
Examples
<lsl>//Displays up to 50 avatar key: name pairs detected in the entire region list gaAgents; integer giMaxAgentsToReturn = 50;
default {
touch_start(integer total_number)
{
integer i;
integer liCount;
gaAgents = llGetAgentList(giMaxAgentsToReturn,AGENT_LIST_REGION);
liCount = llGetListLength(gaAgents);
if (liCount > 0)
if (llGetListEntryType(gaAgents,0) == TYPE_STRING)
llOwnerSay("Error: "+llList2String(gaAgents,0));
else
for (i=0; i < liCount; ++i)
llOwnerSay(llList2String(gaAgents,i)+": "+llKey2Name(llList2String(gaAgents,i)));
}
}</lsl>
Deep Notes
Search JIRA for related Issues
Signature |
|---|
//function list llGetAgentList( integer max_agents, integer flags ); |