gray_tophatgray_tophatGrayTophatGrayTophat (Operator)

Name

gray_tophatgray_tophatGrayTophatGrayTophat — Perform a gray value top hat transformation on an image.

Signature

gray_tophat(Image, SE : ImageTopHat : : )

Herror gray_tophat(const Hobject Image, const Hobject SE, Hobject* ImageTopHat)

Herror T_gray_tophat(const Hobject Image, const Hobject SE, Hobject* ImageTopHat)

void GrayTophat(const HObject& Image, const HObject& SE, HObject* ImageTopHat)

HImage HImage::GrayTophat(const HImage& SE) const

static void HOperatorSet.GrayTophat(HObject image, HObject SE, out HObject imageTopHat)

HImage HImage.GrayTophat(HImage SE)

Description

gray_tophatgray_tophatGrayTophatGrayTophatGrayTophat applies a gray value top hat transformation 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 top hat transformation of an image i with a structuring element s is defined as i.e., the difference of the image and its opening with s (see gray_openinggray_openingGrayOpeningGrayOpeningGrayOpening). For the generation of structuring elements, see read_gray_seread_gray_seReadGraySeReadGraySeReadGraySe.

The top hat transformation 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.

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

Top hat image.

Result

gray_tophatgray_tophatGrayTophatGrayTophatGrayTophat 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

Possible Successors

thresholdthresholdThresholdThresholdThreshold

Alternatives

gray_openinggray_openingGrayOpeningGrayOpeningGrayOpening

See also

gray_bothatgray_bothatGrayBothatGrayBothatGrayBothat, top_hattop_hatTopHatTopHatTopHat, gray_erosion_rectgray_erosion_rectGrayErosionRectGrayErosionRectGrayErosionRect, sub_imagesub_imageSubImageSubImageSubImage

Module

Foundation