You are here:
Start »
AVL.NET »
AVL.DetectChessboardGrid Method
AVL.DetectChessboardGrid Method
Detects a chessboard on the image, and returns the points where 4 chessboard squares meet.
Namespace: | AvlNet |
Assembly: | AVL.NET.dll |
Syntax
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
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 |
See also