# PointFromPixelAndPlane3D

PointFromPixelAndPlane3D maps an Image coordinate to a Point Cloud coordinate on the corresponding grey image.

Note: PointFromPixelAndPlane3D function only works between the Point Cloud and the grey image you get from GetGreyscale on that Point Cloud (A0 and A1). GetGreyscale is found under the PointCloud 3D Vision Data Access functions.

2D Coordinates | 3D Coordinates

Inputs

The PointFromPixelAndPlane3D function has the following syntax:

PointFromLineAndPlane3D(PointCloud,Image,Point,Plane3D,External Plane,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.
Point | Specifies the coordinates of the point.
X | The X coordinate of the point.
Y | The Y coordinate of the point.
Plane3D | Specifies the offset and the angle of the plane to use. It is offset from the PointCloud origin in the following format with the following arguments: {X, Y, Z, Tilt, TiltDirection}
X | Offset on the X-axis from the PointCloud origin.
Y | Offset on the Y-axis from the PointCloud origin.
Z | Offset on the Z-axis from the PointCloud origin.
Tilt | Specifies the tilt angle (in degrees) from the PointCloud Z-axis. The value range is 0-180. External references with values outside the allowed range will result in an error.
Tilt Direction | Specifies the direction of tilt (in degrees) from the plane's rotated PointCloud X-axis, about the tool's PointCloud Z-axis. The value range is -360 - 360. External references with values outside the allowed range will be normalized to the allowed range.
Note: This parameter is available only if External Plane is set to 0.
External Plane | Specifies a reference to a Rectangle3D or Circle3D structure defined in another cell to be used by the function. Set to 0 (OFF) to use the function's internal Plane3D structure instead.
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.