gray_closinggray_closingGrayClosingGrayClosinggray_closing (Operator)

Name

gray_closinggray_closingGrayClosingGrayClosinggray_closing — Perform a gray value closing on an image.

Signature

gray_closing(Image, SE : ImageClosing : : )

Description

gray_closinggray_closingGrayClosingGrayClosingGrayClosinggray_closing applies a gray value closing 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 closing of an image i with a structuring element s is defined as i.e., a dilation of the image with s followed by an erosion with the transposed structuring element (see gray_dilationgray_dilationGrayDilationGrayDilationGrayDilationgray_dilation and gray_erosiongray_erosionGrayErosionGrayErosionGrayErosiongray_erosion). For the generation of structuring elements, see read_gray_seread_gray_seReadGraySeReadGraySeReadGraySeread_gray_se.

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

Execution Information

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.

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

Gray-closed image.

Result

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