boofcv.alg.shapes.ellipse

Class BinaryEllipseDetector<T extends boofcv.struct.image.ImageGray>

java.lang.Object

boofcv.alg.shapes.ellipse.BinaryEllipseDetector<T>

public class BinaryEllipseDetector<T extends boofcv.struct.image.ImageGray>
extends java.lang.Object

Detects ellipses inside gray scale images. The first step is to detect them in a binary image and then refine the fit using the gray scale image. Optionally the refinement step can be turned off or postponed until the user invokes it directly. False positives are pruned using the edge intensity check. This check removes ellipses with edges that are low intensity sicne they are most likely generated from noise.

Constructor Summary

Constructors

Constructor and Description
BinaryEllipseDetector(BinaryEllipseDetectorPixel ellipseDetector, SnapToEllipseEdge<T> ellipseRefiner, EdgeIntensityEllipse<T> intensityCheck, java.lang.Class<T> inputType) Configures the detector

Method Summary

Modifier and Type	Method and Description
java.util.List<boofcv.alg.filter.binary.Contour>	getAllContours()
BinaryEllipseDetectorPixel	getEllipseDetector()
org.ddogleg.struct.FastQueue<georegression.struct.shapes.EllipseRotated_F64>	getFoundEllipses() Returns all the found ellipses in the input image.
java.lang.Class<T>	getInputType()
boolean	isAutoRefine()
boolean	isVerbose()
void	process(T gray, boofcv.struct.image.GrayU8 binary) Detects ellipses inside the binary image and refines the edges for all detections inside the gray image
boolean	refine(georegression.struct.shapes.EllipseRotated_F64 ellipse) If auto refine is turned off an ellipse can be refined after the fact using this function, provided that the refinement algorithm was passed in to the constructor
void	setAutoRefine(boolean autoRefine)
void	setLensDistortion(boofcv.struct.distort.PixelTransform2_F32 distToUndist, boofcv.struct.distort.PixelTransform2_F32 undistToDist) Specifies transforms which can be used to change coordinates from distorted to undistorted.
void	setVerbose(boolean verbose)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BinaryEllipseDetector

public BinaryEllipseDetector(BinaryEllipseDetectorPixel ellipseDetector,
                             SnapToEllipseEdge<T> ellipseRefiner,
                             EdgeIntensityEllipse<T> intensityCheck,
                             java.lang.Class<T> inputType)

Configures the detector

Parameters:

ellipseDetector - Detector which uses pixel precise edges

ellipseRefiner - Sub pixel edge refinement. If null the refinement step is skipped

intensityCheck - Computes the intensity of the edge to remove false positives

inputType - Input image type

Method Detail

setLensDistortion

public void setLensDistortion(boofcv.struct.distort.PixelTransform2_F32 distToUndist,
                              boofcv.struct.distort.PixelTransform2_F32 undistToDist)

Specifies transforms which can be used to change coordinates from distorted to undistorted. The undistorted image is never explicitly created.

WARNING: The undistorted image must have the same bounds as the distorted input image. This is because several of the bounds checks use the image shape. This are simplified greatly by this assumption.

Parameters:

distToUndist - Transform from distorted to undistorted image.

undistToDist - Transform from undistorted to distorted image.

process

public void process(T gray,
                    boofcv.struct.image.GrayU8 binary)

Detects ellipses inside the binary image and refines the edges for all detections inside the gray image

Parameters:

gray - Grayscale image

binary - Binary image of grayscale. 1 = ellipse and 0 = ignored background

refine

public boolean refine(georegression.struct.shapes.EllipseRotated_F64 ellipse)

If auto refine is turned off an ellipse can be refined after the fact using this function, provided that the refinement algorithm was passed in to the constructor

Parameters:

ellipse - The ellipse to be refined

Returns:

true if refine was successful or false if not

getEllipseDetector

public BinaryEllipseDetectorPixel getEllipseDetector()

isVerbose

public boolean isVerbose()

setVerbose

public void setVerbose(boolean verbose)

isAutoRefine

public boolean isAutoRefine()

setAutoRefine

public void setAutoRefine(boolean autoRefine)

getInputType

public java.lang.Class<T> getInputType()

getAllContours

public java.util.List<boofcv.alg.filter.binary.Contour> getAllContours()

getFoundEllipses

public org.ddogleg.struct.FastQueue<georegression.struct.shapes.EllipseRotated_F64> getFoundEllipses()

Returns all the found ellipses in the input image.

WARNING: Returned data is recycled on the next call to process

Returns:

List of found ellipses.