disparity_to_point_3d T_disparity_to_point_3d DisparityToPoint3d DisparityToPoint3d disparity_to_point_3d (Operator)
Name
disparity_to_point_3d T_disparity_to_point_3d DisparityToPoint3d DisparityToPoint3d disparity_to_point_3d
— Transform an image point and its disparity into a 3D point in a
rectified stereo system.
Signature
void DisparityToPoint3d (const HTuple& CamParamRect1 , const HTuple& CamParamRect2 , const HTuple& RelPoseRect , const HTuple& Row1 , const HTuple& Col1 , const HTuple& Disparity , HTuple* X , HTuple* Y , HTuple* Z )
void HCamPar ::DisparityToPoint3d (const HCamPar& CamParamRect2 , const HPose& RelPoseRect , const HTuple& Row1 , const HTuple& Col1 , const HTuple& Disparity , HTuple* X , HTuple* Y , HTuple* Z ) const
void HCamPar ::DisparityToPoint3d (const HCamPar& CamParamRect2 , const HPose& RelPoseRect , double Row1 , double Col1 , double Disparity , double* X , double* Y , double* Z ) const
void HPose ::DisparityToPoint3d (const HCamPar& CamParamRect1 , const HCamPar& CamParamRect2 , const HTuple& Row1 , const HTuple& Col1 , const HTuple& Disparity , HTuple* X , HTuple* Y , HTuple* Z ) const
void HPose ::DisparityToPoint3d (const HCamPar& CamParamRect1 , const HCamPar& CamParamRect2 , double Row1 , double Col1 , double Disparity , double* X , double* Y , double* Z ) const
static void HOperatorSet .DisparityToPoint3d (HTuple camParamRect1 , HTuple camParamRect2 , HTuple relPoseRect , HTuple row1 , HTuple col1 , HTuple disparity , out HTuple x , out HTuple y , out HTuple z )
void HCamPar .DisparityToPoint3d (HCamPar camParamRect2 , HPose relPoseRect , HTuple row1 , HTuple col1 , HTuple disparity , out HTuple x , out HTuple y , out HTuple z )
void HCamPar .DisparityToPoint3d (HCamPar camParamRect2 , HPose relPoseRect , double row1 , double col1 , double disparity , out double x , out double y , out double z )
void HPose .DisparityToPoint3d (HCamPar camParamRect1 , HCamPar camParamRect2 , HTuple row1 , HTuple col1 , HTuple disparity , out HTuple x , out HTuple y , out HTuple z )
void HPose .DisparityToPoint3d (HCamPar camParamRect1 , HCamPar camParamRect2 , double row1 , double col1 , double disparity , out double x , out double y , out double z )
def disparity_to_point_3d (cam_param_rect_1 : Sequence[Union[int, float, str]], cam_param_rect_2 : Sequence[Union[int, float, str]], rel_pose_rect : Sequence[Union[int, float]], row_1 : MaybeSequence[Union[int, float]], col_1 : MaybeSequence[Union[int, float]], disparity : MaybeSequence[Union[int, float]]) -> Tuple[Sequence[float], Sequence[float], Sequence[float]]
def disparity_to_point_3d_s (cam_param_rect_1 : Sequence[Union[int, float, str]], cam_param_rect_2 : Sequence[Union[int, float, str]], rel_pose_rect : Sequence[Union[int, float]], row_1 : MaybeSequence[Union[int, float]], col_1 : MaybeSequence[Union[int, float]], disparity : MaybeSequence[Union[int, float]]) -> Tuple[float, float, float]
Description
Given an image point of the rectified camera 1, specified by its
image coordinates (Row1 Row1 Row1 row1 row_1
,Col1 Col1 Col1 col1 col_1
), and its disparity
in a rectified binocular stereo system,
disparity_to_point_3d disparity_to_point_3d DisparityToPoint3d DisparityToPoint3d disparity_to_point_3d
computes the corresponding three
dimensional object point. The disparity value Disparity Disparity Disparity disparity disparity
defines the column difference of the image coordinates of two
corresponding features on an epipolar line according to the equation
. The rectified binocular
camera system is specified by its internal camera parameters
CamParamRect1 CamParamRect1 CamParamRect1 camParamRect1 cam_param_rect_1
of camera 1 and CamParamRect2 CamParamRect2 CamParamRect2 camParamRect2 cam_param_rect_2
of
camera 2, and the external parameters RelPoseRect RelPoseRect RelPoseRect relPoseRect rel_pose_rect
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_cameras calibrate_cameras CalibrateCameras CalibrateCameras calibrate_cameras
and
gen_binocular_rectification_map gen_binocular_rectification_map GenBinocularRectificationMap GenBinocularRectificationMap gen_binocular_rectification_map
. The 3D point is returned
in Cartesian coordinates (X X X x x
,Y Y Y y y
,Z Z Z z z
) of the
rectified camera system 1.
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).
Processed without parallelization.
Parameters
CamParamRect1 CamParamRect1 CamParamRect1 camParamRect1 cam_param_rect_1
(input_control) campar →
HCamPar , HTuple Sequence[Union[int, float, str]] HTuple Htuple (real / integer / string) (double / int / long / string) (double / Hlong / HString) (double / Hlong / char*)
Rectified internal camera parameters of camera 1.
CamParamRect2 CamParamRect2 CamParamRect2 camParamRect2 cam_param_rect_2
(input_control) campar →
HCamPar , HTuple Sequence[Union[int, float, str]] HTuple Htuple (real / integer / string) (double / int / long / string) (double / Hlong / HString) (double / Hlong / char*)
Rectified internal camera parameters of camera 2.
RelPoseRect RelPoseRect RelPoseRect relPoseRect rel_pose_rect
(input_control) pose →
HPose , HTuple Sequence[Union[int, float]] HTuple Htuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Pose of the rectified camera 2 in relation to the
rectified camera 1.
Number of elements:
7
Row1 Row1 Row1 row1 row_1
(input_control) number(-array) →
HTuple MaybeSequence[Union[int, float]] HTuple Htuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Row coordinate of a point in the rectified image 1.
Col1 Col1 Col1 col1 col_1
(input_control) number(-array) →
HTuple MaybeSequence[Union[int, float]] HTuple Htuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Column coordinate of a point in the rectified image 1.
Disparity Disparity Disparity disparity disparity
(input_control) number(-array) →
HTuple MaybeSequence[Union[int, float]] HTuple Htuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Disparity of the images of the world point.
X X X x x
(output_control) real(-array) →
HTuple Sequence[float] HTuple Htuple (real) (double ) (double ) (double )
X coordinate of the 3D point.
Y Y Y y y
(output_control) real(-array) →
HTuple Sequence[float] HTuple Htuple (real) (double ) (double ) (double )
Y coordinate of the 3D point.
Z Z Z z z
(output_control) real(-array) →
HTuple Sequence[float] HTuple Htuple (real) (double ) (double ) (double )
Z coordinate of the 3D point.
Result
disparity_to_point_3d disparity_to_point_3d DisparityToPoint3d DisparityToPoint3d disparity_to_point_3d
returns 2 (
H_MSG_TRUE )
if all parameter values
are correct. If necessary, an exception is raised.
Possible Predecessors
binocular_calibration binocular_calibration BinocularCalibration BinocularCalibration binocular_calibration
,
gen_binocular_rectification_map gen_binocular_rectification_map GenBinocularRectificationMap GenBinocularRectificationMap gen_binocular_rectification_map
Alternatives
disparity_image_to_xyz disparity_image_to_xyz DisparityImageToXyz DisparityImageToXyz disparity_image_to_xyz
See also
binocular_disparity binocular_disparity BinocularDisparity BinocularDisparity binocular_disparity
,
binocular_distance binocular_distance BinocularDistance BinocularDistance binocular_distance
,
intersect_lines_of_sight intersect_lines_of_sight IntersectLinesOfSight IntersectLinesOfSight intersect_lines_of_sight
Module
3D Metrology