# Set Region3D

The Set Region3D command sets values on a Region3D structure and works only with a cell with an EditRegion3D function Functions are tools that are available in Spreadsheet for processing and analyzing acquisitions or other results. You can add functions to your Spreadsheet job to create tool chains and produce results for specific applications..

## 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: