com.openinventor.imageviz.engines.imagesegmentation.labeling

Class SoLabelingProcessing

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.labeling.SoLabelingProcessing

All Implemented Interfaces:

SafeDisposable

public class SoLabelingProcessing
extends SoImageVizEngine

SoLabelingProcessing engine The SoLabelingProcessing engine labels objects of a binary image.

In this engine, the image is scanned from top to bottom and left to right. Each pixel of the same object takes the same value, and each object is assigned to a different value, starting from value 1. The assigned gray level depends on the location of the object in the image. The maximum gray level value gives the total number of objects in the original binary image. The algorithm works in three steps:

• The first scan detects the start of each object.
• The second scan gives the same gray level to all the pixels belonging to the same object.
• The third optional scan checks that there is no hole in the numbers, i.e. that all objects have consecutive indices.

A label image may be 16 or 32 bits per pixel. By default it is 2 bytes per pixel, but if the number of labels exceeds 65,535 then the output image is automatically converted to 4 bytes and then can manage more than 2 billion labels.

File format/default:

LabelingProcessing {

computeMode	MODE_AUTO
neighborhood3d	CONNECTIVITY_26
inObjectImage	NULL

}

Library references: label

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
SoSFEnum<SoImageVizEngine.ComputeModes>	computeMode Select the compute Mode (2D or 3D or AUTO) .
SoSFImageDataAdapter	inObjectImage The input binary or label image.
SoSFEnum<SoImageVizEngine.Neighborhood3ds>	neighborhood3d In 3D configuration (see computeMode), the neighborhood connectivity defines the connectivity considered for processing adjacent voxels.
SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter>	outLabelImage The output label image.

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

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.

inObjectImage

public final SoSFImageDataAdapter inObjectImage

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

outLabelImage

public final SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter> outLabelImage

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

Constructor Detail

SoLabelingProcessing

public SoLabelingProcessing()

Constructor.