Cross

Creates a fixtured Cross structure.

Cross 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 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 will not be displayed unless the cell containing the Cross function is highlighted in the spreadsheet.
2 = input graphics only	The cross graphic will be displayed at all times.

Note: The Fixture and Cross parameters must be defined within the bounds of the image; otherwise, the function will return #ERR.

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