SoHExtremaWatershedProcessing Class Reference
[Separating And Filling]

SoHExtremaWatershedProcessing engine computes the watershed lines of a grayscale image. More...

#include <ImageViz/Engines/ImageSegmentation/SeparatingAndFilling/SoHExtremaWatershedProcessing.h>

Inheritance diagram for SoHExtremaWatershedProcessing:

Public Types
enum	ObjectLightness { DARK_OBJECTS = 0, BRIGHT_OBJECTS = 1 }
enum	SeparationMode { SEPARATED_OBJECTS = 0, WATERSHED_RIDGES = 1, SEPARATED_BASINS = 2, CONTIGUOUS_BASINS = 3 }
enum	AlgorithmMode { REPEATABLE = 0, FAST = 1 }
Public Member Functions
	SoHExtremaWatershedProcessing ()
Public Attributes
SoSFEnum	computeMode
SoSFEnum	neighborhood3d
SoSFImageDataAdapter	inGrayImage
SoSFEnum	objectLightness
SoSFEnum	separationMode
SoSFEnum	algorithmMode
SoSFInt32	contrastValue
SoImageVizEngineOutput < SoSFImageDataAdapter, SoImageDataAdapter * >	outSeparationImage

Detailed Description

SoHExtremaWatershedProcessing engine computes the watershed lines of a grayscale image.

This engine computes the watershed lines of a grayscale image. It directly uses the image for black objects and the inverted image for white objects. You can adjust the contrast level which is used to reduce the number of markers for the watershed process.

This engine is a high-level combination of watershed, distance transform and numerical reconstruction algorithms. There is a limitation to the separating ability: if some particles overlap too much, they will not be separated. This engine can be used on the gradient modulus to compute best-fit contours.

Notice: This engine requires to preliminarily load the whole input data set into memory to be computed. As a consequence the input data set will be automatically loaded before the execution of this engine, ignoring the maximum memory parameter of the SbImageDataAdapterHelper::getAppropriateAdapter function or SoFileDataAdapter class

If the input data set cannot fit in memory, this engine will fail during its computation.

FILE FORMAT/DEFAULT

computeMode	MODE_AUTO
neighborhood3d	CONNECTIVITY_26
inGrayImage	NULL
objectLightness	DARK_OBJECTS
separationMode	SEPARATED_OBJECTS
algorithmMode	REPEATABLE
contrastValue	30

Library references: greyseparate

Member Enumeration Documentation

enum SoHExtremaWatershedProcessing::AlgorithmMode

Enumerator:

REPEATABLE	Repeatable but slower.
FAST	Faster but not repeatable because of asynchronous parallel computation.

enum SoHExtremaWatershedProcessing::ObjectLightness

Enumerator:

DARK_OBJECTS	The engine applies to black particles.
BRIGHT_OBJECTS	The engine applies to white particles.

enum SoHExtremaWatershedProcessing::SeparationMode

Enumerator:

SEPARATED_OBJECTS	The result data is the original data minus separation lines (binary image of split particles).
WATERSHED_RIDGES	The result data is the separation lines (binary image).
SEPARATED_BASINS	The result data is the watersheds (label image).
CONTIGUOUS_BASINS	The result data is the watersheds without separation lines (label image).