HALCON Reference Manual 10.0.2
Table of Contents / Morphology / Gray Values ClassesClassesClasses | | | Operators

gray_dilation_shapegray_dilation_shapegray_dilation_shapeGrayDilationShapeGrayDilationShape (Operator)

Name

gray_dilation_shapegray_dilation_shapegray_dilation_shapeGrayDilationShapeGrayDilationShape — Determine the maximum gray value within a selected mask.

Signature

gray_dilation_shape(Image : ImageMax : MaskHeight, MaskWidth, MaskShape : )

Herror gray_dilation_shape(const Hobject Image, Hobject* ImageMax, double MaskHeight, double MaskWidth, const char* MaskShape)

Herror T_gray_dilation_shape(const Hobject Image, Hobject* ImageMax, const Htuple MaskHeight, const Htuple MaskWidth, const Htuple MaskShape)

Herror gray_dilation_shape(Hobject Image, Hobject* ImageMax, const HTuple& MaskHeight, const HTuple& MaskWidth, const HTuple& MaskShape)

HImage HImage::GrayDilationShape(const HTuple& MaskHeight, const HTuple& MaskWidth, const HTuple& MaskShape) const

HImageArray HImageArray::GrayDilationShape(const HTuple& MaskHeight, const HTuple& MaskWidth, const HTuple& MaskShape) const

void HOperatorSetX.GrayDilationShape(
[in] IHUntypedObjectX* Image, [out] IHUntypedObjectX** ImageMax, [in] VARIANT MaskHeight, [in] VARIANT MaskWidth, [in] VARIANT MaskShape)

IHImageX* HImageX.GrayDilationShape(
[in] VARIANT MaskHeight, [in] VARIANT MaskWidth, [in] BSTR MaskShape)

static void HOperatorSet.GrayDilationShape(HObject image, out HObject imageMax, HTuple maskHeight, HTuple maskWidth, HTuple maskShape)

HImage HImage.GrayDilationShape(HTuple maskHeight, HTuple maskWidth, string maskShape)

HImage HImage.GrayDilationShape(double maskHeight, double maskWidth, string maskShape)

Description

gray_dilation_shapegray_dilation_shapegray_dilation_shapeGrayDilationShapeGrayDilationShape calculates the maximum gray value of the input image ImageImageImageImageimage within a mask of shape MaskShapeMaskShapeMaskShapeMaskShapemaskShape, vertical size MaskHeightMaskHeightMaskHeightMaskHeightmaskHeight and horizontal size MaskWidthMaskWidthMaskWidthMaskWidthmaskWidth for each image point. The resulting image is returned in ImageMaxImageMaxImageMaxImageMaximageMax.

If the parameters MaskHeightMaskHeightMaskHeightMaskHeightmaskHeight or MaskWidthMaskWidthMaskWidthMaskWidthmaskWidth are of the type integer and are even, they are changed to the next larger odd value. In contrast, if at least one of the two parameters is of the type float, the input image ImageImageImageImageimage is transformed with both the next larger and the next smaller odd mask size, and the output image ImageMaxImageMaxImageMaxImageMaximageMax is interpolated from the two intermediate images. Therefore, note that gray_dilation_shapegray_dilation_shapegray_dilation_shapeGrayDilationShapeGrayDilationShape returns different results for mask sizes of, e.g., 4 and 4.0!

In case of the values 'rhombus' and 'octagon' for the MaskShapeMaskShapeMaskShapeMaskShapemaskShape control parameter, MaskHeightMaskHeightMaskHeightMaskHeightmaskHeight and MaskWidthMaskWidthMaskWidthMaskWidthmaskWidth must be equal. The parameter value 'octagon' for MaskShapeMaskShapeMaskShapeMaskShapemaskShape denotes an equilateral octagonal mask which is a suitable approximation for a circular structure. At the border of the image the gray values are mirrored.

Attention

Note that gray_dilation_shapegray_dilation_shapegray_dilation_shapeGrayDilationShapeGrayDilationShape requires considerably more time for mask sizes of type float than for mask sizes of type integer. This is especially true for rectangular masks with differnt width and height!

gray_dilation_shapegray_dilation_shapegray_dilation_shapeGrayDilationShapeGrayDilationShape can be executed on OpenCL devices. In case of mask sizes of type float the result can vary slightly from the CPU as the interpolation is calculated in single precision on the OpenCL device.

Parallelization

Parameters

ImageImageImageImageimage (input_object)  (multichannel-)image(-array) → objectHImageHImageHImageXHobject (byte* / uint2*) *allowed for compute devices

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

ImageMaxImageMaxImageMaxImageMaximageMax (output_object)  (multichannel-)image(-array) → objectHImageHImageHImageXHobject * (byte / uint2)

Image containing the maximum gray values.

MaskHeightMaskHeightMaskHeightMaskHeightmaskHeight (input_control)  extent.y → HTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong)

Height of the filter mask.

Default value: 11

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

Typical range of values: 1.0 ≤ MaskHeight MaskHeight MaskHeight MaskHeight maskHeight

MaskWidthMaskWidthMaskWidthMaskWidthmaskWidth (input_control)  extent.x → HTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong)

Width of the filter mask.

Default value: 11

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

Typical range of values: 1.0 ≤ MaskWidth MaskWidth MaskWidth MaskWidth maskWidth

MaskShapeMaskShapeMaskShapeMaskShapemaskShape (input_control)  string → HTupleHTupleVARIANTHtuple (string) (string) (char*) (BSTR) (char*)

Shape of the mask.

Default value: 'octagon' "octagon" "octagon" "octagon" "octagon"

List of values: 'rectangle'"rectangle""rectangle""rectangle""rectangle", 'rhombus'"rhombus""rhombus""rhombus""rhombus", 'octagon'"octagon""octagon""octagon""octagon"

Result

gray_dilation_shapegray_dilation_shapegray_dilation_shapeGrayDilationShapeGrayDilationShape returns 2 (H_MSG_TRUE) if all parameters are correct.

Alternatives

gray_dilationgray_dilationgray_dilationGrayDilationGrayDilation, gray_dilation_rectgray_dilation_rectgray_dilation_rectGrayDilationRectGrayDilationRect

See also

gray_opening_shapegray_opening_shapegray_opening_shapeGrayOpeningShapeGrayOpeningShape, gray_closing_shapegray_closing_shapegray_closing_shapeGrayClosingShapeGrayClosingShape, gray_skeletongray_skeletongray_skeletonGraySkeletonGraySkeleton

Module

Foundation

Table of Contents / Morphology / Gray Values ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH