Operator Reference

HALCON Operator Reference / Calibration / Rectification

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

ClassesClasses | | Operators

change_radial_distortion_imageT_change_radial_distortion_imageChangeRadialDistortionImageChangeRadialDistortionImagechange_radial_distortion_image (Operator)

change_radial_distortion_imageT_change_radial_distortion_imageChangeRadialDistortionImageChangeRadialDistortionImagechange_radial_distortion_image — Change the radial distortion of an image.

Signature

change_radial_distortion_image(Image, Region : ImageRectified : CamParamIn, CamParamOut : )

Herror T_change_radial_distortion_image(const Hobject Image, const Hobject Region, Hobject* ImageRectified, const Htuple CamParamIn, const Htuple CamParamOut)

void ChangeRadialDistortionImage(const HObject& Image, const HObject& Region, HObject* ImageRectified, const HTuple& CamParamIn, const HTuple& CamParamOut)

HImage HImage::ChangeRadialDistortionImage(const HRegion& Region, const HCamPar& CamParamIn, const HCamPar& CamParamOut) const

HImage HCamPar::ChangeRadialDistortionImage(const HImage& Image, const HRegion& Region, const HCamPar& CamParamOut) const

static void HOperatorSet.ChangeRadialDistortionImage(HObject image, HObject region, out HObject imageRectified, HTuple camParamIn, HTuple camParamOut)

HImage HImage.ChangeRadialDistortionImage(HRegion region, HCamPar camParamIn, HCamPar camParamOut)

HImage HCamPar.ChangeRadialDistortionImage(HImage image, HRegion region, HCamPar camParamOut)

def change_radial_distortion_image(image: HObject, region: HObject, cam_param_in: Sequence[Union[int, float, str]], cam_param_out: Sequence[Union[int, float, str]]) -> HObject

Description

change_radial_distortion_imagechange_radial_distortion_imageChangeRadialDistortionImageChangeRadialDistortionImagechange_radial_distortion_image changes the radial distortion of the input image ImageImageImageimageimage in accordance to the internal camera parameters CamParamInCamParamInCamParamIncamParamIncam_param_in and CamParamOutCamParamOutCamParamOutcamParamOutcam_param_out. Each pixel of the output image that lies within the region RegionRegionRegionregionregion is transformed into the image plane using CamParamOutCamParamOutCamParamOutcamParamOutcam_param_out and subsequently projected into a subpixel of ImageImageImageimageimage using CamParamInCamParamInCamParamIncamParamIncam_param_in. The resulting gray value is determined by bilinear interpolation. If the subpixel is outside of ImageImageImageimageimage, the corresponding pixel in ImageRectifiedImageRectifiedImageRectifiedimageRectifiedimage_rectified is set to 'black' and eliminated from the image domain.

If the gray values of all pixels in the output image shall be calculated, it is sufficient to pass an empty object in RegionRegionRegionregionregion (which must be previously generated by, for example, using gen_empty_objgen_empty_objGenEmptyObjGenEmptyObjgen_empty_obj). This is especially useful if the size of the output image differs from the size of the input image, and hence, it is not possible to simply pass the region of the input image in RegionRegionRegionregionregion.

If CamParamOutCamParamOutCamParamOutcamParamOutcam_param_out was computed via change_radial_distortion_cam_parchange_radial_distortion_cam_parChangeRadialDistortionCamParChangeRadialDistortionCamParchange_radial_distortion_cam_par, ImageRectifiedImageRectifiedImageRectifiedimageRectifiedimage_rectified is equivalent to ImageImageImageimageimage obtained with a lens with a modified radial distortion . If the image is rectified. A subsequent pose estimation (determination of the external camera parameters) is not affected by this operation.

Please note that change_radial_distortion_imagechange_radial_distortion_imageChangeRadialDistortionImageChangeRadialDistortionImagechange_radial_distortion_image does not work for line scan cameras with perspective lenses. Instead, you might want to use image_to_world_planeimage_to_world_planeImageToWorldPlaneImageToWorldPlaneimage_to_world_plane.

Attention

change_radial_distortion_imagechange_radial_distortion_imageChangeRadialDistortionImageChangeRadialDistortionImagechange_radial_distortion_image can be executed on OpenCL devices if the input image does not exceed the maximum size of image objects of the selected device. As the OpenCL implementation uses single precision arithmetic, the results can differ from the CPU implementation.

Execution Information

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

Parameters

ImageImageImageimageimage (input_object)  (multichannel-)image(-array) → objectHImageHObjectHObjectHobject (byte / uint2 / real)

Original image.

RegionRegionRegionregionregion (input_object)  region → objectHRegionHObjectHObjectHobject

Region of interest in ImageRectifiedImageRectifiedImageRectifiedimageRectifiedimage_rectified.

ImageRectifiedImageRectifiedImageRectifiedimageRectifiedimage_rectified (output_object)  (multichannel-)image(-array) → objectHImageHObjectHObjectHobject * (byte / uint2 / real)

Resulting image 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 ImageImageImageimageimage.

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 ImageImageImageimageimage.

Result

change_radial_distortion_imagechange_radial_distortion_imageChangeRadialDistortionImageChangeRadialDistortionImagechange_radial_distortion_image returns 2 ( H_MSG_TRUE) if all parameter values are correct. If the input is empty (no input image is available) the behavior can be set via set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>). If necessary, an exception is raised.

Possible Predecessors

change_radial_distortion_cam_parchange_radial_distortion_cam_parChangeRadialDistortionCamParChangeRadialDistortionCamParchange_radial_distortion_cam_par, read_imageread_imageReadImageReadImageread_image, grab_imagegrab_imageGrabImageGrabImagegrab_image

Possible Successors

edges_imageedges_imageEdgesImageEdgesImageedges_image, thresholdthresholdThresholdThresholdthreshold

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_contours_xldchange_radial_distortion_contours_xldChangeRadialDistortionContoursXldChangeRadialDistortionContoursXldchange_radial_distortion_contours_xld, change_radial_distortion_pointschange_radial_distortion_pointsChangeRadialDistortionPointsChangeRadialDistortionPointschange_radial_distortion_points

Module

Calibration

---

ClassesClasses | | Operators