Start » Filter Reference » OpenCV » Camera Calibration And 3D Reconstruction » cvFisheyeCalibrateCamera

cvFisheyeCalibrateCamera

Basic

Module: OpenCV

Finds the camera intrinsic and extrinsic parameters from pairs of corresponding image and object points arrays.

Name Type Range Description
Input value
 inObjectPoints Point3DArrayArray
Input value
 inImagePoints Point2DArrayArray
Input value
 inImageWidth Integer 1 - Width of image, used for initializing principal point.
Input value
 inImageHeight Integer 1 - Height of image, used for initializing principal point.
Input value
 inFixPrincipalPoint Bool The principal point is not changed during the global optimization. It stays in the center of the image, or as in the initial camera matrix.
Input value
 inFixAspectRatio Bool The functions considers only fy as a free parameter. The ratio fx/fy stays 1, or as in the initial camera matrix.
Input value
 inZeroTangentDist Bool Tangential distortion coefficients (p_1, p_2) are assumed zero.
Input value
 inRationalModel Bool Additional distortion coefficients (k_4, k_5, k_6) are calculated.
Input value
 inInitialCameraMatrix Matrix* Optional initial camera matrix, required for inFixPrincipalPoint and inFixAspectRatio.
Output value
 outCameraMatrix Matrix Matrix of intrinsic parameters.
Output value
 outDistCoeffs Matrix Coefficients of distortion.
Output value
 outRVecs Vector3DArray Array with values of rotations for each points set.
Output value
 outTVecs Vector3DArray Array with values of translations for each points set.
Output value
 outError Real Final re-projection error value.

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 in are required to perform camera calibration in cvFisheyeCalibrateCamera.
DomainError in are required to perform camera calibration in cvFisheyeCalibrateCamera.
DomainError Fixing aspect ratio requested, but no initial camera matrix passed in cvFisheyeCalibrateCamera.
DomainError Fixing principal point requested, but no initial camera matrix passed in cvFisheyeCalibrateCamera.
DomainError Inconsistent sizes of inImagePoints and inObjectPoints in cvFisheyeCalibrateCamera.
DomainError inInitialCameraMatrix must be a 3x3 matrix in cvFisheyeCalibrateCamera.
DomainError Missing inImagePoints or inObjectPoints in cvFisheyeCalibrateCamera.

Complexity Level

This filter is available on Basic Complexity Level.