com.openinventor.imageviz.engines.imagefiltering.grayscaletransforms

Class SoHistogramEqualizationProcessing

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.grayscaletransforms.SoHistogramEqualizationProcessing

All Implemented Interfaces:

SafeDisposable

public class SoHistogramEqualizationProcessing
extends SoImageVizEngine

SoHistogramEqualizationProcessing engine The SoHistogramEqualizationProcessing engine performs a histogram equalization.

This engine performs a histogram equalization of image I onto image O. For example, if an image contains n pixels and uses M gray values, there is an average of n/M pixels per gray level. An image is correctly contrasted if the number of pixels is closed to this mean value for each gray level value.

The aim of histogram equalization is to transform the histogram to make it uniform. In Figure a, the histogram is very condensed, and the image is poorly contrasted. In Figure b, the histogram is more widely distributed, and the image has a better contrast.

See also:

SoMatchContrastProcessing, SoBackgroundImageProcessing2d, SoMathematicalFunctionProcessing.

File format/default:

HistogramEqualizationProcessing {

computeMode	MODE_AUTO
inImage	NULL
rangeMode	MIN_MAX
intensityRangeInput	0 255
intensityRangeOutput	0 255

}

Library references: equalize

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SoHistogramEqualizationProcessing.RangeModes

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.
SoSFVec2i32	intensityRangeInput The input intensity range.
SoSFVec2i32	intensityRangeOutput The output intensity range.
static int	MIN_MAX Deprecated. Use SoHistogramEqualizationProcessing.RangeModes.MIN_MAX instead.
static int	OTHER Deprecated. Use SoHistogramEqualizationProcessing.RangeModes.OTHER instead.
SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter>	outImage The output image.
SoSFEnum<SoHistogramEqualizationProcessing.RangeModes>	rangeMode Select the input intensity range 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
SoHistogramEqualizationProcessing() 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

MIN_MAX

@Deprecated
public static final int MIN_MAX

Deprecated. Use SoHistogramEqualizationProcessing.RangeModes.MIN_MAX instead.

OTHER

@Deprecated
public static final int OTHER

Deprecated. Use SoHistogramEqualizationProcessing.RangeModes.OTHER instead.

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

rangeMode

public final SoSFEnum<SoHistogramEqualizationProcessing.RangeModes> rangeMode

Select the input intensity range mode. . Default is MIN_MAX

intensityRangeInput

public final SoSFVec2i32 intensityRangeInput

The input intensity range. Default value is SbVec2i32(0,255).

intensityRangeOutput

public final SoSFVec2i32 intensityRangeOutput

The output intensity range. Default value is SbVec2i32(0,255).

outImage

public final SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter> outImage

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

Constructor Detail

SoHistogramEqualizationProcessing

public SoHistogramEqualizationProcessing()

Constructor.