Package boofcv.abst.filter.binary

Class BinaryContourFinderLinearExternal

java.lang.Object

boofcv.abst.filter.binary.BinaryContourFinderLinearExternal

All Implemented Interfaces:

BinaryContourFinder, BinaryContourInterface, BinaryContourInterface.Padded

public class BinaryContourFinderLinearExternal
extends Object
implements BinaryContourFinder, BinaryContourInterface.Padded

Wrapper around LinearExternalContours

Nested Class Summary

Nested classes/interfaces inherited from interface boofcv.abst.filter.binary.BinaryContourInterface

BinaryContourInterface.Padded

Constructor Summary

Constructors

Constructor	Description
BinaryContourFinderLinearExternal()

Method Summary

Modifier and Type	Method	Description
ConnectRule	getConnectRule()
List<ContourPacked>	getContours()	Returns a list of contours/blobs found.
ConfigLength	getMaxContour(@Nullable ConfigLength length)	Returns the maximum contour.
ConfigLength	getMinContour(@Nullable ConfigLength length)	Returns the minimum contour
boolean	isCreatePaddedCopy()
boolean	isSaveInternalContours()
void	loadContour(int contourID, DogArray<Point2D_I32> storage)	Used to load the pixels associated with a contour.
void	process(GrayU8 binary)	Processes the binary image to find the contour.
void	setConnectRule(ConnectRule rule)
void	setCoordinateAdjustment(int x, int y)	Adjustment applied to pixel coordinate of contour points.
void	setCreatePaddedCopy(boolean padded)	If this is set o true then internally it will create a copy of the input image with a 1-pixel border added.
void	setMaxContour(ConfigLength length)	Specifies the maximum contour as either an absolute value in pixels or a value relative to the sqrt(width*height).
void	setMinContour(ConfigLength length)	Specifies the minimum contour as either an absolute value in pixels or a value relative to the sqrt(width*height).
void	setSaveInnerContour(boolean enabled)	Used to toggle on and off the saving of inner contours.
void	writeContour(int contourID, List<Point2D_I32> storage)	Overwrites the coordinates of the saved contour.

Methods inherited from class java.lang.Object

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

Constructor Details

BinaryContourFinderLinearExternal

public BinaryContourFinderLinearExternal()

Method Details

process

public void process(GrayU8 binary)

Description copied from interface: BinaryContourFinder

Processes the binary image to find the contour. If you let the input be modified you really need to read up on how the contour algorithm works. Setting the outside border to zero is typical

Specified by:

process in interface BinaryContourFinder

Parameters:

binary - Input binary image. Not modified.

getContours

public List<ContourPacked> getContours()

Description copied from interface: BinaryContourInterface

Returns a list of contours/blobs found. WARNING: List is recycled on the next call to process().

Specified by:

getContours in interface BinaryContourInterface

Returns:

List of contours.

loadContour

public void loadContour(int contourID,
 DogArray<Point2D_I32> storage)

Description copied from interface: BinaryContourInterface

Used to load the pixels associated with a contour.

Specified by:

loadContour in interface BinaryContourInterface

Parameters:

contourID - ID of the contour you wish to load

storage - Storage for the contour points. Must be set to declare new elements.

writeContour

public void writeContour(int contourID,
 List<Point2D_I32> storage)

Description copied from interface: BinaryContourInterface

Overwrites the coordinates of the saved contour. Useful when points have been undistorted and you're trying to minimize memory by not saving another copy

Specified by:

writeContour in interface BinaryContourInterface

Parameters:

contourID - ID of the contour you wish to load

storage - Storage for the contour points. Must be set to declare new elements.

setSaveInnerContour

public void setSaveInnerContour(boolean enabled)

Description copied from interface: BinaryContourInterface

Used to toggle on and off the saving of inner contours.

Specified by:

setSaveInnerContour in interface BinaryContourInterface

Parameters:

enabled - true to enable or false to disable

isSaveInternalContours

public boolean isSaveInternalContours()

Specified by:

isSaveInternalContours in interface BinaryContourInterface

setMinContour

public void setMinContour(ConfigLength length)

Description copied from interface: BinaryContourInterface

Specifies the minimum contour as either an absolute value in pixels or a value relative to the sqrt(width*height). Threshold ≤ 0 will be treated as infinite.

Specified by:

setMinContour in interface BinaryContourInterface

getMinContour

public ConfigLength getMinContour(@Nullable
 @Nullable ConfigLength length)

Description copied from interface: BinaryContourInterface

Returns the minimum contour

Specified by:

getMinContour in interface BinaryContourInterface

Parameters:

length - Optional storage for the contour's length

Returns:

The contour's length

setMaxContour

public void setMaxContour(ConfigLength length)

Description copied from interface: BinaryContourInterface

Specifies the maximum contour as either an absolute value in pixels or a value relative to the sqrt(width*height). Threshold ≤ 0 will be treated as infinite.

Specified by:

setMaxContour in interface BinaryContourInterface

getMaxContour

public ConfigLength getMaxContour(@Nullable
 @Nullable ConfigLength length)

Description copied from interface: BinaryContourInterface

Returns the maximum contour. Threshold %le; 0 will be treated as infinite.

Specified by:

getMaxContour in interface BinaryContourInterface

Parameters:

length - Optional storage for the contour's length

Returns:

The contour's length

setConnectRule

public void setConnectRule(ConnectRule rule)

Specified by:

setConnectRule in interface BinaryContourInterface

getConnectRule

public ConnectRule getConnectRule()

Specified by:

getConnectRule in interface BinaryContourInterface

setCreatePaddedCopy

public void setCreatePaddedCopy(boolean padded)

Description copied from interface: BinaryContourInterface.Padded

If this is set o true then internally it will create a copy of the input image with a 1-pixel border added. You probably want to also adjust the coordinates using a value of (1,1)

Specified by:

setCreatePaddedCopy in interface BinaryContourInterface.Padded

isCreatePaddedCopy

public boolean isCreatePaddedCopy()

Specified by:

isCreatePaddedCopy in interface BinaryContourInterface.Padded

setCoordinateAdjustment

public void setCoordinateAdjustment(int x,
 int y)

Description copied from interface: BinaryContourInterface.Padded

Adjustment applied to pixel coordinate of contour points. Only used if a padded copy is NOT done.

Specified by:

setCoordinateAdjustment in interface BinaryContourInterface.Padded