# PointFromPixel

The PointFromPixel 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. constructs a 3D point from a 2D Point. The constructed point is returned in a Point3D structure.

Note: The input 2D point is defined in pixel coordinates, while the constructed Point3D is defined in real-world unit coordinates.

2D Point | Point3D Structure

Inputs

The PointFromPixel function has the following syntax:

PointFromPixel(PointCloud A point cloud is a 3D structure that consists of the data points collected by a 3D vision system during acquisition.,Image,PixelX,PixelY,ExternalPixelPoint,Show)

See the table for a description of the available parameters.

Parameter | Description
PointCloud | Reference to a cell containing a point cloud A point cloud is a 3D structure that consists of the data points collected by a 3D vision system during acquisition.. The default value is $A$0.
Image | Reference to a cell containing an Image structure. The default value is $A$1.
PixelX | Pixel X-coordinate.
PixelY | Pixel Y-coordinate.
External Pixel Point | Specifies a reference to an external pixel point defined in another cell. Set to 0 (OFF) to use the internal Pixel of the function.
Show | Selects the type of graphics to overlay on the image.
0 = hide all (default) | All graphics are hidden, except when the cell containing the function is highlighted in the spreadsheet.
1 = result graphics only | The result graphics of the function are displayed at all times.
2 = input and result graphics | The region of interest, the input data and the results are displayed at all times.

Outputs

Returns | A Point3D data structure containing the constructed 3D point, or #ERR if any of the input parameters are invalid.
Results | When initially inserted into a cell, the following functions are automatically inserted into the spreadsheet to create a result table.
| X | Y | Z
❒Point3D | GetX(Point3D) | GetY(Point3D) | GetZ(Point3D)

Vision Data Access functions

The following Structures 3D Vision Data Access functions are automatically inserted into the spreadsheet to create the result table:

Function | Description
GetX(Point3D) | Returns the X-axis coordinate of the 3D point.
GetY(Point3D) | Returns the Y-axis coordinate of the 3D point.
GetZ(Point3D) | Returns the Z-axis coordinate of the 3D point.