View source for Example Detect Calibration Target

<center>
<gallery heights=300 widths=610 >
Image:Example_chess_calibration_points.jpg|Red dots are detected calibration points on a chessboard target.  The entire target must be visible for detection to work.
</gallery>
</center>

BoofCV provides fully automated calibration target detection.  Once detected calibration point locations are returned with a high level of precision. While intended for camera calibration, they can also be used for other applications, such as augmented reality.  In this example it is demonstrated how to detect different types of grid based targets.

Example File: [https://github.com/lessthanoptimal/BoofCV/blob/v0.14/examples/src/boofcv/examples/ExampleDetectCalibrationPoints.java ExampleDetectCalibrationPoints.java]

Concepts:
* Calibration targets

Relevant Applets:
* [[Applet_Calibrate_Detect_Square| Detect Square Grid Calibration Target]]
* [[Applet_Calibrate_Detect_Chess| Detect Chessboard Calibration Target]]

Related Examples/Tutorials:
* [[Tutorial_Camera_Calibration| Tutorial Camera Calibration]]

= Example Code =
<syntaxhighlight lang="java">
/**
 * Example that demonstrates how to detect calibration targets.  Calibration points are found on the
 * targets to a high level of precision.  It is assumed that a single image only shows a single target
 * and that the entire target is visible.  If these conditions are not meet then the target is likely
 * to not be detected.
 *
 * @author Peter Abeles
 */
public class ExampleDetectCalibrationPoints {

	public static void main( String args[] ) {

		// load the test image
//		String directory = "../data/evaluation/calibration/stereo/Bumblebee2_Square";
		String directory = "../data/evaluation/calibration/stereo/Bumblebee2_Chess";

		BufferedImage orig = UtilImageIO.loadImage(directory+"/left01.jpg");
		ImageFloat32 input = ConvertBufferedImage.convertFrom(orig,(ImageFloat32)null);

		// To select different types of detectors add or remove comments below
		PlanarCalibrationDetector detector;

		// For chessboard targets, tune RADIUS parameter for your images
//		detector = FactoryPlanarCalibrationTarget.detectorSquareGrid( 5, 7);
		detector = FactoryPlanarCalibrationTarget.detectorChessboard( new ConfigChessboard(5,7));

		// process the image and check for failure condition
		if( !detector.process(input) )
			throw new RuntimeException("Target detection failed!");

		// Ordered observations of calibration points on the target
		List<Point2D_F64> points = detector.getPoints();

		// render and display the results
		Graphics2D g2 = orig.createGraphics();
		for( Point2D_F64 p : points )
			VisualizeFeatures.drawPoint(g2,(int)p.x,(int)p.y,3,Color.RED);

		ShowImages.showWindow(orig,"Calibration Points");
	}
}
</syntaxhighlight>