EditLine

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

Note: To access the Property Sheet for EditLine, right-click the EditLine control and select Edit Function.

EditLine Inputs

Parameter

Description

Image

This argument must reference a spreadsheet cell that contains a valid Image data structure; by default, the cell references A0, the cell containing the Image data structure returned by AcquireImage function.

Fixture

Specifies the image coordinate system in which the input line 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 Point 0

Disables or enables the ability to adjust the input Point 0 position.

0 = OFF	Point 0 cannot be moved.
1 = ON (default)	Point 0 can be moved.

Move Point 1

Disables or enables the ability to adjust the input Point 1 position.

0 = OFF	Point 1 cannot be moved.
1 = ON (default)	Point 1 can be moved.

Name

Specifies a text label for the EditLine control element in the spreadsheet.

Show

Specifies the display mode for the EditLine graphics overlay on the image.

0 = hide all	The line will be hidden, except when the cell containing the EditLine function is highlighted in the spreadsheet.
2 = input graphics only	The line will be displayed at all times.

EditLine Outputs

Results

A result table will automatically be created in the cells adjacent to the right of the EditLine control.

The following Structures Vision Data Access Functions are automatically inserted into the spreadsheet to create the result table:

X0	GetX(Line,0)	The x-offset of the first endpoint, in image coordinates.
Y0	GetY(Line,0)	The y-offset of the first endpoint, in image coordinates.
X1	GetX(Line,1)	The x-offset of the second endpoint, in image coordinates.
Y1	GetY(Line,1)	The y-offset of the second endpoint, in image coordinates.