IMAQ Convert Pixel To 3D Coordinates VI
- Updated2023-02-21
- 6 minute(s) read
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.
![]()
![]() |
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. |
||||||
![]() |
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.
|
||||||
![]() |
Binocular Stereo Session is the reference to the binocular stereo vision session on which this VI operates. |
||||||
![]() |
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. |
||||||
![]() |
Pixel Coordinates is a cluster of pixel coordinates to convert to real-world 3D coordinates. |
||||||
![]() |
Array of Pixel Coordinates is an array of pixel coordinate clusters to convert to real-world 3D coordinates. |
||||||
![]() |
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.
|
||||||
![]() |
Depth Control controls the range of depth values that are valid for the system. If the value is out of range, NaN is returned. |
||||||
![]() |
Valid Coordinates returns TRUE if the output Real World 3D Coordinates has been computed with a valid disparity value. |
||||||
![]() |
Binocular Stereo Session (dup) is the reference to the stereo vision session on which this VI operates. |
||||||
![]() |
Disparity Image (duplicate) is a reference to the input Disparity Image. |
||||||
![]() |
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). |
||||||
![]() |
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. |
||||||
![]() |
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.
|
||||||
![]() |
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


















