Back to Adaptive Vision Studio website

You are here: Start » Filter Reference » Camera Calibration » CalibrateCamera_Deprecated

CalibrateCamera_Deprecated


Finds the camera intrinsic and extrinsic parameters from the input arrays of image and real-world coordinates. Uses pinhole camera model (perspective camera).

Name Type Range Description
inObjectPoints Point3DArrayArray Array, for each view: array of 3D points of the calibration pattern.
inImagePoints Point2DArrayArray Array, for each view: array of corresponding 2D points in the picture.
inImageWidth Integer 1 - Image width, only used to initialize camera matrix, not used when inInitialCameraMatrix present.
inImageHeight Integer 1 - Image height, only used to initialize camera matrix, not used when inInitialCameraMatrix present.
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.
inFixAspectRatio Bool The functions considers only fy as a free parameter. The ratio fx/fy stays 1, or as in the initial camera matrix.
inZeroTangentDist Bool Tangential distortion coefficients (p_1, p_2) are assumed zero.
inInitialCameraMatrix Matrix* Optional initial camera matrix, required for inFixPrincipalPoint and inFixAspectRatio.
inUseRationalModel Bool
inUseThinPrismModel Bool
outCameraMatrix Matrix
outDistortion LensDistortion
outUnitScales RealArray Image scale: px / mm
outCameraPositions Position3DArray Positions of cameras in world coordinate system for the views
outError Real Final re-projection error value

Applications

Recognition of lens distortion. Usually followed by CreateUndistortionMap_Deprecated.

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 Error in CalibrateCamera: Error message
DomainError Fixing aspect ratio requested, but no initial camera matrix passed in CalibrateCamera.
DomainError Fixing principal point requested, but no initial camera matrix passed in CalibrateCamera.
DomainError Inconsistent sizes of inImagePoints and inObjectPoints in CalibrateCamera.
DomainError Missing inImagePoints or inObjectPoints in CalibrateCamera.

Complexity Level

This filter is available on Basic Complexity Level.