com.openinventor.imageviz.engines.edgedetection.laplacian

Class SoDoBFilterProcessing

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.laplacian.SoDoBFilterProcessing

All Implemented Interfaces:

SafeDisposable

public class SoDoBFilterProcessing
extends SoImageVizEngine

SoDoBFilterProcessing engine The SoDoBFilterProcessing engine calculates the difference between two local averages.

For an introduction, see:

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

The SoDoBFilterProcessing calculates the difference between two local averages computed over square neighborhoods of different kernel sizes (Difference Of Boxes) applied on the same image. The operation consists of the same filter performed with two different kernel sizes. Sizes of kernels must be an odd number.

This operation applied to a 1D step edge is shown in the figure below.

Typical size ratios of the neighborhoods (width of /width of ) range between 1.5 and 2.5. and are parametrized by the field largeBoxSize. For example, kernels of 5x5/3x3 or 9X9/5X5 can be used.

The SoDoBFilterProcessing does not compute the Laplacian of an image, but it is a good approximation and has the main advantage of not generating isolated points. To keep a correct representation of the edges and a maximum of detail, do not use very large kernels (3, 5 and 7 are the most frequent values). The deviation between the two masks has a direct effect on the edges. If the difference is too large, the edges are very thick and all small details disappear. If the difference is small (less than 4), the edges are very thin and details more precise.

See also:

SoRecursiveLaplacianProcessing2d.

File format/default:

DoBFilterProcessing {

computeMode	MODE_AUTO
inImage	NULL
smallBoxSize	3
largeBoxSize	7

}

Library references: dob_filter dob_filter3d

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.
SoSFInt32	largeBoxSize The size of the large box.
SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter>	outImage The output image.
SoSFInt32	smallBoxSize The size of the small box.

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

inImage

public final SoSFImageDataAdapter inImage

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

smallBoxSize

public final SoSFInt32 smallBoxSize

The size of the small box. Default value is 3.

largeBoxSize

public final SoSFInt32 largeBoxSize

The size of the large box. Default value is 7.

outImage

public final SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter> outImage

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

Constructor Detail

SoDoBFilterProcessing

public SoDoBFilterProcessing()

Constructor.