disparity_image_to_xyzT_disparity_image_to_xyzDisparityImageToXyzDisparityImageToXyz (Operator)

Name

disparity_image_to_xyzT_disparity_image_to_xyzDisparityImageToXyzDisparityImageToXyz — Transform a disparity image into 3D points in a rectified stereo system.

Signature

Description

Given the disparity image DisparityDisparityDisparityDisparitydisparity of a rectified binocular stereo system, disparity_image_to_xyzdisparity_image_to_xyzDisparityImageToXyzDisparityImageToXyzDisparityImageToXyz computes the corresponding 3D points. Their coordinates relative to the rectified camera 1 are stored as gray values in the images XXXXx, YYYYy, and ZZZZz, i.e., the pixels at the position (Row,Column) in XXXXx, YYYYy, and ZZZZz contain the x, y, and z coordinate, respectively, of the pixel (Row,Column) in the disparity image.

The rectified binocular camera system is specified by its internal camera parameters CamParamRect1CamParamRect1CamParamRect1CamParamRect1camParamRect1 of the rectified camera 1 and CamParamRect2CamParamRect2CamParamRect2CamParamRect2camParamRect2 of the rectified camera 2, and the external parameters RelPoseRectRelPoseRectRelPoseRectRelPoseRectrelPoseRect defining the pose of the rectified camera 2 in relation to the rectified camera 1. These camera parameters can be obtained from the operators calibrate_camerascalibrate_camerasCalibrateCamerasCalibrateCamerasCalibrateCameras and gen_binocular_rectification_mapgen_binocular_rectification_mapGenBinocularRectificationMapGenBinocularRectificationMapGenBinocularRectificationMap.

Attention

Stereo setups that contain cameras with and without hypercentric lenses at the same time are not supported.

Execution Information

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Automatically parallelized on tuple level.
• Automatically parallelized on domain level.

Parameters

Example (HDevelop)

disparity_image_to_xyz (ImageDisparity, ImgX, ImgY, ImgZ, RectCamParL, \
                        RectCamParR, RectLPosRectR)
get_region_points (ImageDisparity, Rows, Columns)
get_grayval (ImgX, Rows, Columns, XValues)
get_grayval (ImgY, Rows, Columns, YValues)
get_grayval (ImgZ, Rows, Columns, ZValues)

Result

The operator disparity_image_to_xyzdisparity_image_to_xyzDisparityImageToXyzDisparityImageToXyzDisparityImageToXyz returns the value 2 (H_MSG_TRUE) if the input is not empty. The behavior in case of empty input (no input image available) is set via the operator set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>). The behavior in case of empty region (the region is the empty set) is set via set_system('empty_region_result',<Result>)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>). If necessary an exception is raised.

Possible Predecessors

binocular_disparitybinocular_disparityBinocularDisparityBinocularDisparityBinocularDisparity

Possible Successors

thresholdthresholdThresholdThresholdThreshold, write_imagewrite_imageWriteImageWriteImageWriteImage

Alternatives

disparity_to_point_3ddisparity_to_point_3dDisparityToPoint3dDisparityToPoint3dDisparityToPoint3d, binocular_distancebinocular_distanceBinocularDistanceBinocularDistanceBinocularDistance

See also

binocular_calibrationbinocular_calibrationBinocularCalibrationBinocularCalibrationBinocularCalibration, gen_binocular_rectification_mapgen_binocular_rectification_mapGenBinocularRectificationMapGenBinocularRectificationMapGenBinocularRectificationMap, intersect_lines_of_sightintersect_lines_of_sightIntersectLinesOfSightIntersectLinesOfSightIntersectLinesOfSight

Module

3D Metrology