SoObjectToRegionProcessing2d Class Reference
[Labeling]
SoObjectToRegionProcessing2d engine
More...
#include <ImageViz/Engines/ImageSegmentation/Labeling/SoObjectToRegionProcessing2d.h>
Public Member Functions | |
| SoObjectToRegionProcessing2d () | |
Public Attributes | |
| SoSFImageDataAdapter | inObjectImage |
| SoImageVizEngineOutput < SoSFImageDataAdapter, SoImageDataAdapter * > | outRegionImage |
Detailed Description
SoObjectToRegionProcessing2d engine
The SoObjectToRegionProcessing2d engine transforms an object image into a region image.
A region image is a label image where each pixel has a value greater than zero.
The SoObjectToRegionProcessing2d engine scans the image from top to bottom and left to right. This engine extracts all connected entities (Regions). Two pixels are in the same regions if they have the same gray level value and if there is path between them with only this gray level value. Each pixel of the same region takes the same value, and each object is assigned 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 regions in the original image. The algorithm works in three steps:
- The first scan detects the starting location 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.
BEFORE:
![\[ \begin{tabular}{|c|c|c|c|c|c|c|c|c|c|} \hline 1 & 1 & 1 & 1 & 1 & 2 \\ \hline 1 & 1 & 2 & 1 & 1 & 2 \\ \hline 1 & 2& 2 & 1 & 1 & 2 \\ \hline 1 & 2 & 2 & 2 & 1 & 2 \\ \hline 2 & 1 & 1 & 2 & 1 & 2 \\ \hline \end{tabular} \]](form_555.png)
AFTER:
![\[ \begin{tabular}{|c|c|c|c|c|c|c|c|c|c|} \hline 1 & 1 & 1 & 1 & 1 & 3 \\ \hline 1 & 1 & 2 & 1 & 1 & 3 \\ \hline 1 & 2 & 2 & 1 & 1 & 3 \\ \hline 1 & 2 & 2 & 2 & 1 & 3 \\ \hline 2 & 1 & 1 & 2 & 1 & 3 \\ \hline \end{tabular} \]](form_556.png)
SEE ALSO
SoRegionToObjectProcessing2d, SoLabelingProcessing.
FILE FORMAT/DEFAULT
- ObjectToRegionProcessing2d {
| inObjectImage | NULL |
Library references: region
Constructor & Destructor Documentation
| SoObjectToRegionProcessing2d::SoObjectToRegionProcessing2d | ( | ) |
Constructor.
Member Data Documentation
The input object label image.
Default value is NULL. Supported types include: label color image.
| SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter*> SoObjectToRegionProcessing2d::outRegionImage |
The output region label image.
Default value is NULL. Supported types include: grayscale binary label color image.
The documentation for this class was generated from the following file:
- ImageViz/Engines/ImageSegmentation/Labeling/SoObjectToRegionProcessing2d.h