change_radial_distortion_cam_parT_change_radial_distortion_cam_parChangeRadialDistortionCamParChangeRadialDistortionCamPar (Operator)

Name

change_radial_distortion_cam_parT_change_radial_distortion_cam_parChangeRadialDistortionCamParChangeRadialDistortionCamPar — Determine new camera parameters in accordance to the specified radial distortion.

Signature

Description

change_radial_distortion_cam_parchange_radial_distortion_cam_parChangeRadialDistortionCamParChangeRadialDistortionCamParChangeRadialDistortionCamPar modifies the internal camera parameters in accordance to the specified radial distortion coefficients DistortionCoeffsDistortionCoeffsDistortionCoeffsDistortionCoeffsdistortionCoeffs. Via ModeModeModeModemode one of the following modes can be selected:

• 'fixed': Only the distortion coefficients are modified, the other internal camera parameters remain unchanged. In general, this leads to a change of the visible part of the scene.

• 'fullsize': The scale factors and and the image center point are modified in order to preserve the visible part of the scene. Thus, all points visible in the original image are also visible in the modified (rectified) image. In general, this leads to undefined pixels in the modified image.

• 'adaptive': A trade-off between the other modes: The visible part of the scene is slightly reduced to prevent undefined pixels in the modified image. Similarly to 'fullsize', the scale factors and the image center point are modified.

• 'preserve_resolution': As in the mode 'fullsize', all points visible in the original image are also visible in the modified (rectified) image, i.e., the scale factors and and the image center point are modified. In general, this leads to undefined pixels in the modified image. In contrast to the mode 'fullsize' additionally the size of the modified image is increased such that the image resolution does not decrease in any part of the image.

In all modes the distortion coefficients in CamParamOutCamParamOutCamParamOutCamParamOutcamParamOut are set to DistortionCoeffsDistortionCoeffsDistortionCoeffsDistortionCoeffsdistortionCoeffs. The transformation of a pixel in the modified image into the image plane using CamParamOutCamParamOutCamParamOutCamParamOutcamParamOut results in the same point as the transformation of a pixel in the original image via CamParamInCamParamInCamParamInCamParamIncamParamIn.

Please note that change_radial_distortion_cam_parchange_radial_distortion_cam_parChangeRadialDistortionCamParChangeRadialDistortionCamParChangeRadialDistortionCamPar does not work for line scan cameras.

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

Result

change_radial_distortion_cam_parchange_radial_distortion_cam_parChangeRadialDistortionCamParChangeRadialDistortionCamParChangeRadialDistortionCamPar returns 2 (H_MSG_TRUE) if all parameter values are correct. If necessary, an exception is raised.

Possible Predecessors

camera_calibrationcamera_calibrationCameraCalibrationCameraCalibrationCameraCalibration, read_cam_parread_cam_parReadCamParReadCamParReadCamPar

Possible Successors

change_radial_distortion_imagechange_radial_distortion_imageChangeRadialDistortionImageChangeRadialDistortionImageChangeRadialDistortionImage, change_radial_distortion_contours_xldchange_radial_distortion_contours_xldChangeRadialDistortionContoursXldChangeRadialDistortionContoursXldChangeRadialDistortionContoursXld, gen_radial_distortion_mapgen_radial_distortion_mapGenRadialDistortionMapGenRadialDistortionMapGenRadialDistortionMap

See also

camera_calibrationcamera_calibrationCameraCalibrationCameraCalibrationCameraCalibration, read_cam_parread_cam_parReadCamParReadCamParReadCamPar, change_radial_distortion_imagechange_radial_distortion_imageChangeRadialDistortionImageChangeRadialDistortionImageChangeRadialDistortionImage, change_radial_distortion_contours_xldchange_radial_distortion_contours_xldChangeRadialDistortionContoursXldChangeRadialDistortionContoursXldChangeRadialDistortionContoursXld, change_radial_distortion_pointschange_radial_distortion_pointsChangeRadialDistortionPointsChangeRadialDistortionPointsChangeRadialDistortionPoints

Module

Calibration