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. For more information, see Interactive Graphics Mode.

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

EditLine Inputs

Syntax: EditLine(Image,Fixture.Row,Fixture.Column,Fixture.Theta,Move Point 0,Move Point 1,Name,Show)

Parameter

Description

Image

This argument must reference a spreadsheet cell that contains a valid Image data structure. By default, the cell referenced is A0, the cell containing the Image data structure returned by AcquireImage.

Fixture

Specifies the image coordinate system in which the input line is defined.

Row	The row offset in image coordinates.
Column	The column offset in image coordinates.
Theta	The orientation in image coordinates.

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.

EditLine Vision Data Access Functions

The following Vision Data Access functions are automatically inserted into the spreadsheet to create the result table. For more information, see Structures.

Row0	GetRow(Line,0)	The row offset of the first endpoint, in image coordinates.
Col0	GetCol(Line,0)	The column offset of the first endpoint, in image coordinates.
Row1	GetRow(Line,1)	The row offset of the second endpoint, in image coordinates.
Col1	GetCol(Line,1)	The column offset of the second endpoint, in image coordinates.