HALCON Reference Manual 10.0.2

Name

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

Signature

gray_tophat(Image, SE : ImageTopHat : : )

gray_tophatgray_tophatgray_tophatGrayTophatGrayTophat 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

  tophat(i,s) = i - (i -+ s) ,

i.e., the difference of the image and its opening with s (see gray_openinggray_openinggray_openingGrayOpeningGrayOpening). For the generation of structuring elements, see read_gray_seread_gray_seread_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

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

Parameters

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

Input image.

SESESESESE (input_object) singlechannelimage → object (byte / uint2 / real)

Structuring element.

ImageTopHatImageTopHatImageTopHatImageTopHatimageTopHat (output_object) (multichannel-)image(-array) → object (byte / uint2 / real)

Top hat image.

Result

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