imagingbook.pub.regions

Class RegionLabeling

java.lang.Object

imagingbook.pub.regions.RegionLabeling

Direct Known Subclasses:

BreadthFirstLabeling, DepthFirstLabeling, RecursiveLabeling, RegionContourLabeling, SequentialLabeling

public abstract class RegionLabeling
extends Object

This class does the complete region labeling for a given image. It is abstract, because the implementation of some parts depends on the region labeling algorithm being used.

Version:

2016-11-08

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	RegionLabeling.BinaryRegion This inner class of RegionLabeling represents a connected component or binary region.

Field Summary

Fields

Modifier and Type	Field and Description
protected int	currentLabel
protected int	height
protected ij.process.ImageProcessor	ip
protected int[][]	labelArray
protected int	maxLabel
protected List<RegionLabeling.BinaryRegion>	regions
protected int	width

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	RegionLabeling(ij.process.ByteProcessor ip)

Method Summary

Modifier and Type	Method and Description
RegionLabeling.BinaryRegion	findRegion(int label) Find the region associated to the given label.
int	getLabel(int u, int v) Get the label number for the specified image coordinate.
RegionLabeling.BinaryRegion	getRegion(int u, int v) Finds the RegionLabeling.BinaryRegion instance associated with the given image position.
Iterable<Point>	getRegionPoints(RegionLabeling.BinaryRegion r) Deprecated. This method is not supported any longer. Instead use Iterable<Point> capability of RegionLabeling.BinaryRegion to iterate directly over region points.
List<RegionLabeling.BinaryRegion>	getRegions() Get an unsorted list of all regions associated with this region labeling.
List<RegionLabeling.BinaryRegion>	getRegions(boolean sort) Get a possibly sorted list of all regions associated with this region labeling.
protected int[][]	initialize()
ij.process.ImageProcessor	makeLabelImage(boolean color) Utility method that creates an image of the internal label array.
protected int	makeRandomColor()
protected void	resetLabel()
protected void	setLabel(int u, int v, int label)

Methods inherited from class java.lang.Object

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

Field Detail

ip

protected final ij.process.ImageProcessor ip

width

protected final int width

height

protected final int height

labelArray

protected final int[][] labelArray

currentLabel

protected int currentLabel

maxLabel

protected int maxLabel

regions

protected List<RegionLabeling.BinaryRegion> regions

Constructor Detail

RegionLabeling

protected RegionLabeling(ij.process.ByteProcessor ip)

Method Detail

initialize

protected int[][] initialize()

getRegions

public List<RegionLabeling.BinaryRegion> getRegions()

Get an unsorted list of all regions associated with this region labeling.

Returns:

the list of regions.

getRegions

public List<RegionLabeling.BinaryRegion> getRegions(boolean sort)

Get a possibly sorted list of all regions associated with this region labeling.

Parameters:

sort - set true to sort regions by decreasing size.

Returns:

the list of regions.

getLabel

public int getLabel(int u,
                    int v)

Get the label number for the specified image coordinate.

Parameters:

u - the horizontal coordinate.

v - the vertical coordinate.

Returns:

the label number for the given position.

setLabel

protected void setLabel(int u,
                        int v,
                        int label)

resetLabel

protected void resetLabel()

makeLabelImage

public ij.process.ImageProcessor makeLabelImage(boolean color)

Utility method that creates an image of the internal label array.

Parameters:

color - set false to get a 16-bit grayscale image, true for an RGB (24-bit) color image.

Returns:

an image of the label array.

findRegion

public RegionLabeling.BinaryRegion findRegion(int label)

Find the region associated to the given label.

Parameters:

label - the label number.

label - the label number.

Returns:

the associated region object or null if is does not exist.

getRegion

public RegionLabeling.BinaryRegion getRegion(int u,
                                             int v)

Finds the RegionLabeling.BinaryRegion instance associated with the given image position.

Parameters:

u - the horizontal position.

v - the vertical position.

Returns:

The associated RegionLabeling.BinaryRegion object or null if this RegionLabeling has no region at the given position.

makeRandomColor

protected int makeRandomColor()

getRegionPoints

public Iterable<Point> getRegionPoints(RegionLabeling.BinaryRegion r)

Deprecated. This method is not supported any longer. Instead use Iterable<Point> capability of RegionLabeling.BinaryRegion to iterate directly over region points.

Parameters:

r - the binary region.

Returns:

an Iterable to iterate over all region points.