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

AVL.BottomHatImage_Mask

Performs a morphological black top hat (bottom hat) operation on a image using a predefined mask.

Namespace:AvlNet
Assembly:AVL.NET.dll

Syntax

C++
C#
 
public static void BottomHatImage_Mask
(
	AvlNet.Image inImage,
	NullableRef<AvlNet.Region> inRoi,
	AvlNet.Pixel? inBorderColor,
	AvlNet.MorphologyKernel inKernel,
	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.
inBorderColorAvlNet.Pixel?Color of the imaginary pixels outside the image boundaries. Default value: atl::NIL.
inKernelAvlNet.MorphologyKernelSelects kernel shape.
outImageAvlNet.ImageOutput image.

Description

Extracts from image small objects that are darker than surroundings. Uses predefined mask.

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

Examples

Bottom Hat used to remove bigger objects. Used parameters inKernel=Box5x5. 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 BottomHatImage_Mask.

Function Overrides

See also