# Circle

Creates a fixtured Circle structure.

Inputs

The Circle function Functions are tools that are available in Spreadsheet for processing and analyzing acquisitions or other results. You can add functions to your Spreadsheet job to create tool chains and produce results for specific applications. has the following syntax:

Circle(Image, X, Y, Theta, X, Y, Radius, Show)

See the table for a description of the available parameters.

Parameter | Description
Image | This argument must reference a spreadsheet cell that contains a valid Image data structure. By default, the cell referenced is cell A0, containing the Image data structure returned by the AcquireImage function.
Fixture A fixture is a coordinate location on the image that keeps the tool in the place determined by the 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 is not displayed unless the cell containing the circle function is highlighted in the spreadsheet.
2 = input graphics only | The circle structure graphic is always displayed.

Note: The Fixture and Circle parameters must be defined within the bounds of the image. Otherwise, the function returns #ERR.
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.