TransPixelToWorld

Converts a point from pixel coordinates to real-world coordinates.

Note: The output of any vision tool that reports in real-world coordinates cannot be used as a fixture or region input to another vision tool.

TransPixelToWorld Inputs

Syntax: TransPixelToWorld(Calib,Point.Row,Point.Column,Show)

Parameter Description

Calib

This argument must reference a spreadsheet cell that contains a valid Calib data structure.

Point

Specifies the coordinates of the Point.

Row

The row coordinate of the point.

Column

The column coordinate of the point.

Show

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

0 = hide all (default)

The point will be hidden, except when the cell containing the TransPixelToWorld function is highlighted in the spreadsheet.

2 = input graphics only

The point will be displayed at all times.

TransPixelToWorld Outputs

Returns

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

Results

When the function is initially inserted into a cell, a result table is created in the spreadsheet.

TransPixelToWorld Vision Data Access Functions

The Vision Data Access functions automatically inserted into the spreadsheet to create the results table are as follows:

X

GetRow(Point)

The x-coordinate of the transformed point.

Y

GetCol(Point)

The y-coordinate of the transformed point.

For more information, see Structures, Fixture, Point, Calibrate, or Property Sheet.