# 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 A fixture is a coordinate location on the image that keeps the tool in the place determined by the fixture. or region input to another vision tool.
Inputs

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

TransPixelToWorld(Image, Calib, X, Y, Show)

See the table for a description of the available parameters.

Parameter | Description
Image | Reference to a cell containing an Image structure. Default = $A$0.
Calib | A reference to a spreadsheet cell containing a valid Calib data structure.
Point | Specifies the coordinates of the Point.
X | Pixel X-coordinate
Y | Pixel Y-coordinate
Show | Specifies the display mode for the TransPixelToWorld graphic overlay on the image.
0 = hide all (default) | The point is hidden, except when the cell containing the TransPixelToWorld function is highlighted in the spreadsheet.
2 = input graphics only | The point is always displayed.

Outputs

Returns | A 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 using the following Structures Vision Data Access functions
Label | Function | Description
X | GetX(Point) | The X-coordinate of the transformed point.
Y | GetY(Point) | The Y-coordinate of the transformed point.