com.openinventor.imageviz.engines.mathematicalmorphology.geodesictransformations

Class SoReconstructionFromMarkersProcessing

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

All Implemented Interfaces:

SafeDisposable

public class SoReconstructionFromMarkersProcessing
extends SoImageVizEngine

SoReconstructionFromMarkersProcessing engine The SoReconstructionFromMarkersProcessing engine rebuilds an image starting from markers.

For an introduction, see section Morphology.

This engine rebuilds a set of objects identified by markers and retrieves only the objects containing (at least) a marker.

Successive dilations are performed on the markers, each dilation being followed by an intersection with the original image until convergence (idempotence). This iterative process is called a geodesic dilation. It guarantees that a dilated marker will not merge into a particle other than the it marks.

Geodesic dilation is different from a large dilation of a given size followed by an intersection with the original image because a dilated marker may hit close particles which are not marked for reconstruction.

For example, given an erosion which eliminated the small particles of an image, this engine can rebuild the original shapes of the remaining particles if the eroded set is used as the markers.

See also:

SoBorderKillProcessing, SoObjectBoundariesProcessing.

File format/default:

ReconstructionFromMarkersProcessing {

computeMode	MODE_AUTO
neighborhood3d	CONNECTIVITY_26
inMaskImage	NULL
inMarkerImage	NULL

}

Library references: reconstruct

Nested Class Summary

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) .
SoSFImageDataAdapter	inMarkerImage The binary marker image containing seeds for reconstruction.
SoSFImageDataAdapter	inMaskImage The binary 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.

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
SoReconstructionFromMarkersProcessing() 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

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.

inMaskImage

public final SoSFImageDataAdapter inMaskImage

The binary mask image constraining reconstruction. Default value is NULL. Supported types include: binary color image.

inMarkerImage

public final SoSFImageDataAdapter inMarkerImage

The binary marker image containing seeds for reconstruction. Default value is NULL. Supported types include: binary color 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

SoReconstructionFromMarkersProcessing

public SoReconstructionFromMarkersProcessing()

Constructor.