Get Data for Multiple Objects

11 June 2016

  • Release 9.90 - added.

Corrade can query multiple objects en-block using the getobjectsdata command.

Command Required Parameters Required Corrade Permissions Example
getobjectsdata group, password, entity, data interact 
llInstantMessage(CORRADE,
    wasKeyValueEncode(
        [
            // Get the position and primitive text
            // of all the objects rezzed in-world
            // in a 10 meters range from Corrade.
            "command", "getobjectsdata",
            "group", wasURLEscape(GROUP),
            "password", wasURLEscape(PASSWORD),
            "entity", "world",
            "range", "10",
            // returns the position and primitive text
            "data", wasListToCSV(
                [
                    "Position",
                    "Text"
                ]
            ),
            // to this URL
            "callback", wasURLEscape(URL)
        ]
    )
);

The data parameter follows the libopenmetaverse Primitive structure and sub-structures.

Parameter Possible Value Sub-Parameter Possible Value Description
entity range range A range in meters. Retrieves primitive data for all objects in the specified range where the range is the length of a versor from Corrade's current position describing a sphere.
world range A range in meters. Retrieves primitive data for all objects that are rezzed in-world (not attached to any avatar) in a given range.
parcel position An LSL 3D Vector. Retrieves primitive data for all objects on the parcel pin-pointed by position.
region Retrieves primitive data for all objects 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 primitive data for all objects worn on the specified avatar.
firstname
lastname

As the plural of the getobjectdata command, the getobjectsdata command will get the field specified in the data parameter for all objects that Corrade finds - based on the entity specified and its sub-parameters.

Notes