boofcv.alg.feature.detect.quadblob

Class DetectQuadBlobsBinary

java.lang.Object

boofcv.alg.feature.detect.quadblob.DetectQuadBlobsBinary

public class DetectQuadBlobsBinary
extends java.lang.Object

Detects blobs inside a binary image which are at least approximate a quadrilateral crudely. Blobs have a minimum contour size and side ratio. If the number of blobs is known before hand processing is reduced by specifying that minimum number.

For each blob that it finds it will find the approximate location of the four corners. Other information is computed for each blob such as its contour and side length. Blobs are removed if they touch the image border and have a hole inside.

Constructor Summary

Constructors

Constructor and Description
DetectQuadBlobsBinary(int minContourSize, double polySideRatio, int minimumBlobCount) Constructor and specify pruning parameters

Method Summary

Methods

Modifier and Type	Method and Description
java.util.List<QuadBlob>	getDetected() List of valid quadrilateral blobs.
java.util.List<QuadBlob>	getInvalid() List of found blobs that did not pass geometric tests..
boofcv.struct.image.ImageSInt32	getLabeledImage() Return the labeled blob image.
java.lang.String	getMessage() Message explaining failure case.
int	getNumLabels() Number of objects in the labeled image.
boolean	process(boofcv.struct.image.ImageUInt8 binary) Detects quadrilateral like blobs in the binary image.
void	setMinContourSize(int minContourSize) Specify the minimum size of a blob's contour

Methods inherited from class java.lang.Object

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

Constructor Detail

DetectQuadBlobsBinary

public DetectQuadBlobsBinary(int minContourSize,
                     double polySideRatio,
                     int minimumBlobCount)

Constructor and specify pruning parameters

Parameters:

minContourSize - Minimum allowed pixels in blob contour. Try 10

polySideRatio - Prune threshold based on side length. 0 to 1. Typically 0.25

minimumBlobCount - Stop processing if fewer than this number of blobs have been detected

Method Detail

setMinContourSize

public void setMinContourSize(int minContourSize)

Specify the minimum size of a blob's contour

Parameters:

minContourSize - Contour size in pixels

process

public boolean process(boofcv.struct.image.ImageUInt8 binary)

Detects quadrilateral like blobs in the binary image. If the minimum number of blobs have not been detected then it will fail. Use getMessage() for more information of the failure.

Parameters:

binary - Binary image being processed.

Returns:

True if it found the minimum number of blobs or false if it did not.

getDetected

public java.util.List<QuadBlob> getDetected()

List of valid quadrilateral blobs.

getInvalid

public java.util.List<QuadBlob> getInvalid()

List of found blobs that did not pass geometric tests..

getMessage

public java.lang.String getMessage()

Message explaining failure case. Only valid when process returns false.

getLabeledImage

public boofcv.struct.image.ImageSInt32 getLabeledImage()

Return the labeled blob image. Useful for debugging. Use getNumLabels() to get the number of labeled objects inside.

getNumLabels

public int getNumLabels()

Number of objects in the labeled image.