gray_dilationgray_dilationGrayDilationgray_dilationGrayDilationGrayDilation (Operator)

Name

gray_dilationgray_dilationGrayDilationgray_dilationGrayDilationGrayDilation — Perform a gray value dilation on an image.

Signature

gray_dilation(Image, SE : ImageDilation : : )

gray_dilationgray_dilationGrayDilationgray_dilationGrayDilationGrayDilation applies a gray value dilation to the input image ImageImageImageImageImageimage with the structuring element SESESESESESE. The image type of the structuring element SESESESESESE must match the image type of the input image ImageImageImageImageImageimage. The gray value dilation of an image i with a structuring element s at the pixel position x is defined as:

Here, S is the domain of the structuring element s (see read_gray_seread_gray_seReadGraySeread_gray_seReadGraySeReadGraySe).

The gray value dilation is particularly fast for flat structuring elements, i.e., structuring elements with a constant gray level within their domain.

Parallelization

Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Automatically parallelized on tuple level.
Automatically parallelized on channel level.
Automatically parallelized on internal data level.

Parameters

ImageImageImageImageImageimage (input_object) (multichannel-)image(-array) → object (byte / uint2 / real)

Input image.

SESESESESESE (input_object) singlechannelimage → object (byte / uint2 / real)

Structuring element.

ImageDilationImageDilationImageDilationImageDilationImageDilationimageDilation (output_object) (multichannel-)image(-array) → object (byte / uint2 / real)

Gray-dilated image.

Result

gray_dilationgray_dilationGrayDilationgray_dilationGrayDilationGrayDilation returns 2 (H_MSG_TRUE) if the structuring element is not the empty region. Otherwise, an exception is raised.