Circle

Creates a fixtured Circle structure.

Circle 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 circle is defined.

X	The x-offset of the fixture.
Y	The y-offset of the fixture.
Theta	Offset from fixture origin.

Circle

Specifies the size and position of the circle, in fixture coordinates.

X	The x-offset of the circle.
Y	The y-offset of the circle.
Radius	The radius of the circle.

Show

Selects the type of graphics to overlay on the image.

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

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

Circle Outputs

Returns

A Circle data structure, or #ERR if any of the input parameters are invalid.

Results

When Circle 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(Circle)	The x-coordinate.
Y	GetY(Circle)	The y-coordinate.
Radius	GetRadius(Circle)	The radius of the circle.