ClassesClassesClassesClasses | | | | Operators

gray_tophatgray_tophatGrayTophatgray_tophatGrayTophatGrayTophat (Operator)

Name

gray_tophatgray_tophatGrayTophatgray_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)

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

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

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

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

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

void HOperatorSetX.GrayTophat(
[in] IHUntypedObjectX* Image, [in] IHUntypedObjectX* SE, [out] IHUntypedObjectX*ImageTopHat)

IHImageX* HImageX.GrayTophat([in] IHImageX* SE)

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

HImage HImage.GrayTophat(HImage SE)

Description

gray_tophatgray_tophatGrayTophatgray_tophatGrayTophatGrayTophat applies a gray value top hat transformation to the input image ImageImageImageImageImageimage with the structuring element SESESESESESE. The image type of the structuring element SESESESESESE must match the image type of the input image ImageImageImageImageImageimage. 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_openingGrayOpeninggray_openingGrayOpeningGrayOpening). For the generation of structuring elements, see read_gray_seread_gray_seReadGraySeread_gray_seReadGraySeReadGraySe.

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

Parallelization

Parameters

ImageImageImageImageImageimage (input_object)  (multichannel-)image(-array) objectHImageHImageHImageHImageXHobject (byte / uint2 / real)

Input image.

SESESESESESE (input_object)  singlechannelimage objectHImageHImageHImageHImageXHobject (byte / uint2 / real)

Structuring element.

ImageTopHatImageTopHatImageTopHatImageTopHatImageTopHatimageTopHat (output_object)  (multichannel-)image(-array) objectHImageHImageHImageHImageXHobject * (byte / uint2 / real)

Top hat image.

Result

gray_tophatgray_tophatGrayTophatgray_tophatGrayTophatGrayTophat 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_seReadGraySeread_gray_seReadGraySeReadGraySe, gen_disc_segen_disc_seGenDiscSegen_disc_seGenDiscSeGenDiscSe, read_imageread_imageReadImageread_imageReadImageReadImage

Possible Successors

thresholdthresholdThresholdthresholdThresholdThreshold

Alternatives

gray_openinggray_openingGrayOpeninggray_openingGrayOpeningGrayOpening

See also

gray_bothatgray_bothatGrayBothatgray_bothatGrayBothatGrayBothat, top_hattop_hatTopHattop_hatTopHatTopHat, gray_erosion_rectgray_erosion_rectGrayErosionRectgray_erosion_rectGrayErosionRectGrayErosionRect, sub_imagesub_imageSubImagesub_imageSubImageSubImage

Module

Foundation


ClassesClassesClassesClasses | | | | Operators