SoSeparateObjectsProcessing Class Reference
[Separating And Filling]

SoSeparateObjectsProcessing engine separates objects in a binary image. More...

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

Inheritance diagram for SoSeparateObjectsProcessing:

List of all members.

Public Types
enum	SeparationMode {   SEPARATED_OBJECTS = 0,   WATERSHED_RIDGES = 1,   SEPARATED_BASINS = 2,   CONTIGUOUS_BASINS = 3,   CONTIGUOUS_OBJECTS = 4 }
enum	AlgorithmMode {   REPEATABLE = 0,   FAST = 1 }
Public Member Functions
	SoSeparateObjectsProcessing ()
Public Attributes
SoSFEnum	computeMode
SoSFEnum	neighborhood3d
SoSFImageDataAdapter	inBinaryImage
SoSFEnum	separationMode
SoSFEnum	algorithmMode
SoSFInt32	contrastValue
SoImageVizEngineOutput < SoSFImageDataAdapter, SoImageDataAdapter * >	outSeparationImage

---

Detailed Description

SoSeparateObjectsProcessing engine separates objects in a binary image.

This engine computes the watershed lines of a binary image. 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.

SEE ALSO

SoHExtremaWatershedProcessing.

FILE FORMAT/DEFAULT

SeparateObjectsProcessing {

computeMode	MODE_AUTO
neighborhood3d	CONNECTIVITY_26
inBinaryImage	NULL
separationMode	SEPARATED_OBJECTS
algorithmMode	REPEATABLE
contrastValue	4

}

Library references: binseparate

See related examples:

StandardWorkflow, WorkflowWithRoi

---

Member Enumeration Documentation

enum SoSeparateObjectsProcessing::AlgorithmMode

Enumerator:

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

enum SoSeparateObjectsProcessing::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).
CONTIGUOUS_OBJECTS	The result data is the original image labelized taking into account the watersheds (label image).

---

Constructor & Destructor Documentation

SoSeparateObjectsProcessing::SoSeparateObjectsProcessing

(

)

Constructor.

---

Member Data Documentation

SoSFEnum SoSeparateObjectsProcessing::algorithmMode

Select the algorithm mode for fastwatershed.

Use enum AlgorithmMode. Default is REPEATABLE

SoSFEnum SoSeparateObjectsProcessing::computeMode

Select the compute Mode (2D or 3D or AUTO) Use enum ComputeMode.

Default is MODE_AUTO

SoSFInt32 SoSeparateObjectsProcessing::contrastValue

The depth of valley.

Default value is 4.

SoSFImageDataAdapter SoSeparateObjectsProcessing::inBinaryImage

The input binary image.

Default value is NULL. Supported types include: binary color image.

SoSFEnum SoSeparateObjectsProcessing::neighborhood3d

In 3D configuration (see computeMode), the neighborhood connectivity defines the connectivity considered for processing adjacent voxels.

Use enum Neighborhood3d. Default is CONNECTIVITY_26.

SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter*> SoSeparateObjectsProcessing::outSeparationImage

The output separation (binary or label) image.

Default value is NULL. Supported types include: grayscale binary label color image.

SoSFEnum SoSeparateObjectsProcessing::separationMode

Select the output image type: separation lines, split objects, separated basins or joined basins.

Use enum SeparationMode. Default is SEPARATED_OBJECTS

---

The documentation for this class was generated from the following file:

• ImageViz/Engines/ImageSegmentation/SeparatingAndFilling/SoSeparateObjectsProcessing.h