Upload and Download Terrain

7 June 2015

Release 8.22 - added the optional region parameter.

14 December 2014

Release 7.28 - Corrade now returns or takes the terrain as a Base64 encoded string passed to the data key.

terrain (Commands)
Type	Corrade progressive command
Command	`terrain`
Description	The `terrain` command can download and upload terrains for a region.
Permissions	`land`
Parameters	`group`, `password`, `action`
Last Changes	Release 8.22 - added the optional `region` parameter.

The terrain command can download and upload terrains for a region:

it can upload a terrain by sending the raw terrain file as a Base64 string passed to the data key when the command's action is set.
it can download a terrain by returning a Base64 encoded raw terrain file as the value of the data key.

Command Required Parameters Required Corrade Permissions Example

Command	Required Parameters	Required Corrade Permissions	Example
`terrain`	`group`, `password`, `action`	`land`	llInstantMessage(CORRADE, wasKeyValueEncode( [ // fetch the terrain for the current region // that Corrade is currently on "command", "terrain", "group", wasURLEscape(GROUP), "password", wasURLEscape(PASSWORD), "action", "get", // get the raw terrain for the current region // and send it as a Base64 encoded string in // the "data" key of the callback string "callback", wasURLEscape(URL) ] ) );

terrain

group, password, action

land

llInstantMessage(CORRADE,
    wasKeyValueEncode(
        [
            // fetch the terrain for the current region
            // that Corrade is currently on
            "command", "terrain",
            "group", wasURLEscape(GROUP),
            "password", wasURLEscape(PASSWORD),
            "action", "get",
            // get the raw terrain for the current region
            // and send it as a Base64 encoded string in
            // the "data" key of the callback string
            "callback", wasURLEscape(URL)
        ]
    )
);

Optional Parameter	Possible Values	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.