Operator Reference

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

gray_erosiongray_erosionGrayErosionGrayErosiongray_erosion (Operator)

gray_erosiongray_erosionGrayErosionGrayErosiongray_erosion — Perform a gray value erosion on an image.

Signature

gray_erosion(Image, SE : ImageErosion : : )

Herror gray_erosion(const Hobject Image, const Hobject SE, Hobject* ImageErosion)

Herror T_gray_erosion(const Hobject Image, const Hobject SE, Hobject* ImageErosion)

void GrayErosion(const HObject& Image, const HObject& SE, HObject* ImageErosion)

HImage HImage::GrayErosion(const HImage& SE) const

static void HOperatorSet.GrayErosion(HObject image, HObject SE, out HObject imageErosion)

HImage HImage.GrayErosion(HImage SE)

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

Description

gray_erosiongray_erosionGrayErosionGrayErosiongray_erosion applies a gray value erosion 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 erosion of an image i with a structuring element s at the pixel position x is defined as: Here, S is the domain of the structuring element s (see read_gray_seread_gray_seReadGraySeReadGraySeread_gray_se).

The gray value erosion 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.

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

Gray-eroded image.

Result

gray_erosiongray_erosionGrayErosionGrayErosiongray_erosion 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

Possible Successors

gray_dilationgray_dilationGrayDilationGrayDilationgray_dilation, sub_imagesub_imageSubImageSubImagesub_image

Alternatives

gray_erosion_rectgray_erosion_rectGrayErosionRectGrayErosionRectgray_erosion_rect, gray_erosion_shapegray_erosion_shapeGrayErosionShapeGrayErosionShapegray_erosion_shape

See also

gray_openinggray_openingGrayOpeningGrayOpeninggray_opening, gray_closinggray_closingGrayClosingGrayClosinggray_closing, erosion1erosion1Erosion1Erosion1erosion1, gray_skeletongray_skeletonGraySkeletonGraySkeletongray_skeleton

Module

Foundation

ClassesClasses | | Operators