# PointFromPixel

The PointFromPixel function 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,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. 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.