# EditRegion

Inserts an interactive graphical region control into the spreadsheet. When the control is clicked, the display switches to Interactive Graphics Mode where the size, position, rotation, and curvature of the region can be adjusted.

Note: To access the Property Sheet for an EditRegion control, right-click the control and select Edit 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..
Inputs

The EditRegion function has the following syntax:

EditRegion(Image, X, Y, Theta, Move, Size, Rotate, Bend, Name, Show)

See the table for a description of the available parameters:

Parameter | Description
Image | This parameter must reference a spreadsheet cell that contains an Image data structure. By default, this parameter references cell A0, the cell containing the Image data structure returned by the AcquireImage function. This parameter can also reference other Image data structures, such as those returned by the Vision Tool Image Functions or Coordinate Transforms Functions.
Fixture A fixture is a coordinate location on the image that keeps the tool in the place determined by the fixture. | Specifies the image coordinate system in which the input region is defined.
X | Offset from image X origin.
Y | Offset from image Y origin.
Theta | The rotation from the image X-axis, in the image coordinate system. (+/-360 degrees clockwise)
Move | Disables or enables the ability to adjust the input region position.
0 = OFF | The region cannot be moved.
1 = ON (default) | The region can be moved.
Size | Disables or enables the ability to adjust the input region height and width.
0 = OFF | The height and width cannot be adjusted.
1 = ON (default) | The height and width can be adjusted.
Rotate | Disables or enables the ability to adjust the input region orientation.
0 = OFF | The region cannot be rotated.
1 = ON (default) | The region can be rotated.
Bend | Disables or enables adjustment capability of the input region curvature.
0 = OFF | The curvature cannot be modified.
1 = ON (default) | The curvature can be modified.
Name | Specifies a text label for the EditRegion control element in the spreadsheet.
Show | Specifies the display mode for the EditRegion graphical overlay on top of the image.
0 = hide all (default) | The region is hidden, except when the cell containing the EditRegion function is highlighted in the spreadsheet.
2 = input graphics only | The region is displayed at all times.

Outputs

Results | An EditRegion control, along with a corresponding results table that is created in the adjacent cells to the right. The following Structures Vision Data Access functions are automatically inserted into the spreadsheet to create the result table:
Label | Function | Description
X | GetX(Region) | The X coordinate of the position.
Y | GetY(Region) | The Y coordinate of the position.
Width | GetWidth(Region) | The width of the region.
Height | GetHeight(Region) | The height of the region.
Angle | GetAngle(Region) | The orientation of the region.
Curve | GetCurve(Region) | The curvature of the region.