Back to Adaptive Vision Studio website

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

CalibrateCamera_Telecentric_Deprecated


Finds the telecentric camera intrinsic parameters from the input arrays of image and real-world coordinates. Uses telecentric camera model (affine 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.
inUseRationalModel Bool Estimate radial denominator coefficients k4, k5, k6
inUseTangentialModel Bool Estimate tangential distortion coefficients p1, p2
inUseThinPrismModel Bool Estimate thin prism distortion coefficients s1, s2, s3, s4
outCameraMatrix Matrix
outDistortion LensDistortion
outError Real Final reprojection RMS error

Applications

Recognition of lens distortion. Usually followed by CreateUndistortionMap_Deprecated.

Description

The coordinates of 3D object points and their corresponding 2D projections in each view must be specified. That may be achieved by using an object with a known geometry and easily detectable feature points. Such an object is called a calibration rig or calibration pattern. One example is a chessboard (see DetectChessboardGrid_Deprecated).

When camera matrix and distortion coefficients are calculated, one can create undistortion maps using CreateUndistortionMap_Deprecated function. These maps can be applied to images using RemapImage.

Performance of calibration can be measured by outError, which is a RMS of reprojection errors of all calibration points.

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 Empty input array
DomainError Input array sizes differ

Complexity Level

This filter is available on Basic Complexity Level.

Filter Group

This filter is member of CalibrateCamera_Deprecated filter group.

See Also