change_radial_distortion_contours_xldchange_radial_distortion_contours_xldChangeRadialDistortionContoursXldChangeRadialDistortionContoursXldchange_radial_distortion_contours_xldT_change_radial_distortion_contours_xld
Short description
change_radial_distortion_contours_xldchange_radial_distortion_contours_xldChangeRadialDistortionContoursXldChangeRadialDistortionContoursXldchange_radial_distortion_contours_xldT_change_radial_distortion_contours_xld — Change the radial distortion of contours.
Signature
change_radial_distortion_contours_xld( xld_cont Contours, out xld_cont ContoursRectified, campar CamParamIn, campar CamParamOut )change_radial_distortion_contours_xld( Contours : ContoursRectified : CamParamIn, CamParamOut : )void ChangeRadialDistortionContoursXld( const HObject& Contours, HObject* ContoursRectified, const HTuple& CamParamIn, const HTuple& CamParamOut )static void HOperatorSet.ChangeRadialDistortionContoursXld( HObject contours, out HObject contoursRectified, HTuple camParamIn, HTuple camParamOut )def change_radial_distortion_contours_xld( contours: HObject, cam_param_in: Sequence[Union[int, float, str]], cam_param_out: Sequence[Union[int, float, str]] ) -> HObject
Herror T_change_radial_distortion_contours_xld( const Hobject Contours, Hobject* ContoursRectified, const Htuple CamParamIn, const Htuple CamParamOut )
HXLDCont HXLDCont::ChangeRadialDistortionContoursXld( const HCamPar& CamParamIn, const HCamPar& CamParamOut ) const
HXLDCont HCamPar::ChangeRadialDistortionContoursXld( const HXLDCont& Contours, const HCamPar& CamParamOut ) const
HXLDCont HXLDCont.ChangeRadialDistortionContoursXld( HCamPar camParamIn, HCamPar camParamOut )
HXLDCont HCamPar.ChangeRadialDistortionContoursXld( HXLDCont contours, HCamPar camParamOut )
Description
change_radial_distortion_contours_xldChangeRadialDistortionContoursXld changes the radial
distortion of the input contours Contourscontourscontours in accordance to the
internal camera parameters CamParamIncamParamIncam_param_in and CamParamOutcamParamOutcam_param_out.
Each subpixel of an input contour is transformed into the image plane
using CamParamIncamParamIncam_param_in and subsequently projected into a subpixel
of the corresponding contour in ContoursRectifiedcontoursRectifiedcontours_rectified using
CamParamOutcamParamOutcam_param_out.
If CamParamOutcamParamOutcam_param_out was computed via
change_radial_distortion_cam_parChangeRadialDistortionCamPar, the contours
ContoursRectifiedcontoursRectifiedcontours_rectified
are equivalent to Contourscontourscontours obtained with a lens with a modified
radial distortion \(\kappa\). If \(\kappa=0\) the contours
are rectified. A subsequent pose estimation (determination of the
external camera parameters) is not affected by this operation.
Please note that change_radial_distortion_contours_xldChangeRadialDistortionContoursXld does
not work for line scan cameras with perspective lenses.
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
Contourscontourscontours (input_object) xld_cont(-array) → objectobjectHObjectHXLDContHObjectHobject
Original contours.
ContoursRectifiedcontoursRectifiedcontours_rectified (output_object) xld_cont(-array) → objectobjectHObjectHXLDContHObjectHobject *
Resulting contours with modified radial distortion.
CamParamIncamParamIncam_param_in (input_control) campar → (real / integer / string)(real / integer / string)HTuple (double / Hlong / HString)HCamPar, HTuple (double / int / long / string)Sequence[Union[int, float, str]]Htuple (double / Hlong / char*)
Internal camera parameter for Contourscontourscontours.
CamParamOutcamParamOutcam_param_out (input_control) campar → (real / integer / string)(real / integer / string)HTuple (double / Hlong / HString)HCamPar, HTuple (double / int / long / string)Sequence[Union[int, float, str]]Htuple (double / Hlong / char*)
Internal camera parameter for
ContoursRectifiedcontoursRectifiedcontours_rectified.
Combinations with other operators
Combinations
Possible predecessors
change_radial_distortion_cam_parChangeRadialDistortionCamPar, gen_contours_skeleton_xldGenContoursSkeletonXld, edges_sub_pixEdgesSubPix, smooth_contours_xldSmoothContoursXld
Possible successors
gen_polygons_xldGenPolygonsXld, smooth_contours_xldSmoothContoursXld
See also
change_radial_distortion_cam_parChangeRadialDistortionCamPar, camera_calibrationCameraCalibration, read_cam_parReadCamPar, change_radial_distortion_imageChangeRadialDistortionImage, change_radial_distortion_pointsChangeRadialDistortionPoints
Module
Calibration