Get Appearance Data for Multiple Avatars

22 April 2020

  • C10 - added.
getavatarsappearancedata (Commands)
TypeCorrade progressive command
Commandgetavatarsappearancedata
DescriptionThe getavatarsappearancedata returns fields or properties specified in data of all avatar appearances on the current simulator or specified parcel.
Permissionsinteract
Parametersgroup, password, entity, data
Last ChangesNone.

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.

secondlife/scripted_agents/corrade/api/commands/getavatarsappearancedata.txt ยท Last modified: 2020/09/04 07:20 (external edit)

Access website using Tor Access website using i2p Wizardry and Steamworks PGP Key


For the copyright, license, warranty and privacy terms for the usage of this website please see the license, privacy, copyright and the plagiarism pages.