com.openinventor.imageviz.engines.imagesegmentation.binarization

Class SoLocalAdaptiveThresholdProcessing

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.imagesegmentation.binarization.SoLocalAdaptiveThresholdProcessing

All Implemented Interfaces:

SafeDisposable

public class SoLocalAdaptiveThresholdProcessing
extends SoImageVizEngine

SoLocalAdaptiveThresholdProcessing engine The SoLocalAdaptiveThresholdProcessing engine performs a binarization of a grayscale image based on the mean intensity of a sliding window centered around each voxel.

Each voxel value is compared to the mean intensity of its local window. The corresponding voxel in the binary output depends on the threshold value, mode, and comparison criterion.

In additive mode with comparison criterion set to GREATER_OR_EQUAL, the output is set to 1 if .

In multiplicative mode with comparison criterion set to GREATER_OR_EQUAL, the output is set to 1 if .

For example to select voxels lower than 90% of their local mean, set threshold field to 0.9, comparisonCriterion field to LESS_OR_EQUAL and thresholdMode field to MULTIPLICATIVE.

See also:

: SoAdaptiveThresholdingProcessing, SoAutoThresholdingProcessing.

File format/default:

LocalAdaptiveThresholdProcessing {

computeMode	MODE_AUTO
kernelSize	30 30 30
inImage	NULL
threshold	1.0f
comparisonCriterion	GREATER_OR_EQUAL
thresholdMode	MULTIPLICATIVE

}

Library references: local_adaptive_threshold2d local_adaptive_threshold3d

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SoLocalAdaptiveThresholdProcessing.ComparisonCriterions
static class	SoLocalAdaptiveThresholdProcessing.ThresholdModes

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
static int	ADDITIVE Deprecated. Use SoLocalAdaptiveThresholdProcessing.ThresholdModes.ADDITIVE instead.
SoSFEnum<SoLocalAdaptiveThresholdProcessing.ComparisonCriterions>	comparisonCriterion Select the comparison test to perform between image and value.
SoSFEnum<SoImageVizEngine.ComputeModes>	computeMode Select the compute Mode (2D or 3D or AUTO) .
static int	GREATER_OR_EQUAL Deprecated. Use SoLocalAdaptiveThresholdProcessing.ComparisonCriterions.GREATER_OR_EQUAL instead.
SoSFImageDataAdapter	inImage Input image.
SoSFVec3i32	kernelSize The kernel size in each direction for computing the mean intensity.
static int	LESS_OR_EQUAL Deprecated. Use SoLocalAdaptiveThresholdProcessing.ComparisonCriterions.LESS_OR_EQUAL instead.
static int	MULTIPLICATIVE Deprecated. Use SoLocalAdaptiveThresholdProcessing.ThresholdModes.MULTIPLICATIVE instead.
SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter>	outBinaryImage The output binary image.
SoSFFloat	threshold Enter a floating value Default value is 1.0f.
SoSFEnum<SoLocalAdaptiveThresholdProcessing.ThresholdModes>	thresholdMode Local threshold mode .

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

GREATER_OR_EQUAL

@Deprecated
public static final int GREATER_OR_EQUAL

Deprecated. Use SoLocalAdaptiveThresholdProcessing.ComparisonCriterions.GREATER_OR_EQUAL instead.

LESS_OR_EQUAL

@Deprecated
public static final int LESS_OR_EQUAL

Deprecated. Use SoLocalAdaptiveThresholdProcessing.ComparisonCriterions.LESS_OR_EQUAL instead.

MULTIPLICATIVE

@Deprecated
public static final int MULTIPLICATIVE

Deprecated. Use SoLocalAdaptiveThresholdProcessing.ThresholdModes.MULTIPLICATIVE instead.

ADDITIVE

@Deprecated
public static final int ADDITIVE

Deprecated. Use SoLocalAdaptiveThresholdProcessing.ThresholdModes.ADDITIVE instead.

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

The kernel size in each direction for computing the mean intensity. Default value is SbVec3i32(30,30,30)

inImage

public final SoSFImageDataAdapter inImage

Input image. The type of image can be integer or float Default value is NULL. Supported types include: grayscale image.

threshold

public final SoSFFloat threshold

Enter a floating value Default value is 1.0f.

comparisonCriterion

public final SoSFEnum<SoLocalAdaptiveThresholdProcessing.ComparisonCriterions> comparisonCriterion

Select the comparison test to perform between image and value. . Default is GREATER_OR_EQUAL

thresholdMode

public final SoSFEnum<SoLocalAdaptiveThresholdProcessing.ThresholdModes> thresholdMode

Local threshold mode . Default is MULTIPLICATIVE

outBinaryImage

public final SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter> outBinaryImage

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

Constructor Detail

SoLocalAdaptiveThresholdProcessing

public SoLocalAdaptiveThresholdProcessing()

Constructor.