Back to Aurora Vision Library website

You are here: Start » Function Reference » Region » Region Morphology » BottomHatRegion

BottomHatRegion


Header: AVL.h
Namespace: avl
Module: FoundationBasic

Performs a morphological black top hat (bottom hat) operation on a region using a predefined kernel.

Syntax

C++
C#
 
void avl::BottomHatRegion
(
	const avl::Region& inRegion,
	avl::KernelShape::Type inKernel,
	int inRadiusX,
	atl::Optional<int> inRadiusY,
	avl::Region& outRegion
)

Parameters

Name Type Range Default Description
Input value inRegion const Region& Input region
Input value inKernel KernelShape::Type Kernel shape (predefined)
Input value inRadiusX int 0 - 1 Nearly half of the kernel's width (2*R+1)
Input value inRadiusY Optional<int> 0 - NIL Nearly half of the kernel's height (2*R+1), or same as inRadiusX
Output value outRegion Region& Output region

Description

Extracts small parts which do not belong to region. Uses predefined kernels.

Is performed by running consecutively two filters. CloseRegion to remove small holes from region and RegionDifference to remove rest of the region.

Examples

Top Hat used to remove bigger parts of which do not belong to region. Used parameters inKernel=Ellipse and inRadiusX=5. Region marked white. Source image on the left and result on the right.

Errors

List of possible exceptions:

Error type Description
DomainError Unsupported kernel in BottomHatRegion.