# Cross

Creates a fixtured Cross structure.

Inputs

The Cross 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:

Cross(Image, X, Y, Theta, X, Y, Angle, Width, Height, 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 A fixture is a coordinate location on the image that keeps the tool in the place determined by the fixture. | Specifies the image coordinate system in which the cross 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)
Cross | Specifies the size and position of the cross, in fixture coordinates.
X | The X-offset of the cross.
Y | The Y-offset of the cross.
Angle | Rotation from fixture X-axis.
Width | Width of the cross.
Height | Height of the cross.
Show | Specifies the display mode for the cross graphical overlay on the image.
0 = hide all (default) | The cross structure is not be displayed unless the cell containing the Cross function is highlighted in the spreadsheet.
2 = input graphics only | The cross graphic is always displayed.

Note: The Fixture and Cross parameters must be defined within the bounds of the image. Otherwise, the function returns #ERR.
Outputs

Returns | A Cross data structure, or #ERR if any of the input parameters are invalid.
Results | When Cross 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(Cross) | Returns the row offset of the center of the cross, in image coordinates.
Y | GetY(Cross) | Returns the column offset of the center of the cross, in image coordinates.
Angle | GetAngle(Cross) | Returns the orientation of the cross.
Height | GetHeight(Cross) | The height value.
Width | GetWidth(Cross) | The width value.