Get Locations of Region Parcels

14 October 2018

C10 - added.

getregionparcellocations (Commands)
Type	Corrade progressive command
Command	`getregionparcellocations`
Description	The `getregionparcellocations` command will return a CSV list of parcel name, by parcel local ID by describing vector.
Permissions	`land`
Parameters	`group`, `password`
Last Changes	C10 - added.

The getregionparcellocations command will return a CSV list of parcel name, by parcel local ID by describing vector.

Command	Required Parameters	Required Corrade Permissions	Example
`getregionparcellocations`	`group`, `password`	`land`	llInstantMessage(CORRADE, wasKeyValueEncode( [ "command", "getregionparcellocations", "group", wasURLEscape(GROUP), "password", wasURLEscape(PASSWORD), "callback", wasURLEscape(URL) ] ) );

Optional Parameters	Possible Value	Description
`region`	A string representing a region name.	Attempt to perform the command on the specified region. Note that Corrade must be connected to that region. If in doubt, please use the getconnectedregions command to determine whether the region you want to specify is currently connected. If the region is not specified, then Corrade assumes that the region is the region that Corrade is currently on.

Note

Since most commands that have to reference a parcel use descriptive vectors, this command will give you a list of parcels by their local IDs and by a single vector that falls within the parcel bounds.

The vector returned by this command represents a position that, when projected onto the simulator, will intersect a parcel surface. Let $\overrightarrow{v}$ be a descriptive vector, then the following illustration depicts a vector $\overrightarrow{v}$ falling within a parcel:

          y   ^                                  
                                                 
            /                                    
     255   --------------------------------------
          /region                              / 
                                              /  
        /                                    /   
                       |  -------------     /    
      /         v(x, y)| /           /     /     
                       |/           /     /      
    /                  v    parcel /     /       
                      /-----------/     /        
  /                                    /         
                                      /          
/ - - - - - - - - - - - - - - - - - -/- - - - -> 
                                               x 
                                   255

The scalar $z$ component of the descriptive vector returned by this command can be considered a nonce and is not to be used.