Back to Adaptive Vision Studio website
You are here: Start » Filter Reference » Camera Calibration » 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.