You are here: Start » AVL.NET » AVL.DetectChessboardGrid(AvlNet.Image, int, int, AvlNet.Point3D, float, bool, bool, bool, bool, bool, AvlNet.Point2D[], AvlNet.Point3D[])

AVL.DetectChessboardGrid(AvlNet.Image, int, int, AvlNet.Point3D, float, bool, bool, bool, bool, bool, AvlNet.Point2D[], AvlNet.Point3D[])

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

inImage
Type: AvlNet.Image
Input image
inChessboardWidth
Type: System.Int32
Number of ranks (columns) of the chessboard
inChessboardHeight
Type: System.Int32
Number of files (rows) of the chessboard
inGridOrigin
Type: AvlNet.Point3D
Real-world coordinates of top-left grid point
inSquareDimension
Type: System.Single
Real-world length of a single chessboard square
inAdaptiveThresholding
Type: System.Boolean
Use adaptive thresholding instead of a global threshold of average
inImageNormalization
Type: System.Boolean
Normalize input image using histogram equalization prior to detection
inAdditionalFiltering
Type: System.Boolean
Use more criteria for eliminating false chessboards
inPresenceCheck
Type: System.Boolean
Perform a fast approximate test of chessboard presence before locating it
inSubpixelRefinement
Type: System.Boolean
If corners are found, post-process them to improve precision
outImageGridPoints
Type: AvlNet.Point2D
outWorldGridPoints
Type: 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