com.openinventor.imageviz.engines.imagesegmentation.binarization

Class SoTopHatProcessing

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

All Implemented Interfaces:

SafeDisposable

public class SoTopHatProcessing
extends SoImageVizEngine

SoTopHatProcessing image filter The SoTopHatProcessing engine performs a Top-Hat algorithm on a gray level image.

The Top-Hat segmentation extracts small elements and details from given images. It detects the dark or the bright area, corresponding to the valleys or the narrow peaks. There exist two types of Top-Hat transform:

• The Black Top-Hat: it is defined as the difference between the closing with a particular kernel and the input image. The smaller is the kernel, the smaller are the elements in the Top-Hat image. A threshold allows selecting the darker elements of the Top-Hat result, i.e., the depth of the selected valleys. See Figure 1.
• The White Top-Hat: it is defined as the difference between the input image and its opening (using a particular kernel). The threshold allows selecting the brighter elements of the Top-Hat result.

The Top-Hat module is divided into two phases:

• The Top-Hat image computation, depending on the Top-Hat type and the closing/opening parameters; (step 1 and 2 on figure 1)
• The Thresholding, to select the valleys/narrow peaks depth. (step 3 on figure 1)

The SoTopHatProcessing engine also includes a rough and a smooth mode. Whereas the rough mode uses a standard structuring element, the smooth mode employs a more sophisticated volumic structuring element, a rhombodecahedron, which usually generates a much more precise Top-Hat.

File format/default:

TopHatProcessing {

computeMode	MODE_AUTO
elementShape	ROUGH
inGrayImage	NULL
elementSize	3
objectLightness	BRIGHT_OBJECTS
thresholdLevel	128.0f 255.0f

}

Library references: high_tophat tophat

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SoTopHatProcessing.ElementShapes
static class	SoTopHatProcessing.ObjectLightnessType

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	BRIGHT_OBJECTS Deprecated. Use SoTopHatProcessing.ObjectLightnessType.BRIGHT_OBJECTS instead.
SoSFEnum<SoImageVizEngine.ComputeModes>	computeMode Select the compute Mode (2D or 3D or AUTO) .
static int	DARK_OBJECTS Deprecated. Use SoTopHatProcessing.ObjectLightnessType.DARK_OBJECTS instead.
SoSFEnum<SoTopHatProcessing.ElementShapes>	elementShape Select the type of structuring element shape.
SoSFInt32	elementSize The half size of the structuring element.
SoSFImageDataAdapter	inGrayImage Input grey level image.
SoSFEnum<SoTopHatProcessing.ObjectLightnessType>	objectLightness Select the lightness mode for object to detect.
SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter>	outBinaryImage The output binary image.
static int	ROUGH Deprecated. Use SoTopHatProcessing.ElementShapes.ROUGH instead.
static int	SMOOTH Deprecated. Use SoTopHatProcessing.ElementShapes.SMOOTH instead.
SoSFVec2f	thresholdLevel The low and high threshold levels.

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

ROUGH

@Deprecated
public static final int ROUGH

Deprecated. Use SoTopHatProcessing.ElementShapes.ROUGH instead.

SMOOTH

@Deprecated
public static final int SMOOTH

Deprecated. Use SoTopHatProcessing.ElementShapes.SMOOTH instead.

BRIGHT_OBJECTS

@Deprecated
public static final int BRIGHT_OBJECTS

Deprecated. Use SoTopHatProcessing.ObjectLightnessType.BRIGHT_OBJECTS instead.

DARK_OBJECTS

@Deprecated
public static final int DARK_OBJECTS

Deprecated. Use SoTopHatProcessing.ObjectLightnessType.DARK_OBJECTS instead.

computeMode

public final SoSFEnum<SoImageVizEngine.ComputeModes> computeMode

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

elementShape

public final SoSFEnum<SoTopHatProcessing.ElementShapes> elementShape

Select the type of structuring element shape. . Default is ROUGH

inGrayImage

public final SoSFImageDataAdapter inGrayImage

Input grey level image. Default value is NULL. Supported types include: grayscale binary label image.

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.

objectLightness

public final SoSFEnum<SoTopHatProcessing.ObjectLightnessType> objectLightness

Select the lightness mode for object to detect. . Default is BRIGHT_OBJECTS

thresholdLevel

public final SoSFVec2f thresholdLevel

The low and high threshold levels. Default value is SbVec2f(128.0f,255.0f).

outBinaryImage

public final SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter> outBinaryImage

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

Constructor Detail

SoTopHatProcessing

public SoTopHatProcessing()

Constructor.