You are here: Start » AVL.NET » Function Reference » Image » Image Local Transforms » AVL.TopHatImage_AnyKernel

AVL.TopHatImage_AnyKernel

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

Namespace:AvlNet
Assembly:AVL.NET.dll

Syntax

C++
C#
 
public static void TopHatImage_AnyKernel
(
	AvlNet.Image inImage,
	NullableRef<AvlNet.Region> inRoi,
	NullableRef<AvlNet.Region> inSourceRoi,
	AvlNet.Pixel? inBorderColor,
	AvlNet.Region inKernel,
	AvlNet.Location? inKernelAnchor,
	AvlNet.Image outImage
)

Parameters

Name Type Range Default Description
inImageAvlNet.ImageInput image.
inRoiAvlNet.NullableRef<AvlNet.Region>Range of outImage pixels to be computed. Default value: atl::NIL.
inSourceRoiAvlNet.NullableRef<AvlNet.Region>Range of inImage pixels to be considered in computations. Default value: atl::NIL.
inBorderColorAvlNet.Pixel?Color of the imaginary pixels outside the image boundaries. Default value: atl::NIL.
inKernelAvlNet.RegionKernel shape.
inKernelAnchorAvlNet.Location?A location within inKernel, defining its center. Default value: atl::NIL.
outImageAvlNet.ImageOutput image.

Description

Extracts from image small objects that are brighter than surroundings. Uses user-defined kernel.

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

Examples

Top Hat used to remove bigger objects. 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.

Hardware acceleration settings may be manipulated with Settings class.

Errors

List of possible exceptions:

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

Function Overrides

See also