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