gray_dilationGrayDilationGrayDilationgray_dilationgray_dilation

HALCON ScriptCpp++.NETPythonC

Short description

gray_dilationGrayDilationGrayDilationgray_dilationgray_dilation — Perform a gray value dilation on an image.

Signature

gray_dilation( image Image, image SE, out image ImageDilation )void GrayDilation( const HObject& Image, const HObject& SE, HObject* ImageDilation )static void HOperatorSet.GrayDilation( HObject image, HObject SE, out HObject imageDilation )def gray_dilation( image: HObject, se: HObject ) -> HObject

Herror gray_dilation( const Hobject Image, const Hobject SE, Hobject* ImageDilation )

Herror T_gray_dilation( const Hobject Image, const Hobject SE, Hobject* ImageDilation )

HImage HImage::GrayDilation( const HImage& SE ) const

HImage HImage.GrayDilation( HImage SE )

Description

gray_dilationGrayDilation applies a gray value dilation to the input image Imageimageimage with the structuring element SESEse. The image type of the structuring element SESEse must match the image type of the input image Imageimageimage. The gray value dilation of an image \(i\) with a structuring element \(s\) at the pixel position \(x\) is defined as:

\[\begin{eqnarray*} (i \oplus s)(x) = \max\{f(x-z) + s(z) | z \in S\} \end{eqnarray*}\]

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

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

Execution information

Execution information

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).

• Multithreading scope: global (may be called from any thread).

• Automatically parallelized on internal data level.

Parameters

Imageimageimage (input_object) (multichannel-)image(-array) → object (byte / uint2 / real)HObject (byte / uint2 / real)HImage (byte / uint2 / real)HObject (byte / uint2 / real)Hobject (byte / uint2 / real)

Input image.

SESEse (input_object) singlechannelimage → object (byte / uint2 / real)HObject (byte / uint2 / real)HImage (byte / uint2 / real)HObject (byte / uint2 / real)Hobject (byte / uint2 / real)

Structuring element.

ImageDilationimageDilationimage_dilation (output_object) (multichannel-)image(-array) → object (byte / uint2 / real)HObject (byte / uint2 / real)HImage (byte / uint2 / real)HObject (byte / uint2 / real)Hobject * (byte / uint2 / real)

Gray-dilated image.

Result

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

Combinations with other operators

Combinations

Possible predecessors

read_gray_seReadGraySe, gen_disc_seGenDiscSe, read_imageReadImage

Possible successors

sub_imageSubImage, gray_erosionGrayErosion

Alternatives

gray_dilation_rectGrayDilationRect, gray_dilation_shapeGrayDilationShape

See also

gray_openingGrayOpening, gray_closingGrayClosing, dilation1Dilation1, gray_skeletonGraySkeleton

Module

Foundation