Operator Reference

HALCON Operator Reference / Calibration / Rectification

• HDevelop
• .NET
• Python
• C++
• C

ClassesClasses | | Operators

change_radial_distortion_contours_xldT_change_radial_distortion_contours_xldChangeRadialDistortionContoursXldChangeRadialDistortionContoursXldchange_radial_distortion_contours_xld (Operator)

change_radial_distortion_contours_xldT_change_radial_distortion_contours_xldChangeRadialDistortionContoursXldChangeRadialDistortionContoursXldchange_radial_distortion_contours_xld — Change the radial distortion of contours.

Signature

change_radial_distortion_contours_xld(Contours : ContoursRectified : CamParamIn, CamParamOut : )

Herror T_change_radial_distortion_contours_xld(const Hobject Contours, Hobject* ContoursRectified, const Htuple CamParamIn, const Htuple CamParamOut)

void ChangeRadialDistortionContoursXld(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

static void HOperatorSet.ChangeRadialDistortionContoursXld(HObject contours, out HObject contoursRectified, HTuple camParamIn, HTuple camParamOut)

HXLDCont HXLDCont.ChangeRadialDistortionContoursXld(HCamPar camParamIn, HCamPar camParamOut)

HXLDCont HCamPar.ChangeRadialDistortionContoursXld(HXLDCont contours, HCamPar 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

Description

change_radial_distortion_contours_xldchange_radial_distortion_contours_xldChangeRadialDistortionContoursXldChangeRadialDistortionContoursXldchange_radial_distortion_contours_xld changes the radial distortion of the input contours ContoursContoursContourscontourscontours in accordance to the internal camera parameters CamParamInCamParamInCamParamIncamParamIncam_param_in and CamParamOutCamParamOutCamParamOutcamParamOutcam_param_out. Each subpixel of an input contour is transformed into the image plane using CamParamInCamParamInCamParamIncamParamIncam_param_in and subsequently projected into a subpixel of the corresponding contour in ContoursRectifiedContoursRectifiedContoursRectifiedcontoursRectifiedcontours_rectified using CamParamOutCamParamOutCamParamOutcamParamOutcam_param_out.

If CamParamOutCamParamOutCamParamOutcamParamOutcam_param_out was computed via change_radial_distortion_cam_parchange_radial_distortion_cam_parChangeRadialDistortionCamParChangeRadialDistortionCamParchange_radial_distortion_cam_par, the contours ContoursRectifiedContoursRectifiedContoursRectifiedcontoursRectifiedcontours_rectified are equivalent to ContoursContoursContourscontourscontours obtained with a lens with a modified radial distortion . If 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_xldchange_radial_distortion_contours_xldChangeRadialDistortionContoursXldChangeRadialDistortionContoursXldchange_radial_distortion_contours_xld 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

ContoursContoursContourscontourscontours (input_object)  xld_cont(-array) → objectHXLDContHObjectHObjectHobject

Original contours.

ContoursRectifiedContoursRectifiedContoursRectifiedcontoursRectifiedcontours_rectified (output_object)  xld_cont(-array) → objectHXLDContHObjectHObjectHobject *

Resulting contours with modified radial distortion.

CamParamInCamParamInCamParamIncamParamIncam_param_in (input_control)  campar → HCamPar, HTupleSequence[Union[int, float, str]]HTupleHtuple (real / integer / string) (double / int / long / string) (double / Hlong / HString) (double / Hlong / char*)

Internal camera parameter for ContoursContoursContourscontourscontours.

CamParamOutCamParamOutCamParamOutcamParamOutcam_param_out (input_control)  campar → HCamPar, HTupleSequence[Union[int, float, str]]HTupleHtuple (real / integer / string) (double / int / long / string) (double / Hlong / HString) (double / Hlong / char*)

Internal camera parameter for ContoursRectifiedContoursRectifiedContoursRectifiedcontoursRectifiedcontours_rectified.

Possible Predecessors

change_radial_distortion_cam_parchange_radial_distortion_cam_parChangeRadialDistortionCamParChangeRadialDistortionCamParchange_radial_distortion_cam_par, gen_contours_skeleton_xldgen_contours_skeleton_xldGenContoursSkeletonXldGenContoursSkeletonXldgen_contours_skeleton_xld, edges_sub_pixedges_sub_pixEdgesSubPixEdgesSubPixedges_sub_pix, smooth_contours_xldsmooth_contours_xldSmoothContoursXldSmoothContoursXldsmooth_contours_xld

Possible Successors

gen_polygons_xldgen_polygons_xldGenPolygonsXldGenPolygonsXldgen_polygons_xld, smooth_contours_xldsmooth_contours_xldSmoothContoursXldSmoothContoursXldsmooth_contours_xld

See also

change_radial_distortion_cam_parchange_radial_distortion_cam_parChangeRadialDistortionCamParChangeRadialDistortionCamParchange_radial_distortion_cam_par, camera_calibrationcamera_calibrationCameraCalibrationCameraCalibrationcamera_calibration, read_cam_parread_cam_parReadCamParReadCamParread_cam_par, change_radial_distortion_imagechange_radial_distortion_imageChangeRadialDistortionImageChangeRadialDistortionImagechange_radial_distortion_image, change_radial_distortion_pointschange_radial_distortion_pointsChangeRadialDistortionPointsChangeRadialDistortionPointschange_radial_distortion_points

Module

Calibration

---

ClassesClasses | | Operators