com.openinventor.imageviz.engines.imagefiltering.smoothinganddenoising

Class SoDespeckleProcessing

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.imagefiltering.smoothinganddenoising.SoDespeckleProcessing

All Implemented Interfaces:

SafeDisposable

public class SoDespeckleProcessing
extends SoImageVizEngine

SoDespeckleProcessing engine The SoDespeckleProcessing engine smooths an image replacing aberrant values by the mean value of their neighbors

For an introduction to image filters, see section Images Filters.

This engine smooths an image replacing aberrant values by the mean value of their neighbors. For each voxels of the input image, mean and standard deviation values of the rectangular neighbor's window are computed. The output image value is then given by:

Where is a user threshold factor on distance of current voxel gray level to the mean of its neighbors relatively to their standard deviation. The greater is, the stronger the blur is. This filter gives good results in case of impulse noise.

See also:

SoBilateralFilterProcessing, SoSigmaFilterProcessing, SoUnsharpMaskingProcessing.

File format/default:

DespeckleProcessing {

computeMode	MODE_AUTO
kernelSize	3 3 3
inImage	NULL
thresholdFactor	1.0f

}

Library references: despecklefilter despecklefilter3d

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	inImage The input image.
SoSFVec3i32	kernelSize kernel size in each direction (odd values).
SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter>	outImage The output image.
SoSFFloat	thresholdFactor Stddev threshold factor (strictly positive value).

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

kernelSize

public final SoSFVec3i32 kernelSize

kernel size in each direction (odd values). Default value is SbVec3i32(3,3,3)

inImage

public final SoSFImageDataAdapter inImage

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

thresholdFactor

public final SoSFFloat thresholdFactor

Stddev threshold factor (strictly positive value). Default value is 1.0f.

outImage

public final SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter> outImage

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

Constructor Detail

SoDespeckleProcessing

public SoDespeckleProcessing()

Constructor.