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.

getprimitivesdata (Commands)
Type	Corrade progressive command
Command	`getprimitvesdata`
Description	Corrade can query multiple primitives en-block using the `getprimitvesdata` command.
Permissions	`interact`
Parameters	`group`, `password`, `entity`, `data`
Last Changes	Release 8.11 - added the `entity` required parameter and added scoping based on `entity`.

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

This command is radar-bound.

Table of Contents

Get Data for Multiple Primitives

Remarks

Notes