Point

Creates a fixtured Point structure.

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 point is defined.

X

The X-offset of the fixture.

Y

The Y-offset of the fixture.

Theta

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

Point

Specifies the location of the point, in fixture coordinates.

X

The X-coordinate of the point.

Y

The Y-coordinate of the point.
Show

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

0 = hide all (default)

The point structure is hidden unless the cell containing the Point function is highlighted in the spreadsheet.

2 = input graphics only

The point structure is always displayed.
Note: The Fixture and Point parameters must be defined within the bounds of the image. Otherwise, the function returns #ERR.

Returns

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

Results

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

Label Function Description

X

GetX(Point)

Returns an X-coordinate of the point.

Y

GetY(Point)

Returns an Y-coordinate of the point.