Back to Adaptive Vision Library website
You are here: Start » Function Reference » Camera Calibration » DetectCalibrationGrid_Chessboard
![](../../img/icon/DetectChessboardGrid.png)
DetectCalibrationGrid_Chessboard
Header: | AVL.h |
---|---|
Namespace: | avl |
Detects a chessboard calibration grid on the image, and returns calibration points where 4 chessboard squares meet.
Syntax
C++
C#
void avl::DetectCalibrationGrid_Chessboard ( const avl::Image& inImage, const avl::Size& inBoardSize, float inWorldSquareSize, bool inFastApproximate, atl::Conditional<atl::Array<avl::Point2D>>& outImagePoints, atl::Conditional<atl::Array<avl::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
![](../../img/filters/DetectChessboardGrid.png)
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
- DetectCalibrationGrid_CircleBoard – Detects a fixed-size symmetric circle calibration pattern on the image.
- DetectCalibrationGrid_Circles – Detects an arbitrary size symmetric circle pattern on the image.