Package com.openinventor.imageviz.engines.imagesegmentation.separatingandfilling

Class SoSeparateObjectsProcessing

java.lang.Object

com.openinventor.inventor.Inventor

com.openinventor.inventor.misc.SoBase

com.openinventor.inventor.fields.SoFieldContainer

com.openinventor.inventor.engines.SoEngine

com.openinventor.imageviz.engines.SoImageVizEngine

com.openinventor.imageviz.engines.imagesegmentation.separatingandfilling.SoSeparateObjectsProcessing

All Implemented Interfaces:

SafeDisposable

public class SoSeparateObjectsProcessing
extends SoImageVizEngine

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

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	SoSeparateObjectsProcessing.AlgorithmModes
static class	SoSeparateObjectsProcessing.SeparationModes

Nested classes/interfaces inherited from class com.openinventor.imageviz.engines.SoImageVizEngine

SoImageVizEngine.ComputeModes, SoImageVizEngine.EventArg, SoImageVizEngine.Neighborhood3ds

Nested classes/interfaces inherited from class com.openinventor.inventor.Inventor

Inventor.ConstructorCommand

Field Summary

Fields

Modifier and Type	Field	Description
SoSFEnum<SoSeparateObjectsProcessing.AlgorithmModes>	algorithmMode	Select the algorithm mode for fastwatershed.
SoSFEnum<SoImageVizEngine.ComputeModes>	computeMode	Select the compute Mode (2D or 3D or AUTO) .
SoSFInt32	contrastValue	The depth of valley.
SoSFImageDataAdapter	inBinaryImage	The input binary image.
SoSFEnum<SoImageVizEngine.Neighborhood3ds>	neighborhood3d	In 3D configuration (see computeMode), the neighborhood connectivity defines the connectivity considered for processing adjacent voxels.
SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter>	outSeparationImage	The output separation (binary or label) image.
SoSFEnum<SoSeparateObjectsProcessing.SeparationModes>	separationMode	Select the output image type: separation lines, split objects, separated basins or joined basins.

Fields inherited from class com.openinventor.imageviz.engines.SoImageVizEngine

onBegin, onEnd, onProgress

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Constructor Summary

Constructors

Constructor	Description
SoSeparateObjectsProcessing()	Constructor.

Method Summary

Methods inherited from class com.openinventor.imageviz.engines.SoImageVizEngine

abortEvaluate, isEvaluating, startEvaluate, waitEvaluate

Methods inherited from class com.openinventor.inventor.engines.SoEngine

copy, getByName, getOutput, getOutputName

Methods inherited from class com.openinventor.inventor.fields.SoFieldContainer

copyFieldValues, copyFieldValues, enableNotify, fieldsAreEqual, get, getAllFields, getEventIn, getEventOut, getField, getFieldName, hasDefaultValues, isNotifyEnabled, set, setToDefaults

Methods inherited from class com.openinventor.inventor.misc.SoBase

dispose, getName, isDisposable, isSynchronizable, setName, setSynchronizable, touch

Methods inherited from class com.openinventor.inventor.Inventor

getNativeResourceHandle

Methods inherited from class java.lang.Object

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

Field Detail

computeMode

public final SoSFEnum<SoImageVizEngine.ComputeModes> computeMode

Select the compute Mode (2D or 3D or AUTO) . Default is MODE_AUTO

neighborhood3d

public final SoSFEnum<SoImageVizEngine.Neighborhood3ds> neighborhood3d

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

inBinaryImage

public final SoSFImageDataAdapter inBinaryImage

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

separationMode

public final SoSFEnum<SoSeparateObjectsProcessing.SeparationModes> separationMode

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

algorithmMode

public final SoSFEnum<SoSeparateObjectsProcessing.AlgorithmModes> algorithmMode

Select the algorithm mode for fastwatershed. . Default is REPEATABLE

contrastValue

public final SoSFInt32 contrastValue

The depth of valley. Default value is 4.

outSeparationImage

public final SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter> outSeparationImage

The output separation (binary or label) image. Default value is NULL. Supported types include: grayscale binary label color image.

Constructor Detail

SoSeparateObjectsProcessing

public SoSeparateObjectsProcessing()

Constructor.