Package com.openinventor.imageviz.engines.mathematicalmorphology.geodesictransformations

Class SoGrayscaleResconstructionProcessing

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.mathematicalmorphology.geodesictransformations.SoGrayscaleResconstructionProcessing

All Implemented Interfaces:

SafeDisposable

public class SoGrayscaleResconstructionProcessing
extends SoImageVizEngine

SoGrayscaleResconstructionProcessing engine. The SoGrayscaleResconstructionProcessing engine removes the light points in a dark image (case Dilation) or the dark points in a light image (case Erosion).

It performs a numerical reconstruction from a grayscale marker image into the grayscale input image.

Case Dilation

This case of use removes the light points in a dark image.

At each step the marker image is dilated by a structuring element of size 1. This algorithm is based on a recursive method whereby the minimum of the dilated image and the mask image is retained and used as the marker image at the next step. This operation is repeated until stability. The number of iterations depends on the input image and the marker image. As shown in the figure 1, peaks and ridges are levelled down, which results in a much more homogeneous output image.

Case Erosion

This case of use removes the dark points in a light image.

At each step the marker image is eroded by a structuring element of size 1. This algorithm is based on a recursive method whereby the maximum of the eroded image and the mask image is retained and used as the marker image at the next step. This operation is repeated until stability. The number of iterations depends on the input image and the marker image. As shown in the figure 2, the valleys are levelled up, which results in a much more homogeneous output image.

This algorithm is used by the SoHExtremaProcessing engine.

See Also:

SoHExtremaProcessing, SoMarkerBasedWatershedProcessing File format/default: GrayscaleResconstructionProcessing { computeMode MODE_AUTO neighborhood3d CONNECTIVITY_26 reconstructMode EROSION inMaskImage NULL inMarkerImage NULL } Library references: dualreconstruct numreconstruct

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	SoGrayscaleResconstructionProcessing.ReconstructModes

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<SoImageVizEngine.ComputeModes>	computeMode	Select the compute Mode (2D or 3D or AUTO) .
SoSFImageDataAdapter	inMarkerImage	The input grayscale marker image containing seeds for reconstruction.
SoSFImageDataAdapter	inMaskImage	The input grayscale mask image constraining reconstruction.
SoSFEnum<SoImageVizEngine.Neighborhood3ds>	neighborhood3d	In 3D configuration (see computeMode), the neighborhood connectivity defines the connectivity considered for processing adjacent voxels.
SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter>	outImage	The output image.
SoSFEnum<SoGrayscaleResconstructionProcessing.ReconstructModes>	reconstructMode	Select the reconstruction mode to use.

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
SoGrayscaleResconstructionProcessing()	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.

reconstructMode

public final SoSFEnum<SoGrayscaleResconstructionProcessing.ReconstructModes> reconstructMode

Select the reconstruction mode to use. . Default is EROSION

inMaskImage

public final SoSFImageDataAdapter inMaskImage

The input grayscale mask image constraining reconstruction. Default value is NULL. Supported types include: grayscale binary label image.

inMarkerImage

public final SoSFImageDataAdapter inMarkerImage

The input grayscale marker image containing seeds for reconstruction. Default value is NULL. Supported types include: grayscale binary label image.

outImage

public final SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter> outImage

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

Constructor Detail

SoGrayscaleResconstructionProcessing

public SoGrayscaleResconstructionProcessing()

Constructor.