Annulus

Creates a fixtured Annulus structure.

Annulus Inputs

Parameter

Description

Image

This argument must reference a spreadsheet cell that contains a valid Image data structure. By default, the cell referenced is $A$0, which contains the image data structure returned by AcquireImage.

Fixture

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

X	The x-offset of the image.
Y	The y-offset of the image.
Theta	Rotation from image x-axis.

Annulus

Specifies the size and position of the annulus.

X	The x-offset, in fixture coordinates.
Y	The y-offset, in fixture coordinates.
Inner Radius	The inner radius.
Outer Radius	The outer radius.

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

Show

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

0 = hide all	The annulus structure graphic will not be displayed unless the cell containing the Annulus function is highlighted in the spreadsheet.
2 = input graphics only	The annulus structure graphic will be displayed at all times.

Annulus Outputs

Returns

An Annulus data structure, or #ERR if any of the input parameters are invalid.

Results

When Annulus is initially inserted into a cell, a result table is created in the spreadsheet with the following Structures Vision Data Access Functions

Label	Function	Description
X	GetX(Annulus)	The x-offset of the center of the annulus, in image coordinates.
Y	GetY(Annulus)	The y-offset of the center of the annulus, in image coordinates.
Inner Radius	GetRadius(Annulus, 0)	The inner radius of the indexed annulus.
Outer Radius	GetRadius(Annulus, 1)	The outer radius of the indexed annulus.