Back to Adaptive Vision Studio website

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

DetectCalibrationGrid_Chessboard


Detects a chessboard calibration grid on the image, and returns calibration points where 4 chessboard squares meet.

Name Type Description
inImage Image Input image
inRoi Region* Range of pixels to be processed
inBoardSize Size Number of checkerboard squares in X and Y dimensions.
inFastApproximate Bool Fast filter execution, but result is approximate.
outImageGrid AnnotatedPoint2DArray Detected grid

Applications

Camera calibration, image to world coordinates transformations.

Hints

Make sure that the whole calibration grid is visible in the image. Otherwise, it will not be detected because the detection algorithm requires a few pixels wide quiet zone around the chessboard. Pay attention to the number of columns and rows, as providing misleading data may make the algorithm work incorrectly or not work at all.

Examples

DetectCalibrationGrid_Chessboard executed with inBoardSize = {10,7}

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 Input image is too small
DomainError Input image must have pixels of UInt8 type
DomainError Region of interest exceeds an input image.
DomainError Specified board is too small, minimum size is 4x4

Complexity Level

This filter is available on Advanced Complexity Level.

Filter Group

This filter is member of DetectCalibrationGrid filter group.

See Also