com.openinventor.imageviz.engines.imagesegmentation.separatingandfilling

Class SoExpandLabelsProcessing

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

All Implemented Interfaces:

SafeDisposable

public class SoExpandLabelsProcessing
extends SoImageVizEngine

SoExpandLabelsProcessing engine The SoExpandLabelsProcessing engine performs an label expansion of an image.

For an introduction, see:

• section Morphology
• Introduction and definition for dilations

The label expansion cans be performed either with a REGIONS mode or an OBJECTS mode.

REGIONS mode

The engine performs an iterative dilation of a label image. It stops the process when the complete image is covered.

Figure 1: Example of label expansion with REGIONS mode

OBJECTS mode

The engine performs a constrained dilation of a label image. Its first aim is to expand labels obtained by using an SoMarkerBasedWatershedProcessing engine with CATCHMENT mode, so that all black pixels of the boundaries are filled with the value of the most present label among the height neighbors.

See also:

SoMarkerBasedWatershedProcessing, SoGrayscaleResconstructionProcessing.

File format/default:

ExpandLabelsProcessing {

computeMode	MODE_AUTO
neighborhood3d	CONNECTIVITY_26
expandMode	OBJECTS
inLabelImage	NULL

}

Library references: dilatebasin dilateextrlab

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SoExpandLabelsProcessing.ExpandModes

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<SoImageVizEngine.ComputeModes>	computeMode Select the compute Mode (2D or 3D or AUTO) .
SoSFEnum<SoExpandLabelsProcessing.ExpandModes>	expandMode Select the type of expansion to perform.
SoSFImageDataAdapter	inLabelImage The input label image.
SoSFEnum<SoImageVizEngine.Neighborhood3ds>	neighborhood3d In 3D configuration (see computeMode), the neighborhood connectivity defines the connectivity considered for processing adjacent voxels.
static int	OBJECTS Deprecated. Use SoExpandLabelsProcessing.ExpandModes.OBJECTS instead.
SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter>	outLabelImage The output label image.
static int	REGIONS Deprecated. Use SoExpandLabelsProcessing.ExpandModes.REGIONS 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
SoExpandLabelsProcessing() 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

REGIONS

@Deprecated
public static final int REGIONS

Deprecated. Use SoExpandLabelsProcessing.ExpandModes.REGIONS instead.

OBJECTS

@Deprecated
public static final int OBJECTS

Deprecated. Use SoExpandLabelsProcessing.ExpandModes.OBJECTS 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.

expandMode

public final SoSFEnum<SoExpandLabelsProcessing.ExpandModes> expandMode

Select the type of expansion to perform. . Default is OBJECTS

inLabelImage

public final SoSFImageDataAdapter inLabelImage

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

outLabelImage

public final SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter> outLabelImage

The output label image. Default value is NULL. Supported types include: label image.

Constructor Detail

SoExpandLabelsProcessing

public SoExpandLabelsProcessing()

Constructor.