Package com.openinventor.imageviz.engines
ImageViz engines allow the application of computational algorithms on data extracted from images.
Some engines work on images and provide output images, others provide numerical results, and others may work on vector data that represents segments of object edges. Some engines work only with 2D images, or only with 3D images and some work with both.
Engines names may end with 2d or 3d:
- 2d indicates that an engine only supports 2D images,
- 3d indicates that an engine only supports 3D images,
- If this information is omitted, the engine works on both types of images.
A keyword in the engine name, just before the dimensional information, indicates the kind of action the engine performs.
- Generation indicates an engine that creates an image from a vector of integers representing the output image size (e.g.,
SoRandomImageGeneration
) - Processing indicates an engine that transforms an image or a set of images to another image or set of images (e.g.,
SoMedianFilterProcessing
) - Quantification indicates an engine that provides numerical results (e.g.,
SoAreaQuantification2d
) - Approximation indicates an engine that works on segments given by a polygonal approximation (e.g.,
SoObjectToSegmentApproximation2d
). - For cross-functional engines, the most relevant key-word is used (e.g.,
SoObjectCountQuantification
provides a numerical result but also an output image that could be created bySoLabelingProcessing
).Field naming An engine field can be
- An input data object(generally an image)
- An output data object
- A computation parameter
By convention :
- A field name beginning with in represents an input data object,
- A field name beginning with out represents an output data object,
- A field name beginning neither with in, nor out represents a parameter.
A field name beginning with in or out represents data. A key-word specifies the type of data:
- A field name containing Image represents an image (
SoImageDataAdapter
object), - A field name containing Analysis represents a result of analysis, i.e., a list of measurements for a set of objects(SoLabelAnalysisResult object),
- A field name containing Segment represents a chain of segments, i.e., a list of vertices obtained from a polygonal approximation of objects edges(
SoSegmentChain
object), - A field name named outResult represents a result object specific to the engine. It generally represents the measurement results of a global analysis of an image (e.g.,
SoAreaQuantification2d.SbArea2DDetail
).Data conversion See section Data conversion conventions
-
Class Summary Class Description SoImageVizEngine Abstract base class for all ImageViz engines.SoImageVizEngine.EventArg Structure given to callback when an event is raised.SoImageVizEngineAnalysisOutput<T> Image Processing output class to convert an SoImageAnalysisResult to result details.SoImageVizEngineOutput<T extends SoSFFieldContainer,S extends SoFieldContainer> This class is similar to SoEngineOutput except that it keep a reference to output's value even if no one is connected. -
Enum Summary Enum Description SoImageVizEngine.ComputeModes Compute Mode This enum specifies whether the main input will be interpreted as a 3D volume or a stack of 2D images for processing.SoImageVizEngine.Neighborhood3ds Neighborhood Connectivity 3D.