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

cvFisheyeCalibrateCamera


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.