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.
Parameter Description

Image

This argument must reference a spreadsheet cell that contains a valid Image data structure. By default, the cell references A0, containing the Image data structure returned by the 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 is hidden, except when the cell containing the EditLine function is highlighted in the spreadsheet.

2 = input graphics only

The line is displayed at all times.

Results

A result table is automatically 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:

Label Function Description

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.