You are here: Start » AVL.NET » AVL.DilateRegion Method

AVL.DilateRegion Method

Performs a morphological dilation on a region using a predefined kernel.

Namespace:	AvlNet
Assembly:	AVL.NET.dll

Syntax

public static void DilateRegion(
	AvlNet.Region inRegion,
	AvlNet.RegionMorphologyKernel inKernel,
	int inRadiusX,
	int? inRadiusY,
	out AvlNet.Region outRegion
)

Parameters

Name	Type	Range	Default	Description
inRegion	AvlNet.Region			Input region.
inKernel	AvlNet.RegionMorphologyKernel			Kernel shape (predefined).
inRadiusX	int	<0, INF>	1	Nearly half of the kernel's width (2*R+1). Default value: 1.
inRadiusY	int ?	<0, INF>		Nearly half of the kernel's height (2*R+1), or same as inRadiusX. Default value: atl::NIL, or null.
outRegion	AvlNet.Region			Output region.

Description

The operation performs a morphological dilation, which is a basic tool used for region expansion. Similarly to other region morphology operations, dilation is conducted using a shape called kernel (or structuring element). The kernel is repeatedly centered at each location within the dimensions of the input region. Then, pixel location L is added to the resulting region if and only if at least one of the input region pixels lies inside the kernel centered at this (L) location.

The input parameter inKernel allows to choose the shape of a kernel, while parameters inRadiusX, inRadiusY allow to determine its dimensions. For instance:

inKernel = Ellipse together with inRadiusX = inRadiusY results in expansion performed equally in all directions.
Setting inRadiusX to higher value than inRadiusY results in expansion performed more significantly along horizontal axis.

Examples

DilateRegion run with inKernel = Ellipse of dimensions inRadiusX = 5, inRadiusY = 5.

Errors