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
inImageAvlNet.ImageInput image.
inChessboardWidthint<4, INF>Number of ranks (columns) of the chessboard.
inChessboardHeightint<4, INF>Number of files (rows) of the chessboard.
inGridOriginAvlNet.Point3DReal-world coordinates of top-left grid point.
inSquareDimensionfloat<0.0f, INF>1.0fReal-world length of a single chessboard square (mm). Default value: 1.0f.
inAdaptiveThresholdingboolUse adaptive thresholding instead of a global threshold of average.
inImageNormalizationboolNormalize input image using histogram equalization prior to detection.
inAdditionalFilteringboolUse more criteria for eliminating false chessboards.
inPresenceCheckboolPerform a fast approximate test of chessboard presence before locating it.
inSubpixelRefinementboolIf corners are found, post-process them to improve precision.
outImageGridPointsAvlNet.Point2D
outWorldGridPointsAvlNet.Point3DCorresponding 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