gray_dilation_rectgray_dilation_rectgray_dilation_rectGrayDilationRectGrayDilationRect (Operator)

Name

gray_dilation_rectgray_dilation_rectgray_dilation_rectGrayDilationRectGrayDilationRect — Determine the maximum gray value within a rectangle.

Signature

gray_dilation_rect(Image : ImageMax : MaskHeight, MaskWidth : )

Description

gray_dilation_rectgray_dilation_rectgray_dilation_rectGrayDilationRectGrayDilationRect calculates the maximum gray value of the input image ImageImageImageImageimage within a rectangular mask of size (MaskHeightMaskHeightMaskHeightMaskHeightmaskHeight, MaskWidthMaskWidthMaskWidthMaskWidthmaskWidth) for each image point. The resulting image is returned in ImageMaxImageMaxImageMaxImageMaximageMax. If the parameters MaskHeightMaskHeightMaskHeightMaskHeightmaskHeight or MaskWidthMaskWidthMaskWidthMaskWidthmaskWidth are even, they are changed to the next larger odd value. At the border of the image the gray values are mirrored.

Parallelization

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)

Image for which the maximum gray values are to be calculated.

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

Image containing the maximum gray values.

MaskHeightMaskHeightMaskHeightMaskHeightmaskHeight (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 ≤ 511

Minimum increment: 2

Recommended increment: 2

Restriction: odd(MaskHeight)

MaskWidthMaskWidthMaskWidthMaskWidthmaskWidth (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 ≤ 511

Minimum increment: 2

Recommended increment: 2

Restriction: odd(MaskWidth)

Result

gray_dilation_rectgray_dilation_rectgray_dilation_rectGrayDilationRectGrayDilationRect 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>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>). If necessary, an exception is raised.

Module

Foundation

Table of Contents / Morphology / Gray Values

Operators

HALCON Reference Manual 10.0.2