com.openinventor.imageviz.engines.edgedetection.gradient

Class SoGradientOperatorProcessing3d

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

All Implemented Interfaces:

SafeDisposable

public class SoGradientOperatorProcessing3d
extends SoImageVizEngine

SoGradientOperatorProcessing3d engine provides different operators to extract the edges from a 3D image. For an introduction, see:

• section Edge Detection
• section Images Filters
• Introduction to Gradient

The SoGradientOperatorProcessing3d engine provides different operators to extract the edges from an image:

• Canny-Deriche: It performs a recursive gradient computation to get the gradient in X, Y and Z directions. It is an FIR (finite impulse response) filter. To minimize the effect of noise, it smooths the image before computing the gradient. A smoothing scale parameter determines the smoothing intensity. If the value is large, noise will be reduced but edges will be less sharp and only the most significant edges will survive. It is important to select the right coefficient to lower the noise just enough without defocusing the edges. Then it gets the maximum of these images with a gradient magnitude operation. For color images it calculates the maximum of intensity or the euclidian mean.
• Canny: It performs an approximation of to get the Canny Deriche in X and Y directions using a convolution kernel 7x5x5 for X, 5x7x5 for Y and 5x5x7 for Z. The result is nearly the same as with Canny Deriche but the processing is much faster.
• Gaussian: It performs a convolution with the derivatives of a gaussian function along each image axis.
• Sobel: It performs a convolution with the Sobel Kernel. This kernel is the 3D generalization of the Sobel kernel described in SoGradientOperatorProcessing2d
• Prewitt: It performs a convolution with the Prewitt Kernel. This kernel is the 3D generalization of the Prewitt kernel described in SoGradientOperatorProcessing2d

See also:

SoRadialGradientCenteredProcessing3d, SoMorphologicalGradientProcessing

File format/default:

GradientOperatorProcessing3d {

inImage	NULL
gradientOperator	CANNY_DERICHE
gradientMode	AMPLITUDE_MAX_OF_MAGS
standardDeviation	60.0f

}

Library references: gradient3d

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SoGradientOperatorProcessing3d.GradientModes
static class	SoGradientOperatorProcessing3d.GradientOperators

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<SoGradientOperatorProcessing3d.GradientModes>	gradientMode Select an output mode.
SoSFEnum<SoGradientOperatorProcessing3d.GradientOperators>	gradientOperator Select the gradient operator.
SoSFImageDataAdapter	inImage The input grayscale image.
SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter>	outAmplitudeImage The output gradient amplitude image.
SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter>	outGradientXImage The output X-gradient image.
SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter>	outGradientYImage The output Y-gradient image.
SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter>	outGradientZImage The output Z-gradient image.
SoSFFloat	standardDeviation The standard deviation.

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 and Description
SoGradientOperatorProcessing3d() 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

inImage

public final SoSFImageDataAdapter inImage

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

gradientOperator

public final SoSFEnum<SoGradientOperatorProcessing3d.GradientOperators> gradientOperator

Select the gradient operator. . Default is CANNY_DERICHE

gradientMode

public final SoSFEnum<SoGradientOperatorProcessing3d.GradientModes> gradientMode

Select an output mode. . Default is AMPLITUDE_MAX_OF_MAGS

standardDeviation

public final SoSFFloat standardDeviation

The standard deviation. Default value is 60.0f.

outGradientXImage

public final SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter> outGradientXImage

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

outGradientYImage

public final SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter> outGradientYImage

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

outGradientZImage

public final SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter> outGradientZImage

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

outAmplitudeImage

public final SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter> outAmplitudeImage

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

Constructor Detail

SoGradientOperatorProcessing3d

public SoGradientOperatorProcessing3d()

Constructor.