# Fixture

Creates a Fixture A fixture is a coordinate location on the image that keeps the tool in the place determined by the fixture. structure.

Inputs

The Fixture function Functions are tools that are available in Spreadsheet for processing and analyzing acquisitions or other results. You can add functions to your Spreadsheet job to create tool chains and produce results for specific applications. has the following syntax:

Fixture(Image, X, Y, Theta, Show)

See the table for a description of the available parameters.

Parameter | Description
Image | This argument must reference a spreadsheet cell that contains a valid Image data structure. By default, the cell referenced is cell A0, containing the Image data structure returned by the AcquireImage function.
Fixture | Specifies the image coordinate system in which the fixture is defined.
X | The X-offset.
Y | The Y-offset.
Theta | The rotation from the image X-axis, in the image coordinate system. (+/-360 degrees clockwise)
Show | Specifies the display mode for the Fixture point graphical overlay on the image.
0 = hide all (default) | The fixture point graphic is not be displayed unless the cell containing the Fixture function is highlighted in the spreadsheet.
2 = input graphics only | The fixture point graphic is always displayed.

Outputs

Returns | A Fixture data structure, or #ERR if any of the input parameters are invalid.
Results | When Fixture 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 | GetX(Fixture) | Returns the X-offset of the fixture, in image coordinates.
Y | GetY(Fixture) | Returns the Y-offset of the fixture, in image coordinates.
Angle | GetAngle(Fixture) | Returns the orientation angle, in image coordinates.