# Set Region3D

The Set Region3D command sets values on a Region3D structure and works only with a cell with an EditRegion3D function.

## Set Region3D Inputs

Syntax: ST<cellName> <sizeX> <sizeY> <sizeZ> <curve> <posX> <posY> <posZ> <rotation> <tilt> <tiltDirection>

Note: Note that ST<cellName> is one string element, meaning there is no space after ST. The other numerical parameters are separated by spaces.

Parameter | Description
--- | ---
cellName | The name of the Region3D.
sizeX | Size parameters of the Region3D.
sizeY
sizeZ
curve | The curvature parameter of the Region3D.
posX | Position parameters of the Region3D.
posY
posZ
rotation | Orientation parameters of the Region3D.
tilt
tiltDirection

## Set Region3D Outputs

Returns a status code. The status codes are:

Status Codes | Description
--- | ---
1 | The command was executed successfully.
0 | Unrecognized command.
-1 | The ID is invalid.
-2 | The command could not be executed because the specified cell does not contain an edit region control, or the edit region control was not created by the EditRegion3D function.
-4 | Wrong argument type.
-6 | User does not have Full Access to execute the command.

## Set Region3D Example

Set an edit region contained in cell A3 to a new location and dimensions.

1. Assume cell A3 is populated as follows: A3 = EditRegion3D($A$0,0,0,0,0,0,0,0,1,1,1,"region",0)

   The spreadsheet looks like this:

2. To change the location and dimensions of the region using the Set Region3D Native Mode command, issue the command STregion 50 50 20 5 10 10 10 20 40 10 as shown in the following telnet client window. The string region stands for the cell name:

   The In-Sight vision system responds with 1, indicating that the command was successfully executed: