ILEdgeFilter Interface Reference

This interface provide functionalities of edge extraction. More...

Inheritance diagram for ILEdgeFilter:

Public Member Functions
void	GradientFull (ILImage *img, ILImage *result)
void	GradientH (ILImage *img, ILImage *result)
void	GradientV (ILImage *img, ILImage *result)
void	SetEdgeKernel (LPVEdgeKernel kType, int kWidth, int kHeight)
void	SetEdgePolarity (LPVPolarity xPolarity, enum LPVPolarity yPolarity)
Public Member Functions inherited from ILObject
ILObject *	Copy ()
LPVErrorCode	Load (LString filename)
void	Reset ()
LPVErrorCode	Save (LString filename)
BOOL	Valid ()

Properties
LPVPolarity	EdgePolarityX [get]
	The polarity of horizontally oriented edges in left-to-right direction. More...
LPVPolarity	EdgePolarityY [get]
	The polarity of vertically oriented edges in top-down direction. More...
int	KernelHeight [get]
	The height of the kernel size. More...
LPVEdgeKernel	KernelType [get]
	The kernel type. More...
int	KernelWidth [get]
	The width of the kernel size. More...
Properties inherited from ILObject
LString	Name [get, set]
	Name of the object. By default, the object has no name. In most cases, LPV classes don't make use of the names. The name is drawn on canvas around the object if ILDrawable::SetDrawName() is enabled. More...

Detailed Description

This interface provide functionalities of edge extraction.

To use this interface, you should create a LEdgeFilter object.

Example Code

C++

ILEdgeFilterPtr edgeOp = LEdgeFilter::Create();
edgeOp->SetEdgeKernel(LPVSobel, 5, 5);
edgeOp->GradientFull(img, resultImg);

C#

LEdgeFilter edgeOp = new LEdgeFilter();
edgeOp.SetEdgeKernel(LPVEdgeKernel.LPVSobel, 5, 5);
edgeOp.GradientFull(img, resultImg);

COM

ILEdgeFilterPtr edgeOp = LEdgeFilter::Create();
// or, ILEdgeFilterPtr edgeOp(__uuidof(LEdgeFilter)), for absence of built-in Create functions (before 2.2.0)
edgeOp->SetEdgeKernel(LPVSobel, 5, 5);
edgeOp->GradientFull(img, resultImg);

Member Function Documentation

GradientFull()

void GradientFull	(	ILImage *	img,
		ILImage *	result
	)

Both vertically and horizontally oriented edges are represented by bright pixels.

Parameters

[in]	img	The input image
[out]	result	Return result image

GradientH()

void GradientH	(	ILImage *	img,
		ILImage *	result
	)

Horizontally oriented edges are represented by bright pixels.

Parameters

[in]	img	The input image
[out]	result	Return result image

GradientV()

void GradientV	(	ILImage *	img,
		ILImage *	result
	)

Vertically oriented edges are represented by bright pixels.

Parameters

[in]	img	The input image
[out]	result	Return result image

SetEdgeKernel()

void SetEdgeKernel	(	LPVEdgeKernel	kType,
		int	kWidth,
		int	kHeight
	)

Set the kernel used in edge filtering of specified type and size.

Parameters

[in]	kType	The kernel Type.
[in]	kWidth	The width of the kernel size, should be an odd number in 1 ~ 31, say, 3, 5, 7, etc. If a kernel size is set to be 1, the kernel degenerated to be \( (-1, 1) \) no mater what kernel type it is.
[in]	kHeight	The height of the kernel size, should be an odd number in 1 ~ 31, say, 3, 5, 7, etc.

SetEdgePolarity()

void SetEdgePolarity	(	LPVPolarity	xPolarity,
		enum LPVPolarity	yPolarity
	)

Set the edge polarity of interest in edge filtering.

Parameters

[in]	xPolarity	The polarity of horizontally oriented edges in left-to-right direction. By default, it accept either polarity.
[in]	yPolarity	The polarity of vertically oriented edges in top-down direction. By default, it accept either polarity.

Property Documentation

EdgePolarityX

LPVPolarity EdgePolarityX

get

The polarity of horizontally oriented edges in left-to-right direction.

See also

SetEdgePolarity()

EdgePolarityY

LPVPolarity EdgePolarityY

get

The polarity of vertically oriented edges in top-down direction.

See also

SetEdgePolarity()

KernelHeight

int KernelHeight

get

The height of the kernel size.

See also

SetEdgeKernel()

KernelType

LPVEdgeKernel KernelType

get

The kernel type.

See also

SetEdgeKernel()

KernelWidth

int KernelWidth

get

The width of the kernel size.

See also

SetEdgeKernel()