Back to FabImage Library website

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

DetectCalibrationGrid_Chessboard


Header:FIL.h
Namespace:fil

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

Syntax

C++
C#
 
void fil::DetectCalibrationGrid_Chessboard
(
	const fil::Image& inImage,
	const fil::Size& inBoardSize,
	float inWorldSquareSize,
	bool inFastApproximate,
	ftl::Conditional<ftl::Array<fil::Point2D>>& outImagePoints,
	ftl::Conditional<ftl::Array<fil::Point2D>>& outWorldPlanePoints
)

Parameters

Name Type Range Default Description
inImage const Image& Input image
inBoardSize const Size& (Width: 4, Height: 4) Number of checkerboard squares in X and Y dimensions.
inWorldSquareSize float 0.001 - 1.0f Real-world length of a single chessboard square.
inFastApproximate bool False Fast filter execution, but result is approximate.
outImagePoints Conditional<Array<Point2D>>& Image coordinates of detected calibration points.
outWorldPlanePoints Conditional<Array<Point2D>>& World plane coordinates of detected calibration points.

Examples

DetectCalibrationGrid_Chessboard executed with inBoardSize = {10,7}

Errors

List of possible exceptions:

Error type Description
DomainError Input image is too small
DomainError Input image must have pixels of UInt8 type
DomainError Specified board is too small, minimum size is 4x4

See Also