com.openinventor.imageviz.engines.edgedetection.gradient

Class SoMorphologicalGradientProcessing

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.edgedetection.gradient.SoMorphologicalGradientProcessing

All Implemented Interfaces:

SafeDisposable

public class SoMorphologicalGradientProcessing
extends SoImageVizEngine

SoMorphologicalGradientProcessing engine The SoMorphologicalGradientProcessing engine emphasizes the edges of the objects using morphological operations.

For an introduction, see:

• section Morphology
• section Edge Detection
• Introduction to Gradient

This engine emphasizes the edges of the objects using morphological operations. Two modes allow to enhance edges inside (Internal) or outside (External) of particles.

The SoMorphologicalGradientProcessing engine: (each with label image in overlay):
1: gray input image, 2: internal morphological gradient and 3: external morphological gradient.

This engine uses SoErosionDiskProcessing2d or SoDilationDiskProcessing2d in 2D case and SoErosionBallProcessing3d or SoDilationBallProcessing3d in 3D case. Two additional parameters are also provided : Precision of the computation (Faster or Precise) and half-kernel size for morphological operation.

See also:

SoGradientOperatorProcessing2d, SoRadialGradientCenteredProcessing2d.

File format/default:

MorphologicalGradientProcessing {

computeMode	MODE_AUTO
inImage	NULL
gradientMode	INTERNAL
precisionMode	FASTER
elementSize	3

}

Library references: morphogradient

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SoMorphologicalGradientProcessing.GradientModes
static class	SoMorphologicalGradientProcessing.PrecisionModes

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) .
SoSFInt32	elementSize The half size of the structuring element.
static int	EXTERNAL Deprecated. Use SoMorphologicalGradientProcessing.GradientModes.EXTERNAL instead.
static int	FASTER Deprecated. Use SoMorphologicalGradientProcessing.PrecisionModes.FASTER instead.
SoSFEnum<SoMorphologicalGradientProcessing.GradientModes>	gradientMode Select the computation mode for morphological gradient.
SoSFImageDataAdapter	inImage The input image.
static int	INTERNAL Deprecated. Use SoMorphologicalGradientProcessing.GradientModes.INTERNAL instead.
SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter>	outImage The output image.
static int	PRECISE Deprecated. Use SoMorphologicalGradientProcessing.PrecisionModes.PRECISE instead.
SoSFEnum<SoMorphologicalGradientProcessing.PrecisionModes>	precisionMode Select the precision for computation method.

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

INTERNAL

@Deprecated
public static final int INTERNAL

Deprecated. Use SoMorphologicalGradientProcessing.GradientModes.INTERNAL instead.

EXTERNAL

@Deprecated
public static final int EXTERNAL

Deprecated. Use SoMorphologicalGradientProcessing.GradientModes.EXTERNAL instead.

FASTER

@Deprecated
public static final int FASTER

Deprecated. Use SoMorphologicalGradientProcessing.PrecisionModes.FASTER instead.

PRECISE

@Deprecated
public static final int PRECISE

Deprecated. Use SoMorphologicalGradientProcessing.PrecisionModes.PRECISE instead.

computeMode

public final SoSFEnum<SoImageVizEngine.ComputeModes> computeMode

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

inImage

public final SoSFImageDataAdapter inImage

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

gradientMode

public final SoSFEnum<SoMorphologicalGradientProcessing.GradientModes> gradientMode

Select the computation mode for morphological gradient. . Default is INTERNAL

precisionMode

public final SoSFEnum<SoMorphologicalGradientProcessing.PrecisionModes> precisionMode

Select the precision for computation method. . Default is FASTER

elementSize

public final SoSFInt32 elementSize

The half size of the structuring element. A structuring element always has an odd side length (3x3, 5x5, etc) which is defined by 2 * elementSize + 1. Default value is 3.

outImage

public final SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter> outImage

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

Constructor Detail

SoMorphologicalGradientProcessing

public SoMorphologicalGradientProcessing()

Constructor.