Back to Aurora Vision Studio website

You are here: 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.