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_rectGrayOpeningRectGrayOpeningRectgray_opening_rect applies a gray value opening to the input image ImageImageImageimageimage with a rectangular mask of size (MaskHeightMaskHeightMaskHeightmaskHeightmask_height, MaskWidthMaskWidthMaskWidthmaskWidthmask_width). The resulting image is returned in ImageOpeningImageOpeningImageOpeningimageOpeningimage_opening. If the parameters MaskHeightMaskHeightMaskHeightmaskHeightmask_height or MaskWidthMaskWidthMaskWidthmaskWidthmask_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_rectGrayErosionRectGrayErosionRectgray_erosion_rect and gray_dilation_rectgray_dilation_rectGrayDilationRectGrayDilationRectgray_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

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

Input image.

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

Gray-opened image.

MaskHeightMaskHeightMaskHeightmaskHeightmask_height (input_control) extent.y → (integer)

Height of the filter mask.

Default: 11

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

Value range: 3 ≤ MaskHeight MaskHeight MaskHeight maskHeight mask_height ≤ 511

Minimum increment: 2

Recommended increment: 2

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

MaskWidthMaskWidthMaskWidthmaskWidthmask_width (input_control) extent.x → (integer)

Width of the filter mask.

Default: 11

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

Value range: 3 ≤ 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_rectGrayOpeningRectGrayOpeningRectgray_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>)set_system("no_object_result",<Result>). If necessary, an exception is raised.

Alternatives

gray_openinggray_openingGrayOpeningGrayOpeninggray_opening, gray_opening_shapegray_opening_shapeGrayOpeningShapeGrayOpeningShapegray_opening_shape

Module

Foundation

Operators