Skip to content

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🔗

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