11 June 2016
getobjectsdata (Commands) | |
---|---|
Type | Corrade progressive command |
Command | getobjectsdata |
Description | Corrade can query multiple objects en-block using the getobjectsdata command. |
Permissions | interact |
Parameters | group , password , entity , data |
Last Changes | 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.