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.

EditCircle Inputs

Parameter

Description

Image

This parameter must reference a spreadsheet cell that contains an Image data structure; by default, this parameter references A0, the cell containing the Image data structure returned by 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

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	Circle cannot be moved.
1 = ON (default)	Circle can be moved.

Size

Disables or enables the ability to adjust the input circle radius.

0 = OFF	Circle cannot be resized..
1 = ON (default)	Circle can be resized.

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 will be hidden, except when the cell containing the EditCircle function is highlighted in the spreadsheet.
2 = input graphics only	The circle will be displayed at all times.

EditCircle 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.