gray_opening_rectgray_opening_rectGrayOpeningRectGrayOpeningRectgray_opening_rect (Operator)

Name

gray_opening_rectgray_opening_rectGrayOpeningRectGrayOpeningRectgray_opening_rect — Perform a gray value opening with a rectangular mask.

Signature

gray_opening_rect(Image : ImageOpening : MaskHeight, MaskWidth : )

Description

gray_opening_rectgray_opening_rectGrayOpeningRectGrayOpeningRectGrayOpeningRectgray_opening_rect applies a gray value opening to the input image ImageImageImageImageimageimage with a rectangular mask of size (MaskHeightMaskHeightMaskHeightMaskHeightmaskHeightmask_height, MaskWidthMaskWidthMaskWidthMaskWidthmaskWidthmask_width). The resulting image is returned in ImageOpeningImageOpeningImageOpeningImageOpeningimageOpeningimage_opening. If the parameters MaskHeightMaskHeightMaskHeightMaskHeightmaskHeightmask_height or MaskWidthMaskWidthMaskWidthMaskWidthmaskWidthmask_width are even, they are changed to the next larger odd value. At the border of the image the gray values are mirrored.

The gray value opening of an image i with a rectangular structuring element s is defined as i.e., an erosion of the image with s followed by a dilation with s (see gray_erosion_rectgray_erosion_rectGrayErosionRectGrayErosionRectGrayErosionRectgray_erosion_rect and gray_dilation_rectgray_dilation_rectGrayDilationRectGrayDilationRectGrayDilationRectgray_dilation_rect).

Attention

Note that filter operators may return unexpected results if an image with a reduced domain is used as input. Please refer to the chapter Filters.

Execution Information

Supports OpenCL compute devices.
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 domain level.

Parameters

ImageImageImageImageimageimage (input_object) (multichannel-)image(-array) → object (byte / direction / cyclic / uint2 / int2 / int4 / real)

Input image.

ImageOpeningImageOpeningImageOpeningImageOpeningimageOpeningimage_opening (output_object) (multichannel-)image(-array) → object (byte / direction / cyclic / uint2 / int2 / int4 / real)

Gray-opened image.

MaskHeightMaskHeightMaskHeightMaskHeightmaskHeightmask_height (input_control) extent.y → (integer)

Height of the filter mask.

Default value: 11

Suggested values: 3, 5, 7, 9, 11, 13, 15

Typical range of values: 3 ≤ MaskHeight MaskHeight MaskHeight MaskHeight maskHeight mask_height ≤ 511

Minimum increment: 2

Recommended increment: 2

Restriction: odd(MaskHeight) && MaskHeight < height(Image) * 2

MaskWidthMaskWidthMaskWidthMaskWidthmaskWidthmask_width (input_control) extent.x → (integer)

Width of the filter mask.

Default value: 11

Suggested values: 3, 5, 7, 9, 11, 13, 15

Typical range of values: 3 ≤ MaskWidth MaskWidth MaskWidth MaskWidth maskWidth mask_width ≤ 511

Minimum increment: 2

Recommended increment: 2

Restriction: odd(MaskWidth) && MaskWidth < width(Image) * 2

Result

gray_opening_rectgray_opening_rectGrayOpeningRectGrayOpeningRectGrayOpeningRectgray_opening_rect returns 2 (H_MSG_TRUE) if all parameters are correct. If the input is empty the behavior can be set via set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>). If necessary, an exception is raised.

Alternatives

gray_openinggray_openingGrayOpeningGrayOpeningGrayOpeninggray_opening, gray_opening_shapegray_opening_shapeGrayOpeningShapeGrayOpeningShapeGrayOpeningShapegray_opening_shape

Module

Foundation

Operators