Table of Contents

Get Data for Multiple Primitives

11 June 2016

  • Release 9.90 - added the world entity.

14 May 2015

  • Release 8.11 - added the entity required parameter and added scoping based on entity.

10 May 2015

  • Release 8.6 - added.

Corrade can query multiple primitives en-block using the getprimitvesdata command.

Command Required Parameters Required Corrade Permissions Example
getprimitivesdata group, password, entity, data interact 
llInstantMessage(CORRADE,
    wasKeyValueEncode(
        [
            // Get the name, position and overhead text
            // of all the primitives in a parcel on
            // the current region pin-pointed by the
            // specified vector position.
            "command", "getprimitivesdata",
            "group", wasURLEscape(GROUP),
            "password", wasURLEscape(PASSWORD),
            "entity", "parcel",
            "position", wasURLEscape("<128, 32, 16>"),
            // returns the position and primitive text
            "data", wasListToCSV(
                [
                    "Properties.Name",
                    "Position",
                    "Text"
                ]
            ),
            "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 primitives 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 primitives 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 primitives on the parcel pin-pointed by position.
region Retrieves primitive data for all primitives 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 primitives worn on the specified avatar.
firstname
lastname

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

Remarks

The getprimitivesdata command is relatively-speaking unreliable compared to, say getprimitiveowners that retrieves the owners of all the primitives on a parcel or region. However, contrasted to getprimitiveowners, the getprimitivesdata command can be used without requiring any permissions. In other words, getprimitivesdata would be the only way to account for the owners of primitives on a parcel if land permissions cannot be granted to Corrade.

Notes