# Set Box

The Set Box command sets values on a Box3D structure and works only with a cell with an EditBox3D 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 Box Inputs

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

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

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

## Set Box Outputs

Error codes | Description
--- | ---
0 | Unrecognized command.
-1 | Invalid cell ID. This error code means that the cell is not found.
-2 | Command cannot be executed.
-4 | Wrong number of arguments, or they are not from the expected type.

## Set Box Example

To change the location and dimensions of a Box3D structure, issue the command with the corresponding values: SB<cellName> <sizeX> <sizeY> <sizeZ> <posX> <posY> <posZ> <rotation> <tilt> <tiltDirection>.

In the example, the command is: SBBox3D 90 90 50 10 20 30 0 0 0.

The In-Sight vision system responds with 1, indicating that editing the Box3D structure was successful.