Operator Reference

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

gray_closinggray_closingGrayClosingGrayClosinggray_closing (Operator)

gray_closinggray_closingGrayClosingGrayClosinggray_closing — Perform a gray value closing on an image.

Signature

gray_closing(Image, SE : ImageClosing : : )

Herror gray_closing(const Hobject Image, const Hobject SE, Hobject* ImageClosing)

Herror T_gray_closing(const Hobject Image, const Hobject SE, Hobject* ImageClosing)

void GrayClosing(const HObject& Image, const HObject& SE, HObject* ImageClosing)

HImage HImage::GrayClosing(const HImage& SE) const

static void HOperatorSet.GrayClosing(HObject image, HObject SE, out HObject imageClosing)

HImage HImage.GrayClosing(HImage SE)

def gray_closing(image: HObject, se: HObject) -> HObject

Description

gray_closinggray_closingGrayClosingGrayClosinggray_closing applies a gray value closing to the input image ImageImageImageimageimage with the structuring element SESESESEse. The image type of the structuring element SESESESEse must match the image type of the input image ImageImageImageimageimage. The gray value closing of an image i with a structuring element s is defined as i.e., a dilation of the image with s followed by an erosion with the transposed structuring element (see gray_dilationgray_dilationGrayDilationGrayDilationgray_dilation and gray_erosiongray_erosionGrayErosionGrayErosiongray_erosion). For the generation of structuring elements, see read_gray_seread_gray_seReadGraySeReadGraySeread_gray_se.

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

Execution Information

  • 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 internal data level.

Parameters

ImageImageImageimageimage (input_object)  (multichannel-)image(-array) → objectHImageHObjectHObjectHobject (byte / uint2 / real)

Input image.

SESESESEse (input_object)  singlechannelimage → objectHImageHObjectHObjectHobject (byte / uint2 / real)

Structuring element.

ImageClosingImageClosingImageClosingimageClosingimage_closing (output_object)  (multichannel-)image(-array) → objectHImageHObjectHObjectHobject * (byte / uint2 / real)

Gray-closed image.

Result

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

Possible Predecessors

read_gray_seread_gray_seReadGraySeReadGraySeread_gray_se, gen_disc_segen_disc_seGenDiscSeGenDiscSegen_disc_se, read_imageread_imageReadImageReadImageread_image

Alternatives

dual_rankdual_rankDualRankDualRankdual_rank, gray_closing_rectgray_closing_rectGrayClosingRectGrayClosingRectgray_closing_rect, gray_closing_shapegray_closing_shapeGrayClosingShapeGrayClosingShapegray_closing_shape

See also

closingclosingClosingClosingclosing, gray_dilationgray_dilationGrayDilationGrayDilationgray_dilation, gray_erosiongray_erosionGrayErosionGrayErosiongray_erosion

Module

Foundation

ClassesClasses | | Operators