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.

Inputs

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

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.