Region

Creates a fixtured Region structure.

Region Inputs

Region(Fixture.Row,Fixture.Column,Fixture.Theta,Region.X,Region.Y,Region.High,Region.Wide,Region.Angle,Region.Curve,Show)

Note: The Fixture and Region parameters must be defined within the bounds of the image; otherwise, the function will return #ERR.

Parameter

Description

Fixture

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

Row	The row offset.
Column	The column offset.
Theta	The orientation.

Region

Specifies the position, size, rotation, and curvature (if an annular sector, shaped like a circle or ring). Regions are always defined within the coordinate system of a Fixture. For more information, see Fixture.

X	The x-offset of the origin, in fixture coordinates.
Y	The y-offset of the origin, in fixture coordinates.
High	The dimension along the region's x-axis.
Wide	The dimension along the region's y-axis.
Angle	The orientation, in fixture coordinates.
Curve	The angular deviation between the region's x-axis and the opposing boundary line.

Show

Specifies the display mode for the Region graphic overlay on the image.

0 = hide all (default)	The region structure graphic will be hidden unless the cell containing the Region function is highlighted in the spreadsheet.
2 = input graphics only	The region structure graphic is displayed at all times.

Region Outputs

Returns	A Region data structure, or #ERR if any of the input parameters are invalid.
Results	When Region is initially inserted into a cell, a result table is created in the spreadsheet.

Region 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 row offset of the region's origin, in image coordinates.
Col	GetCol(Region)	The column offset of the region's origin, in image coordinates.
High	GetHigh(Region)	The dimension along the region's x-axis.
Wide	GetWide(Region)	The dimension along the region's y-axis.
Angle	GetAngle(Region)	The orientation, in image coordinates.
Curve	GetCurve(Region)	The angular deviation between the region's x-axis and the opposing boundary line.