Operator Reference

HALCON Operator Reference / Morphology / Gray Values
ClassesClasses | | Operators

gray_opening_rectgray_opening_rectGrayOpeningRectGrayOpeningRectgray_opening_rect (Operator)

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

Signature

gray_opening_rect(Image : ImageOpening : MaskHeight, MaskWidth : )

Herror gray_opening_rect(const Hobject Image, Hobject* ImageOpening, const Hlong MaskHeight, const Hlong MaskWidth)

Herror T_gray_opening_rect(const Hobject Image, Hobject* ImageOpening, const Htuple MaskHeight, const Htuple MaskWidth)

void GrayOpeningRect(const HObject& Image, HObject* ImageOpening, const HTuple& MaskHeight, const HTuple& MaskWidth)

HImage HImage::GrayOpeningRect(Hlong MaskHeight, Hlong MaskWidth) const

static void HOperatorSet.GrayOpeningRect(HObject image, out HObject imageOpening, HTuple maskHeight, HTuple maskWidth)

HImage HImage.GrayOpeningRect(int maskHeight, int maskWidth)

def gray_opening_rect(image: HObject, mask_height: int, mask_width: int) -> HObject

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) → objectHImageHObjectHObjectHobject (byte / direction / cyclic / uint2 / int2 / int4 / real)

Input image.

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

Gray-opened image.

MaskHeightMaskHeightMaskHeightmaskHeightmask_height (input_control)  extent.y → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

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 → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

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

See also

opening_rectangle1opening_rectangle1OpeningRectangle1OpeningRectangle1opening_rectangle1, gray_dilation_rectgray_dilation_rectGrayDilationRectGrayDilationRectgray_dilation_rect, gray_erosion_rectgray_erosion_rectGrayErosionRectGrayErosionRectgray_erosion_rect

Module

Foundation

ClassesClasses | | Operators