Line

Creates a fixtured Line structure.

Line Inputs

Parameter Description

Image

This argument must reference a spreadsheet cell that contains a valid Image data structure. By default, the cell referenced is $A$0, which contains the image data structure returned by AcquireImage.

Fixture

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

X

The x-offset from the image.

Y

The y-offset from the image.

Theta

The rotation from the image X axis, in the image coordinate system. (+/-360 degrees clockwise)

Line

Specifies the endpoints of the line.

X 0

The x-offset of the first endpoint.

Y 0

The y-offset of the first endpoint.

X 1

The x-offset of the second endpoint.

Y 1

The y-offset of the second endpoint.
Show

Specifies the display mode for the Line graphic overlay on the image.

0 = hide all (default)

The line structure will not be displayed unless the cell containing the Line function is highlighted in the spreadsheet.

2 = input graphics only

The line structure will be displayed at all times.
Note: The Fixture and Line parameters must be defined within the bounds of the image; otherwise, the function will return #ERR.

Line Outputs

Returns

A Line data structure, or #ERR if any of the input parameters are invalid.

Results

When Line is initially inserted into a cell, the following Structures Vision Data Access Functions are automatically inserted into the spreadsheet to create a result table:

Label Function Description

X 0

GetX(Line, 0)

The x-coordinate of the first endpoint, in image coordinates.

Y 0

GetY(Line, 0)

The y-coordinate of the first endpoint, in image coordinates.

X 1

GetX(Line, 1)

The x-coordinate of the second endpoint, in image coordinates.

Y 1

GetY(Line, 1)

The y-coordinate of the second endpoint, in image coordinates.