Class SoObjectToRegionProcessing2d

  • All Implemented Interfaces:

    public class SoObjectToRegionProcessing2d
    extends SoImageVizEngine
    As of Open Inventor 2023.2. ImageViz API is replaced by the new ImageDev toolkit.
    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.



    See Also:
    SoRegionToObjectProcessing2d, SoLabelingProcessing File format/default: ObjectToRegionProcessing2d { inObjectImage NULL } Library references: region
    • Field Detail

      • inObjectImage

        public final SoSFImageDataAdapter inObjectImage
        The input object label image. Default value is NULL. Supported types include: label color image.
    • Constructor Detail

      • SoObjectToRegionProcessing2d

        public SoObjectToRegionProcessing2d()