Back to FabImage Library website

You are here: Start » Function Reference » Computer Vision » Camera Calibration » DetectCalibrationGrid_Chessboard_Deprecated

DetectCalibrationGrid_Chessboard_Deprecated


Header: FIL.h
Namespace: fil
Module: Calibration

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

Applications: Camera calibration, image to world coordinates transformations.

Syntax

void fil::DetectCalibrationGrid_Chessboard_Deprecated
(
	const fil::Image& inImage,
	ftl::Optional<const fil::Region&> inRoi,
	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
Input value inImage const Image& Input image
Input value inRoi Optional<const Region&> NIL Range of pixels to be processed
Input value inBoardSize const Size& (Width: 4, Height: 4) Number of checkerboard squares in X and Y dimensions.
Input value inWorldSquareSize float 0.001 - 1.0f Real-world length of a single chessboard square.
Input value inFastApproximate bool False Fast filter execution, but result is approximate.
Output value outImagePoints Conditional<Array<Point2D>>& Image coordinates of detected calibration points.
Output value outWorldPlanePoints Conditional<Array<Point2D>>& World plane coordinates of detected calibration points.

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