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

DilateRegion_AnyKernel

Header:	AVL.h
Namespace:	avl
Module:	FoundationBasic

Performs a morphological dilation on a region using an arbitrary kernel.

Applications: Making the region thicker in a non-symmetrical way or filling-in gaps of a particular shape.

Syntax

void avl::DilateRegion_AnyKernel
(
	const avl::Region& inRegion,
	const avl::Region& inKernel,
	atl::Optional<const avl::Location&> inKernelAnchor,
	avl::Region& outRegion
)

Parameters

Name	Type	Default	Description
inRegion	const Region&		Input region
inKernel	const Region&		Kernel shape (any)
inKernelAnchor	Optional<const Location&>	NIL	Location within inKernel, defining its center
outRegion	Region&		Output region

Description

The operation is a cousin of the DilateRegion filter, yet it uses any proper region selected by user as a structuring element. The center of a kernel is assumed to be at location (width/2,height/2). Refer to the DilateRegion article for further information regarding the morphological dilation itself.

Examples

Hardware Acceleration

This operation supports automatic parallelization for multicore and multiprocessor systems.

Errors

List of possible exceptions:

Error type	Description
DomainError	Empty kernel on input in DilateRegion_AnyKernel.