NI Vision for LabVIEW

IMAQ Convert Pixel To 3D Coordinates VI

  • Updated2023-02-21
  • 6 minute(s) read
Owning Palette: Locate Edges
Requires: NI Vision Development Module

Transforms pixel coordinates into real-world 3D coordinates according to the disparity value at the input pixel coordinates and the stereo calibration information present in the Binocular Stereo Session.

Examples

IMAQ Convert Pixel To 3D Coordinates

csgl.gif

Invalid Disparity Value is the pixel value assigned to invalid disparity values in the input Disparity Image. Use the same value that was used either in the IMAQ Stereo Correspondence (Block Matching) VI or IMAQ Stereo Correspondence (SG Block Matching) VI.

ccclst.gif

Relative Coordinate System specifies the relative position (offset) of the coordinate system with respect to the coordinate system that is centered on the left camera in which the real-world points are returned.

cnclst.gif

Translation specifies the X, Y, and Z translation offsets of the new coordinate system from the coordinate system centered on the left camera.

cnclst.gif

Rotation specifies the rotation about the X, Y, and Z values of the new coordinate system from the coordinate system centered on the left camera. The angles are given in radians.

crn.gif

Binocular Stereo Session is the reference to the binocular stereo vision session on which this VI operates.

cgenclasstagrefflat.gif

Disparity Image is the reference to the image that contains the disparity values. This image is the output of the IMAQ Stereo Correspondence (Block Matching) VI or IMAQ Stereo Correspondence (SG Block Matching) VI.

cnclst.gif

Pixel Coordinates is a cluster of pixel coordinates to convert to real-world 3D coordinates.

c1dnclst.gif

Array of Pixel Coordinates is an array of pixel coordinate clusters to convert to real-world 3D coordinates.

cerrcodeclst.gif

error in (no error) describes the error status before this VI or function runs. The default is no error. If an error occurred before this VI or function runs, the VI or function passes the error in value to error out. This VI or function runs normally only if no error occurred before this VI or function runs. If an error occurs while this VI or function runs, it runs normally and sets its own error status in error out. Use the Simple Error Handler or General Error Handler VIs to display the description of the error code. Use error in and error out to check errors and to specify execution order by wiring error out from one node to error in of the next node.

cbool.gif

status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE.

ci32.gif

code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.

cstr.gif

source describes the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning. The default is an empty string.

cnclst.gif

Depth Control controls the range of depth values that are valid for the system. If the value is out of range, NaN is returned.

ibool.gif

Valid Coordinates returns TRUE if the output Real World 3D Coordinates has been computed with a valid disparity value.

irn.gif

Binocular Stereo Session (dup) is the reference to the stereo vision session on which this VI operates.

igenclasstagrefflat.gif

Disparity Image (duplicate) is a reference to the input Disparity Image.

inclst.gif

Real World 3D Coordinates returns a cluster of real-world point coordinates that correspond to the points specified by Pixel Coordinates. The real-world coordinates (X, Y, Z) are computed by using the value in the Disparity Image at the coordinates specified by the Pixel Coordinates, and the values of the coorindates (X,Y).

i1dnclst.gif

Array of Real World 3D Coordinates is an array of real-world point coordinates corresponding to the array of pixel coordinates specified by Array of Pixel Coordinates.

ierrcodeclst.gif

error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces. Right-click the error out indicator on the front panel and select Explain Error from the shortcut menu for more information about the error.

ibool.gif

status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.

ii32.gif

code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.

istr.gif

source describes the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning. The default is an empty string.

i1dbool.gif

Array of Valid Coordinates is an array of Boolean values specifying whether each transformation of the Array of Pixel Coordinates is valid, according to if the value in the Disparity Image at that pixel coordinate is valid.

Examples

Refer to the following for examples that use this VI.

  • LabVIEW\examples\Vision\Stereo Vision\Compute Depth Image\Compute Depth Image.vi

Log in to get a better experience