gray_openinggray_openingGrayOpeningGrayOpening (Operator)

Name

gray_openinggray_openingGrayOpeningGrayOpening — Perform a gray value opening on an image.

Signature

gray_opening(Image, SE : ImageOpening : : )

Herror gray_opening(const Hobject Image, const Hobject SE, Hobject* ImageOpening)

Herror T_gray_opening(const Hobject Image, const Hobject SE, Hobject* ImageOpening)

void GrayOpening(const HObject& Image, const HObject& SE, HObject* ImageOpening)

HImage HImage::GrayOpening(const HImage& SE) const

static void HOperatorSet.GrayOpening(HObject image, HObject SE, out HObject imageOpening)

HImage HImage.GrayOpening(HImage SE)

Description

gray_openinggray_openingGrayOpeningGrayOpeningGrayOpening applies a gray value opening 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 opening of an image i with a structuring element s is defined as i.e., an erosion of the image with s followed by a dilation with the transposed structuring element (see gray_erosiongray_erosionGrayErosionGrayErosionGrayErosion and gray_dilationgray_dilationGrayDilationGrayDilationGrayDilation). For the generation of structuring elements, see read_gray_seread_gray_seReadGraySeReadGraySeReadGraySe.

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

Execution Information

Parameters

ImageImageImageImageimage (input_object)  (multichannel-)image(-array) objectHImageHImageHobject (byte / uint2 / real)

Input image.

SESESESESE (input_object)  singlechannelimage objectHImageHImageHobject (byte / uint2 / real)

Structuring element.

ImageOpeningImageOpeningImageOpeningImageOpeningimageOpening (output_object)  (multichannel-)image(-array) objectHImageHImageHobject * (byte / uint2 / real)

Gray-opened image.

Result

gray_openinggray_openingGrayOpeningGrayOpeningGrayOpening 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_seReadGraySeReadGraySeReadGraySe, gen_disc_segen_disc_seGenDiscSeGenDiscSeGenDiscSe, read_imageread_imageReadImageReadImageReadImage

Alternatives

dual_rankdual_rankDualRankDualRankDualRank, gray_opening_rectgray_opening_rectGrayOpeningRectGrayOpeningRectGrayOpeningRect, gray_opening_shapegray_opening_shapeGrayOpeningShapeGrayOpeningShapeGrayOpeningShape

See also

openingopeningOpeningOpeningOpening, gray_dilationgray_dilationGrayDilationGrayDilationGrayDilation, gray_erosiongray_erosionGrayErosionGrayErosionGrayErosion

Module

Foundation