com.openinventor.imageviz.engines.mathematicalmorphology.hitormissandskeleton

Class SoPruningProcessing3d

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.mathematicalmorphology.hitormissandskeleton.SoPruningProcessing3d

All Implemented Interfaces:

SafeDisposable

public class SoPruningProcessing3d
extends SoImageVizEngine

SoPruneProcessing3d engine The SoPruneProcessing3d engine prunes the result of a skeletonization. It removes all object voxels having only one neighbor. It can be applied either specifying a number of iterations or until convergence. This filter can be used for removing terminal branches from a skeleton.

The skeleton is very sensitive to small distortions on the edges of the objects, generating artifacts called prunes. The SoPruneProcessing3d engine eliminates these prunes by thinning with the E configuration until convergence. The structuring element is:

The problem is to determine the number of iterations for the pruning as thinning until convergence will remove all the skeletons except loops and branches intersecting the frame of the image.

See also: SoSkeletonProcessing, SoPruneProcessing2d, SoEndPointsProcessing3d.

File format/default:

PruningProcessing3d {

computeMode	MODE_AUTO
neighborhood3d	CONNECTIVITY_26
inBinaryImage	NULL
pruningMode	RIGOROUS
maxLength	1

}

Library references: pruning3d

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SoPruningProcessing3d.PruningModes

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	inBinaryImage The input image.
SoSFInt32	maxLength Enter the number of iterations (0:until convergence) Default value is 1.
SoSFEnum<SoImageVizEngine.Neighborhood3ds>	neighborhood3d In 3D configuration (see computeMode), the neighborhood connectivity defines the connectivity considered for processing adjacent voxels.
SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter>	outBinaryImage The output binary image.
static int	PERMISSIVE Deprecated. Use SoPruningProcessing3d.PruningModes.PERMISSIVE instead.
SoSFEnum<SoPruningProcessing3d.PruningModes>	pruningMode End point mode .
static int	RIGOROUS Deprecated. Use SoPruningProcessing3d.PruningModes.RIGOROUS instead.

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

RIGOROUS

@Deprecated
public static final int RIGOROUS

Deprecated. Use SoPruningProcessing3d.PruningModes.RIGOROUS instead.

PERMISSIVE

@Deprecated
public static final int PERMISSIVE

Deprecated. Use SoPruningProcessing3d.PruningModes.PERMISSIVE instead.

computeMode

public final SoSFEnum<SoImageVizEngine.ComputeModes> computeMode

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

neighborhood3d

public final SoSFEnum<SoImageVizEngine.Neighborhood3ds> neighborhood3d

In 3D configuration (see computeMode), the neighborhood connectivity defines the connectivity considered for processing adjacent voxels. . Default is CONNECTIVITY_26.

inBinaryImage

public final SoSFImageDataAdapter inBinaryImage

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

pruningMode

public final SoSFEnum<SoPruningProcessing3d.PruningModes> pruningMode

End point mode . Default is RIGOROUS

maxLength

public final SoSFInt32 maxLength

Enter the number of iterations (0:until convergence) Default value is 1.

outBinaryImage

public final SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter> outBinaryImage

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

Constructor Detail

SoPruningProcessing3d

public SoPruningProcessing3d()

Constructor.