change_radial_distortion_cam_parT_change_radial_distortion_cam_parchange_radial_distortion_cam_parChangeRadialDistortionCamParChangeRadialDistortionCamPar (Operator)

Name

change_radial_distortion_cam_parT_change_radial_distortion_cam_parchange_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_parchange_radial_distortion_cam_parChangeRadialDistortionCamParChangeRadialDistortionCamPar 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 Sx andSy and the image center point Cx, Cy^T 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. Similiarly 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 Sx and Sy and the image center point [Cx,Cy]^T 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.

Parallelization

• 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_parchange_radial_distortion_cam_parChangeRadialDistortionCamParChangeRadialDistortionCamPar returns 2 (H_MSG_TRUE) if all parameter values are correct. If necessary, an exception is raised.

Possible Predecessors

camera_calibrationcamera_calibrationcamera_calibrationCameraCalibrationCameraCalibration, read_cam_parread_cam_parread_cam_parReadCamParReadCamPar

Possible Successors

change_radial_distortion_imagechange_radial_distortion_imagechange_radial_distortion_imageChangeRadialDistortionImageChangeRadialDistortionImage, change_radial_distortion_contours_xldchange_radial_distortion_contours_xldchange_radial_distortion_contours_xldChangeRadialDistortionContoursXldChangeRadialDistortionContoursXld, gen_radial_distortion_mapgen_radial_distortion_mapgen_radial_distortion_mapGenRadialDistortionMapGenRadialDistortionMap

See also

camera_calibrationcamera_calibrationcamera_calibrationCameraCalibrationCameraCalibration, read_cam_parread_cam_parread_cam_parReadCamParReadCamPar, change_radial_distortion_imagechange_radial_distortion_imagechange_radial_distortion_imageChangeRadialDistortionImageChangeRadialDistortionImage, change_radial_distortion_contours_xldchange_radial_distortion_contours_xldchange_radial_distortion_contours_xldChangeRadialDistortionContoursXldChangeRadialDistortionContoursXld, change_radial_distortion_pointschange_radial_distortion_pointschange_radial_distortion_pointsChangeRadialDistortionPointsChangeRadialDistortionPoints

Module

Calibration