Back to Adaptive Vision Studio website

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

cvFindChessboardCorners

Finds the positions of the internal corners of the chessboard.

	Name	Type	Range	Description
	inImage	Image		Input image
	inPatternWidth	Integer	3 -	Pattern width (chessboard columns - 1)
	inPatternHeight	Integer	3 -	Pattern height (chessboard rows - 1)
	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).
	inNormalizeImage	Bool		Normalize the image gamma with equalizeHist() before applying fixed or adaptive thresholding.
	inFilterQuads	Bool		Use additional criteria (like contour area, perimeter, square-like shape) to filter out false quads extracted at the contour retrieval stage.
	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.
	outFound	Bool		If all corners found and reordered, row by row, successfully.
	outCorners	Point2D Array

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.