com.openinventor.imageviz.engines.imagesegmentation.separatingandfilling

Class SoHExtremaWatershedProcessing

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.SoHExtremaWatershedProcessing

All Implemented Interfaces:

SafeDisposable

public class SoHExtremaWatershedProcessing
extends SoImageVizEngine

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.

See also:

SoSeparateObjectsProcessing.

File format/default:

HExtremaWatershedProcessing {

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

}

Library references: greyseparate

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SoHExtremaWatershedProcessing.AlgorithmModes
static class	SoHExtremaWatershedProcessing.ObjectLightnessType
static class	SoHExtremaWatershedProcessing.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 and Description
SoSFEnum<SoHExtremaWatershedProcessing.AlgorithmModes>	algorithmMode Select the algorithm mode for fastwatershed.
static int	BRIGHT_OBJECTS Deprecated. Use SoHExtremaWatershedProcessing.ObjectLightnessType.BRIGHT_OBJECTS instead.
SoSFEnum<SoImageVizEngine.ComputeModes>	computeMode Select the compute Mode (2D or 3D or AUTO) .
static int	CONTIGUOUS_BASINS Deprecated. Use SoHExtremaWatershedProcessing.SeparationModes.CONTIGUOUS_BASINS instead.
SoSFInt32	contrastValue The depth of valley.
static int	DARK_OBJECTS Deprecated. Use SoHExtremaWatershedProcessing.ObjectLightnessType.DARK_OBJECTS instead.
static int	FAST Deprecated. Use SoHExtremaWatershedProcessing.AlgorithmModes.FAST instead.
SoSFImageDataAdapter	inGrayImage The input grayscale image.
SoSFEnum<SoImageVizEngine.Neighborhood3ds>	neighborhood3d In 3D configuration (see computeMode), the neighborhood connectivity defines the connectivity considered for processing adjacent voxels.
SoSFEnum<SoHExtremaWatershedProcessing.ObjectLightnessType>	objectLightness Select the lightness mode for object to separate.
SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter>	outSeparationImage The output separation (binary or label) image.
static int	REPEATABLE Deprecated. Use SoHExtremaWatershedProcessing.AlgorithmModes.REPEATABLE instead.
static int	SEPARATED_BASINS Deprecated. Use SoHExtremaWatershedProcessing.SeparationModes.SEPARATED_BASINS instead.
static int	SEPARATED_OBJECTS Deprecated. Use SoHExtremaWatershedProcessing.SeparationModes.SEPARATED_OBJECTS instead.
SoSFEnum<SoHExtremaWatershedProcessing.SeparationModes>	separationMode Select the output image type: separation lines, split objects or separated basins.
static int	WATERSHED_RIDGES Deprecated. Use SoHExtremaWatershedProcessing.SeparationModes.WATERSHED_RIDGES instead.

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

CONNECTIVITY_18, CONNECTIVITY_26, CONNECTIVITY_6, MODE_2D, MODE_3D, MODE_AUTO, onBegin, onEnd, onProgress

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Constructor Summary

Constructors

Constructor and Description
SoHExtremaWatershedProcessing() 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, getEXTERNPROTO, getName, getPROTO, isDisposable, isSynchronizable, setName, setSynchronizable, touch

Methods inherited from class com.openinventor.inventor.Inventor

getAddress, getNativeResourceHandle, startInternalThreads, stopInternalThreads

Methods inherited from class java.lang.Object

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

Field Detail

DARK_OBJECTS

@Deprecated
public static final int DARK_OBJECTS

Deprecated. Use SoHExtremaWatershedProcessing.ObjectLightnessType.DARK_OBJECTS instead.

BRIGHT_OBJECTS

@Deprecated
public static final int BRIGHT_OBJECTS

Deprecated. Use SoHExtremaWatershedProcessing.ObjectLightnessType.BRIGHT_OBJECTS instead.

SEPARATED_OBJECTS

@Deprecated
public static final int SEPARATED_OBJECTS

Deprecated. Use SoHExtremaWatershedProcessing.SeparationModes.SEPARATED_OBJECTS instead.

WATERSHED_RIDGES

@Deprecated
public static final int WATERSHED_RIDGES

Deprecated. Use SoHExtremaWatershedProcessing.SeparationModes.WATERSHED_RIDGES instead.

SEPARATED_BASINS

@Deprecated
public static final int SEPARATED_BASINS

Deprecated. Use SoHExtremaWatershedProcessing.SeparationModes.SEPARATED_BASINS instead.

CONTIGUOUS_BASINS

@Deprecated
public static final int CONTIGUOUS_BASINS

Deprecated. Use SoHExtremaWatershedProcessing.SeparationModes.CONTIGUOUS_BASINS instead.

REPEATABLE

@Deprecated
public static final int REPEATABLE

Deprecated. Use SoHExtremaWatershedProcessing.AlgorithmModes.REPEATABLE instead.

FAST

@Deprecated
public static final int FAST

Deprecated. Use SoHExtremaWatershedProcessing.AlgorithmModes.FAST instead.

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.

inGrayImage

public final SoSFImageDataAdapter inGrayImage

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

objectLightness

public final SoSFEnum<SoHExtremaWatershedProcessing.ObjectLightnessType> objectLightness

Select the lightness mode for object to separate. . Default is DARK_OBJECTS

separationMode

public final SoSFEnum<SoHExtremaWatershedProcessing.SeparationModes> separationMode

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

algorithmMode

public final SoSFEnum<SoHExtremaWatershedProcessing.AlgorithmModes> algorithmMode

Select the algorithm mode for fastwatershed. . Default is REPEATABLE

contrastValue

public final SoSFInt32 contrastValue

The depth of valley. Default value is 30.

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

SoHExtremaWatershedProcessing

public SoHExtremaWatershedProcessing()

Constructor.