# EditCircle

Inserts an interactive circle control into the spreadsheet. When the control is clicked, the display switches to Interactive Graphics Mode, where the position and size of the circle can be adjusted.

Note: To access the Property Sheet for EditCircle, right-click the EditCircle control and select Edit 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..
Inputs

The EditCircle function has the following syntax:

EditCircle(Image, X, Y, Theta, Move, Size, Name, Show)

See the table for a description of the available parameters

Parameter | Description
Image | This parameter must reference a spreadsheet cell that contains an Image data structure. By default, this parameter references cell A0, the cell containing the Image data structure returned by the AcquireImage function. This parameter can also reference other Image data structures, such as those returned by the Vision Tool Image Functions or Coordinate Transforms Functions.
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 input circle is defined.
X | The X-offset of the origin, in fixture coordinates.
Y | The Y-offset of the origin, in fixture coordinates.
Theta | The rotation from the image X-axis, in the image coordinate system. (+/-360 degrees clockwise)
Move | Disables or enables the ability to adjust the input circle position.
0 = OFF | You cannot move the circle.
1 = ON (default) | You can move the circle.
Size | Disables or enables the ability to adjust the input circle radius.
0 = OFF | You cannot resize the circle.
1 = ON (default) | You can resize the circle.
Name | Specifies a text label for the EditCircle control element in the spreadsheet.
Show | Specifies the display mode for the EditCircle graphics overlay on the image.
0 = hide all | The circle is hidden, except when the cell containing the EditCircle function is highlighted in the spreadsheet.
2 = input graphics only | The circle is displayed at all times.

Outputs

Results | A result table will automatically be created in the cells adjacent to the right of the EditCircle control. The following Structures Vision Data Access functions are automatically inserted into the spreadsheet to create the result table
Label | Function | Description
X | GetX(Region) | The X coordinate of the position.
Y | GetY(Region) | The Y coordinate of the position.
Radius | GetRadius(Region) | The radius of the circle.