Cv2GetOptimalNewCameraMatrix Method (Double, Double, Size, Double, Size, Rect, Boolean) OpenCvSharp Class Library
Returns the new camera matrix based on the free scaling parameter.

Namespace:  OpenCvSharp.CPlusPlus
Assembly:  OpenCvSharp.CPlusPlus (in OpenCvSharp.CPlusPlus.dll) Version: 1.0.0.0 (1.0.0.0)
Syntax

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

Parameters

cameraMatrix
Type: SystemDouble
Input camera matrix.
distCoeffs
Type: SystemDouble
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
Type: OpenCvSharp.CPlusPlusSize
Original image size.
alpha
Type: SystemDouble
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
Type: OpenCvSharp.CPlusPlusSize
Image size after rectification. By default,it is set to imageSize .
validPixROI
Type: OpenCvSharp.CPlusPlusRect
Optional output rectangle that outlines all-good-pixels region in the undistorted image. See roi1, roi2 description in stereoRectify() .
centerPrincipalPoint (Optional)
Type: SystemBoolean
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.

Return Value

Type: Double
optimal new camera matrix
See Also

Reference