Start » Filter Reference » Image » Image Local Transforms » TopHatImage

TopHatImage

Basic

Module: FoundationLite

Performs a morphological white top hat operation on a image using a predefined kernel.

Name Type Range Description
Input value
 inImage Image Input image
Input value
 inRoi Region* Range of outImage pixels to be computed
Input value
 inSourceRoi Region* Range of inImage pixels to be considered in computations
Input value
 inBorderColor Pixel* Color of the imaginary pixels outside the image boundaries
Input value
 inKernel KernelShape Kernel shape
Input value
 inRadiusX Integer 0 - Nearly half of the kernel's width (2*R+1)
Input value
 inRadiusY Integer* 0 - Nearly half of the kernel's height (2*R+1), or same as inRadiusX
Output value
 outImage Image Output image
Diagnostic input
 diagKernel Region Kernel shape

Description

Extracts from image small objects that are brighter than surroundings.

Is performed by running consecutively two filters. OpenImage to get the image without small objects and SubtractFromImage to remove everything but them.

Examples

Top Hat used to remove bigger objects. Used parameters inKernel=Ellipse and inRadiusX=6. Source image on the left and result on the right.

Hardware Acceleration

This operation is optimized for SSE2 technology for pixels of types: all formats (when inSourceRoi = NIL and inBorderColor = NIL).

This operation is optimized for NEON technology for pixels of types: all formats (when inSourceRoi = NIL and inBorderColor = NIL).

This operation supports automatic parallelization for multicore and multiprocessor systems.

Errors

This filter can throw an exception to report error. Read how to deal with errors in Error Handling.

List of possible exceptions:

Error type Description
DomainError Region exceeds an input image in TopHatImage.

Complexity Level

This filter is available on Basic Complexity Level.

Filter Group

This filter is member of TopHatImage filter group.