Herror ::change_radial_distortion_image (
    Hobject Image,
    Hobject Region,
    Hobject *ImageRectified,
    const HTuple &CamParIn,
    const HTuple &CamParOut
)
HImage HImage::ChangeRadialDistortionImage (
    const HRegion &Region,
    const HTuple &CamParIn,
    const HTuple &CamParOut
) const
HImageArray HImageArray::ChangeRadialDistortionImage (
    const HRegion &Region,
    const HTuple &CamParIn,
    const HTuple &CamParOut
) const

Change the radial distortion of an image.

::change_radial_distortion_image changes the radial distortion of the input image Image in accordance to the internal camera parameters CamParIn and CamParOut. The image size remains unchanged. Each pixel of the output image is transformed into the image plane using CamParOut and subsequently projected into a subpixel of Image using CamParIn. The resulting grayvalue is determined by bilinear interpolation. If the subpixel is outside of Image, the corresponding pixel in ImageRectified is set to 'black' and eliminated from the image domain.

If CamParOut was computed via ::change_radial_distortion_cam_par, ImageRectified is equivalent to Image obtained with a lense with a modified radial distortion. If Kappa is 0 , the image is rectified. A subsequent pose estimation (determination of the external camera parameters) is not affected by this operation.


Parameters

Image (input_object)
(multichannel-)image(-array) -> Hobject: HImage(Array)
Original image.

Region (input_object)
region -> Hobject: HRegion
Region of interest in Image.

ImageRectified (output_object)
(multichannel-)image(-array) -> Hobject * : HImage(Array)
Resulting image with modified radial distortion.

CamParIn (input_control)
real-array -> HTuple.double
Internal camera parameter for Image.

CamParOut (input_control)
real-array -> HTuple.double
Internal camera parameter for Image.


Result

::change_radial_distortion_image returns H_MSG_TRUE if all parameter values are correct and the input is not empty. If necessary, an exception handling is raised.


Possible Predecessors

::change_radial_distortion_cam_par, ::read_image, ::grab_image


Possible Successors

::edges_image, ::threshold


See also

::change_radial_distortion_cam_par, ::camera_calibration, ::read_cam_par, ::change_radial_distortion_contours_xld


Module

Camera calibration



Copyright © 1996-2002 MVTec Software GmbH