Get Appearance Data for Multiple Avatars

22 April 2020

C10 - added.

getavatarsappearancedata (Commands)
Type	Corrade progressive command
Command	`getavatarsappearancedata`
Description	The `getavatarsappearancedata` returns fields or properties specified in `data` of all avatar appearances on the current simulator or specified parcel.
Permissions	`interact`
Parameters	`group`, `password`, `entity`, `data`
Last Changes	None.

The getavatarsappearancedata returns fields or properties specified in data of all avatar appearances on the current simulator or specified parcel.

Command Required Parameters Required Corrade Permissions Example

getavatarsappearancedata

group, password, entity, data

interact

llInstantMessage(CORRADE,
    wasKeyValueEncode(
        [
            // retrieves the visual parameters
            // of all the avatars in a 10m
            // range from Corrade.
            "command", "getavatarsappearancedata",
            "group", wasURLEscape(GROUP),
            "password", wasURLEscape(PASSWORD),
            "entity", "range",
            "range", 10,
            "data", wasCSVToList([
                "AvatarID",
                "VisualParameters",
            ]),
            "callback", wasURLEscape(URL)
        ]
    )
);

The data parameter can be supplied a CSV list of fields or properties from the libopenmetaverse AvatarAppearanceEventArgs structure.

Parameter	Possible Value	Sub-Parameter	Possible Value	Description
`entity`	`range`	`range`	A range in meters.	Retrieves avatar appearance 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 appearance data for all avatars on the parcel pin-pointed by `position`.
	`region`			Retrieves avatar appearance 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 appearance data for the specified avatar.
		`firstname`
		`lastname`

Notes

As the plural of the getavatarappearancedata command, the getavatarsappearancedata 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.
In case you aim to just receive avatar appearances, then the the appearance notification is more suitable.
Please see the the getavatardata command on a description of the VisualParams property.
There is also a named plural command batchgetavatarappearancedata that will retrieve appearance data for a known list of avatars.
In case the AvatarID property is not queried there is no way of correlating the received data with a particular avatar.
This command is radar-bound.