14 May 2015
entity parameter and scoping based on entity.10 May 2015
| getavatarsdata (Commands) | |
|---|---|
| Type | Corrade progressive command |
| Command | getavatarsdata |
| Description | The getavatarsdata returns fields or properties specified in data of all avatars on the current simulator or specified parcel. |
| Permissions | interact |
| Parameters | group, password, entity, data |
| Last Changes | Release 8.11 - added the required entity parameter and scoping based on entity. |
The getavatarsdata returns fields or properties specified in data of all avatars on the current simulator or specified parcel.
| Command | Required Parameters | Required Corrade Permissions | Example |
|---|---|---|---|
getavatarsdata | group, password, entity, data | interact | llInstantMessage(CORRADE, wasKeyValueEncode( [ // retrieves the visual parameters // of all the avatars in a 10m // range from Corrade. "command", "getavatarsdata", "group", wasURLEscape(GROUP), "password", wasURLEscape(PASSWORD), "entity", "range", "range", 10, "data", "VisualParameters", "callback", wasURLEscape(URL) ] ) ); |
The data parameter can be supplied a CSV list of fields or properties from the libopenmetaverse Avatar structure and the libopenmetaverse Primitive structure.
| Parameter | Possible Value | Sub-Parameter | Possible Value | Description |
|---|---|---|---|---|
entity | range | range | A range in meters. | Retrieves avatar data for all avatars in the specified range where the range is the length of a versor from Corrade's current position describing a sphere. |
parcel | position | An LSL 3D Vector. | Retrieves avatar data for all avatars on the parcel pin-pointed by position. |
|
region | Retrieves avatar data for all avatars on the current region. | |||
avatar | agent | Either an avatar UUID passed to agent or the firstname passed to firstname and lastname passed to lastname | Retrieves avatar data for the specified avatar. | |
firstname |
||||
lastname |
getavatarsdata command will retrieve the fields specified in the data parameter for all avatars that Corrade finds - based on the entity specified and its sub-parameters.