Skip to main content

Camera calibration modes

When you use McalAlloc to allocate the camera calibration context, you have to specify the camera calibration mode. Aurora Imaging Library supports the following camera calibration modes:

  • Uniform mode: The most basic camera calibration mode available.
  • 2D modes:
    • Piecewise linear interpolation mode: Compensates for any kind of distortion and is very accurate for points located inside the working area.
    • Perspective transformation mode: Compensates for rotation, translation, scale, and perspective distortions. The perspective transformation mode is accurate for points inside and outside the working area.
  • 3D modes:
    • Tsai-based mode: A true 3D camera calibration based on a technique developed by Roger Y. Tsai. This mode determines the distance and orientation between the modeled camera and the image plane.
    • Zhang-based mode: A true 3D camera calibration based on a technique developed by Z. Zhang. This mode is similar to the Tsai-based mode with less restrictions on the optical axis and FOV coverage but requires an accumulation phase of grid images or calibration points.
    • Robotics mode with a Tsai-based camera model: Estimates the position and orientation of the robot base coordinate system with respect to the absolute coordinate system for a moving or stationary camera setup using a Tsai-based camera model. This mode allows for the retrieval of the position and orientation of the robot base coordinate system.
    • Robotics mode with a Zhang-based camera model: This mode is similar to the robotics mode with a Tsai-based camera model, but the camera's intrinsic parameters are determined separately from the position and orientation estimations of the robot base coordinate system.

Note: Note that during development and at runtime, 2D and 3D calibration support requires the presence of different Aurora Imaging Library licenses that grant access to either the 2D or 3D calibration package. Access to both is granted by default with the development license dongle for the full version of Aurora Imaging Library. In other cases, you must purchase access to the required package separately.

The following table provides a side-by-side feature comparison of the different camera calibration modes supported by Aurora Imaging Library:

FeatureUniformLinear interpolationPerspective transformationTsai-basedZhang-basedRobotics (Tsai-based and Zhang-based)
Supports camera movement parallel to the image planeXXXXXX
Supports full 3-dimensional camera movementXXX
Supports working with coordinates that lie outside the calibration gridX(less accurate)XXXX
Calculates the position of the robot baseXX
Calibrates with a single image only(optional)XXX
Allows calibrating with the camera perpendicular to the camera calibration plane (0º angle of incidence)XXXXXX
Supports telecentric lensesXXX
Supports one-dimensional distortions obtained from line-scan camerasXXX
Corrects rotation, scale, and perspective distortionXXXXXX
Corrects lens distortionXXXXX
Corrects all types of distortionX
Corrects lens distortion only and keeps other distortions uncorrectedXXXX
Models the camera explicitlyXXXX
Estimates the position of the camera and other known objects using known world pointsXXXX
Allows retrieval of the position and orientation of the robot's base coordinate systemXX
Allows proper calibration of cameras used for 3D reconstruction by M3dmapCalibrate and M3dmapTriangulate functionsXXX
Copyright © 2026 Zebra Technologies.