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. For more information, see Interactive Graphics Mode.

Note: To access the property sheet for an EditRegion control, right-click the control and select Edit Function.

EditRegion Inputs

Syntax: EditRegion(Image,Fixture.Row,Fixture.Column,Fixture.Theta,Move,Size,Rotate,Bend,Name,Show)

Parameter

Description

Image

This parameter must reference a spreadsheet cell that contains an Image data structure; by default, this parameter references A0, the cell containing the AcquireImage Image data structure. This parameter can also reference other Image data structures, such as those returned by the Vision Tool Image functions or Coordinate Transforms Functions. For more information, see Image or Coordinate Transforms Functions.

Fixture

Specifies the image coordinate system in which the input region is defined.

Row	The row offset, in image coordinates.
Column	The column offset, in image coordinates.
Theta	The orientation, in image coordinates.

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 will be hidden, except when the cell containing the EditRegion function is highlighted in the spreadsheet.
2 = input graphics only	The region will be displayed at all times.

EditRegion Outputs

Results

An EditRegion control, along with a corresponding results table that will be created in the adjacent cells to the right.

EditRegion Vision Data Access Functions

The following Vision Data Access functions are automatically inserted into the spreadsheet to create the result table. For more information, see Structures.

Row	GetRow(Region)	The x-coordinate of the position.
Col	GetCol(Region)	The y-coordinate of the position.
High	GetHigh(Region)	The height of the region.
Wide	GetWide(Region)	The width of the region.
Angle	GetAngle(Region)	The orientation of the region.
Curve	GetCurve(Region)	The curvature of the region.