Method GetOptimalNewCameraMatrix

Namespace

OpenCvSharp

Assembly

OpenCvSharp.dll

GetOptimalNewCameraMatrix(InputArray, InputArray, Size, double, Size, out Rect, bool)

Returns the new camera matrix based on the free scaling parameter.

public static Mat GetOptimalNewCameraMatrix(InputArray cameraMatrix, InputArray distCoeffs, Size imageSize, double alpha, Size newImgSize, out Rect validPixROI, bool centerPrincipalPoint = false)

Parameters

cameraMatrix InputArray

Input camera matrix.

distCoeffs InputArray

Input vector of distortion coefficients (k_1, k_2, p_1, p_2[, k_3[, k_4, k_5, k_6]]) of 4, 5, or 8 elements. If the array is null, the zero distortion coefficients are assumed.

imageSize Size

Original image size.

alpha double

Free scaling parameter between 0 (when all the pixels in the undistorted image are valid) and 1 (when all the source image pixels are retained in the undistorted image).

newImgSize Size

Image size after rectification. By default,it is set to imageSize .

validPixROI Rect

Optional output rectangle that outlines all-good-pixels region in the undistorted image. See roi1, roi2 description in stereoRectify() .

centerPrincipalPoint bool

Optional flag that indicates whether in the new camera matrix the principal point should be at the image center or not. By default, the principal point is chosen to best fit a subset of the source image (determined by alpha) to the corrected image.

Returns

Mat

optimal new camera matrix

GetOptimalNewCameraMatrix(double[,], double[]?, Size, double, Size, out Rect, bool)

Returns the new camera matrix based on the free scaling parameter.

public static double[,]? GetOptimalNewCameraMatrix(double[,] cameraMatrix, double[]? distCoeffs, Size imageSize, double alpha, Size newImgSize, out Rect validPixROI, bool centerPrincipalPoint = false)

Parameters

cameraMatrix double[,]

Input camera matrix.

distCoeffs double[]

Input vector of distortion coefficients (k_1, k_2, p_1, p_2[, k_3[, k_4, k_5, k_6]]) of 4, 5, or 8 elements. If the array is null, the zero distortion coefficients are assumed.

imageSize Size

Original image size.

alpha double

Free scaling parameter between 0 (when all the pixels in the undistorted image are valid) and 1 (when all the source image pixels are retained in the undistorted image).

newImgSize Size

Image size after rectification. By default,it is set to imageSize .

validPixROI Rect

Optional output rectangle that outlines all-good-pixels region in the undistorted image. See roi1, roi2 description in stereoRectify() .

centerPrincipalPoint bool

Optional flag that indicates whether in the new camera matrix the principal point should be at the image center or not. By default, the principal point is chosen to best fit a subset of the source image (determined by alpha) to the corrected image.

Returns

double[,]

optimal new camera matrix