You are here: Start » AVL.NET » AVL.DetectChessboardGrid
Detects a chessboard on the image, and returns the points where 4 chessboard squares meet.
Namespace: | AvlNet |
---|---|
Assembly: | AVL.NET.dll |
Syntax
C++
C#
public static void DetectChessboardGrid ( AvlNet.Image inImage, int inChessboardWidth, int inChessboardHeight, AvlNet.Point3D inGridOrigin, float inSquareDimension, bool inAdaptiveThresholding, bool inImageNormalization, bool inAdditionalFiltering, bool inPresenceCheck, bool inSubpixelRefinement, out AvlNet.Point2D[] outImageGridPoints, out AvlNet.Point3D[] outWorldGridPoints )
Parameters
Name | Type | Range | Default | Description | |
---|---|---|---|---|---|
![]() | inImage | AvlNet.Image | Input image. | ||
![]() | inChessboardWidth | int | <4, INF> | Number of ranks (columns) of the chessboard. | |
![]() | inChessboardHeight | int | <4, INF> | Number of files (rows) of the chessboard. | |
![]() | inGridOrigin | AvlNet.Point3D | Real-world coordinates of top-left grid point. | ||
![]() | inSquareDimension | float | <0.0f, INF> | 1.0f | Real-world length of a single chessboard square (mm). Default value: 1.0f. |
![]() | inAdaptiveThresholding | bool | Use adaptive thresholding instead of a global threshold of average. | ||
![]() | inImageNormalization | bool | Normalize input image using histogram equalization prior to detection. | ||
![]() | inAdditionalFiltering | bool | Use more criteria for eliminating false chessboards. | ||
![]() | inPresenceCheck | bool | Perform a fast approximate test of chessboard presence before locating it. | ||
![]() | inSubpixelRefinement | bool | If corners are found, post-process them to improve precision. | ||
![]() | outImageGridPoints | AvlNet.Point2D[] | |||
![]() | outWorldGridPoints | AvlNet.Point3D[] | Corresponding 3D (World) points, generated from grid origin and square dimension. |
Examples
![](../img/filters/DetectChessboardGrid.png)
DetectChessboardGrid executed with inChessboardWidth = 10, inChessboardHeight = 7.
Errors
Error type | Description |
---|---|
DomainError | Empty inImage in DetectChessboardGrid. |
DomainError | Error in DetectChessboardGrid:Error message |
DomainError | Error in DetectChessboardGrid: Error message |