Herror ::gray_tophat (
    Hobject Image,
    Hobject SE,
    Hobject *ImageTopHat
)
HImage HImage::GrayTophat (
    const HImage &SE
) const
HImageArray HImageArray::GrayTophat (
    const HImage &SE
) const

Perform a gray value top hat transformation on an image.

::gray_tophat applies a gray value top hat transformation to the input image Image with the structuring element SE. 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_opening). For the generation of structuring elements, see ::read_gray_se.


Parameters

Image (input_object)
image(-array) -> Hobject: HImage(Array) ( byte )
Input image.

SE (input_object)
image -> Hobject: HImage ( byte )
Structuring element.

ImageTopHat (output_object)
image(-array) -> Hobject * : HImage(Array) ( byte )
Top hat image.


Result

::gray_tophat returns H_MSG_TRUE if the structuring element is not the empty region. Otherwise, an exception is raised.


Possible Predecessors

::read_gray_se, ::gen_disc_se


Possible Successors

::threshold


Alternatives

::gray_opening


See also

::gray_bothat, ::top_hat, ::gray_erosion_rect, ::sub_image


Module

Image filters



Copyright © 1996-2002 MVTec Software GmbH