com.openinventor.imageviz.engines.imagefiltering.texturefilters

Class SoImageCurvatureProcessing3d

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.texturefilters.SoImageCurvatureProcessing3d

All Implemented Interfaces:

SafeDisposable

public class SoImageCurvatureProcessing3d
extends SoImageVizEngine

SoImageCurvatureProcessing3d engine The SoImageCurvatureProcessing3d engine computes local gray level 3D curvatures in image.

This engine computes for each voxel of an input image local texture curvature. Computed curvature(s) takes voxel size into account.

This engine computes local gray level 3D curvatures in image. Each voxel is then associated to two principal curvatures : and . The stands for maximal local curvature whereas stands for minimal curvature.

Two important indicators can be extracted from these values :

• Gaussian curvature :
• Mean curvature :

Gaussian curvature can be used to characterize local surface comportment :

• If gaussian curvature is positive, both principal curvatures have same sign and local surface will be dome like (which mean that it is locally lying on one side of its tangent plane. In this case, a positive curvature stand for convex surface whereas a negative value stand for a concave surface.
• If gaussian curvature is negative, principal curvatures have opposite signs and local surface will be saddle shaped (see figure above).
• If gaussian curvature is null, surface will be locally parabolic like. If , surface profil will locally be valley like.

See also:

SoFlowInpaintingProcessing.

File format/default:

ImageCurvatureProcessing3d {

inImage	NULL
inMaskImage	NULL
standardDeviation	4.0f

}

Library references: curvature3d

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
SoSFImageDataAdapter	inImage The input image.
SoSFImageDataAdapter	inMaskImage The binary image for the mask or empty (command looks for only inside).
SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter>	outRealImageMax The maximal curvature output image (floating values).
SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter>	outRealImageMin The minimal curvature output image (floating values).
SoSFFloat	standardDeviation The standard deviation for Gaussian filter.

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

inImage

public final SoSFImageDataAdapter inImage

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

inMaskImage

public final SoSFImageDataAdapter inMaskImage

The binary image for the mask or empty (command looks for only inside). This parameter is optional. Default value is NULL. Supported types include: binary image.

standardDeviation

public final SoSFFloat standardDeviation

The standard deviation for Gaussian filter. Default value is 4.0f.

outRealImageMax

public final SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter> outRealImageMax

The maximal curvature output image (floating values). Default value is NULL. Supported types include: grayscale color image.

outRealImageMin

public final SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter> outRealImageMin

The minimal curvature output image (floating values). Default value is NULL. Supported types include: grayscale color image.

Constructor Detail

SoImageCurvatureProcessing3d

public SoImageCurvatureProcessing3d()

Constructor.