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

ErodeRegion_AnyKernel

Header:	FIL.h
Namespace:	fil
Module:	FoundationBasic

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

Applications: Making the region thinner in a non-symmetrical way or removing small parts of a particular shape.

Syntax

void fil::ErodeRegion_AnyKernel
(
	const fil::Region& inRegion,
	const fil::Region& inKernel,
	ftl::Optional<const fil::Location&> inKernelAnchor,
	fil::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 ErodeRegion 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 ErodeRegion article for further information regarding the morphological erosion 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 ErodeRegion_AnyKernel.