Back to FabImage Library websiteYou are here:
Start »
Function Reference »
Computer Vision »
Camera Calibration »
DetectChessboardGrid_Deprecated
DetectChessboardGrid_Deprecated
Header: |
FIL.h
|
Namespace: |
fil |
Module: |
Calibration |
Detects a chessboard on the image, and returns the points where 4 chessboard squares meet.
Applications: Preparation of data required for creating image undistortion map.
Syntax
void fil::DetectChessboardGrid_Deprecated
(
const fil::Image& inImage,
int inChessboardWidth,
int inChessboardHeight,
const fil::Point3D& inGridOrigin,
float inSquareDimension,
bool inAdaptiveThresholding,
bool inImageNormalization,
bool inAdditionalFiltering,
bool inPresenceCheck,
bool inSubpixelRefinement,
ftl::Conditional<ftl::Array<fil::Point2D> >& outImageGridPoints,
ftl::Conditional<ftl::Array<fil::Point3D> >& outWorldGridPoints
)
Parameters
|
Name |
Type |
Range |
Default |
Description |
|
inImage |
const Image& |
|
|
Input image |
|
inChessboardWidth |
int |
4 - |
|
Number of ranks (columns) of the chessboard |
|
inChessboardHeight |
int |
4 - |
|
Number of files (rows) of the chessboard |
|
inGridOrigin |
const Point3D& |
|
|
Real-world coordinates of top-left grid point |
|
inSquareDimension |
float |
0.0 - |
1.0f |
Real-world length of a single chessboard square (mm) |
|
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 |
Conditional<Array<Point2D> >& |
|
|
|
|
outWorldGridPoints |
Conditional<Array<Point3D> >& |
|
|
Corresponding 3D (World) points, generated from grid origin and square dimension |
Errors
List of possible exceptions:
Error type |
Description |
DomainError |
Empty inImage in DetectChessboardGrid. |
DomainError |
Error in DetectChessboardGrid: Error message |
DomainError |
Error in DetectChessboardGrid:Error message |