Back to FabImage Studio website

You are here: Start » Filter Reference » OpenCV » Camera Calibration And 3D Reconstruction » cvFindChessboardCorners

cvFindChessboardCorners

Basic

Module: OpenCV

Finds the positions of the internal corners of the chessboard.

Name Type Range Description
Input value inImage Image Input image
Input value inPatternWidth Integer 3 - Pattern width (chessboard columns - 1)
Input value inPatternHeight Integer 3 - Pattern height (chessboard rows - 1)
Input value inAdaptiveThresholding Bool Use adaptive thresholding to convert the image to black and white, rather than a fixed threshold level (computed from the average image brightness).
Input value inNormalizeImage Bool Normalize the image gamma with equalizeHist() before applying fixed or adaptive thresholding.
Input value inFilterQuads Bool Use additional criteria (like contour area, perimeter, square-like shape) to filter out false quads extracted at the contour retrieval stage.
Input value inFastCheck Bool Run a fast check on the image that looks for chessboard corners, and shortcut the call if none is found. This can drastically speed up the call in the degenerate condition when no chessboard is observed.
Output value outFound Bool If all corners found and reordered, row by row, successfully.
Output value outCorners Point2DArray

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 Both width and height of the pattern should be bigger than 2 in cvFindChessboardCorners.
DomainError Empty image in cvFindChessboardCorners.
DomainError inImage must have 1 or 3 channels of type UInt8 in cvFindChessboardCorners.

Complexity Level

This filter is available on Basic Complexity Level.