Back to FabImage Studio website

You are here: Start » Filter Reference » OpenCV » Camera Calibration And 3D Reconstruction » cvGetOptimalNewCameraMatrix

cvGetOptimalNewCameraMatrix

Basic

Module: OpenCV

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

Name Type Range Description
Input value
 inCameraMatrix Matrix Old camera matrix
Input value
 inDistCoeffs Matrix Coefficients of distortion
Input value
 inImageWidth Integer Width of image for old camera matrix
Input value
 inImageHeight Integer Height of image for old camera matrix
Input value
 inAlpha Real 0.0 - 1.0 Scaling parameter
Input value
 inNewImageWidth Integer Width of images for new camera matrix
Input value
 inNewImageHeight Integer Height of images for new camera matrix
Output value
 outNewCameraMatrix Matrix New optimal camera matrix
Output value
 outValidPixROI Region Region that will outline all-good-pixels in the undistorted image

Errors

This filter can throw an exception to report error. Read how to deal with errors in Error Handling.

List of possible exceptions:

Error type Description
DomainError inCameraMatrix must be a 3x3 matrix in cvGetOptimalNewCameraMatrix.
DomainError Supported matrix sizes for inDistCoeffs are: 1x4, 4x1, 1x5, 5x1, 1x8, 8x1, 1x12, 12x1 in cvGetOptimalNewCameraMatrix.

Complexity Level

This filter is available on Basic Complexity Level.