NI Vision for LabVIEW

IMAQ Get Depth Planes From Stereo VI

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

Returns the X, Y and Z values (3D point coordinates) of all points in the input disparity image. The X, Y, and Z coordinate values are returned as separate images.

Examples

IMAQ Get Depth Planes From Stereo

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.

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.

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.

cgenclasstagrefflat.gif

X Plane Image In is a reference to the image that will contain the X coordinates of the points in the Disparity Image after the VI runs.

cgenclasstagrefflat.gif

Y Plane Image In is a reference to the image that will contain the Y coordinates of the points in the Disparity Image after the VI runs.

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.

cgenclasstagrefflat.gif

Z Plane Image In is a reference to the image that will contain the Z coordinates of the points in the Disparity Image after the VI runs. The values in this image will be the same as the values in the Depth Image returned by the IMAQ Get Depth Image From Stereo VI. This image is of type SGL.

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.

igenclasstagrefflat.gif

X Plane Image Out is the reference to the image that cotains the X coordinates of all valid points in the input Disparity Image. A NaN value is returned at points with invalid disparity.

igenclasstagrefflat.gif

Y Plane Image Out is the reference to the image that cotains the Y coordinates of all valid points in the input Disparity Image. A NaN value is returned at points with invalid disparity.

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.

igenclasstagrefflat.gif

Z Plane Image Out is the reference to the image that cotains the Z coordinates of all valid points in the input Disparity Image. A NaN value is returned at points with invalid disparity.

Examples

Refer to the following for examples that use this VI.

  • LabVIEW\examples\Vision\Stereo Vision

  • LabVIEW\examples\Vision\Stereo Vision

Log in to get a better experience