Image Encoder

The segmentation methods (see Image Segmenters) determine which layer(s) to encode by default, and do not encode pixels from the other layers.

Function GetMaxLayerIndex returns the highest Layer Index value. It is available for all segmenters.

Enabling/disabling layer encoding for each layer individually

The following tables list, for each layer, the Set/Get function and the default enable/disable value.

Two-layer segmenters

The following tables list, for each layer, the Set/Get function and the default value.

Two-layer segmenters

For the sake of computational efficiency, the objects are described as lists of runs. A run is a sequence of adjacent pixels that share homogeneous properties (such as being above a given threshold). These runs are merged in objects by the image encoder.

EasyObject can work at object level, and at run level which allows faster processing in critical cases. This is useful to compute custom features on objects then list all runs belonging to a given object as shown in this example of working at run level, with colored runs in the output image.

1. Declare a new ECodedImage2 object.
2. Declare an EImageEncoder and, if applicable, select the appropriate segmenter. Setup the segmenter and choose appropriate layer(s) to encode.
3. Set up an output image.
4. Encode the image.
5. Color the runs in the output image. Iterate over the objects of a specific layer by constructing a loop and then a RunsIterator object. This iterator allows to browse runs of the considered object. Once the iterator has finished a run of the considered object, the inner loop processes the pixels spanned by this run in the output image.
6. Select a specific layer.

Pixels can touch each other along an edge or by a corner. In Four Connexity only pixels touching by an edge are considered neighbors. In Eight Connexity (the default) pixels touching by a corner are also considered neighbors.