ILMatchResults Interface Reference

This interface holds a collection of pattern matching results. More...

Inheritance diagram for ILMatchResults:

Public Member Functions
void	Draw (HDC hdc, int index, LPVPatDrawFlags drawFlags, double zoomX, double zoomY, double panX, double panY)
void	DrawAll (HDC hdc, LPVPatDrawFlags drawFlags, double zoomX, double zoomY, double panX, double panY)
ILMatchResult *	Item (int index)
Public Member Functions inherited from ILObjects
int	Count ()
BOOL	Empty ()
ILObject *	ItemObject (int objIndex)
Public Member Functions inherited from ILObject
ILObject *	Copy ()
LPVErrorCode	Load (LString filename)
void	Reset ()
LPVErrorCode	Save (LString filename)
BOOL	Valid ()

Detailed Description

This interface holds a collection of pattern matching results.

Usually you get the LMatchResults object from the ILMatch::Match() as matching result. You can then use this interface to access individual result and draw the results on graphics windows.

Example Code

C++

ILMatchResultsPtr matchResults;
LPVErrorCode err = matchTool->Match(img, roi, &matchResults);
if (err != LPVErrorCode::LPVNoError) return;
int c = matchResults->Count();
for (int i = 0; i < c; ++i) {
    ILMatchResultPtr result = matchResults->Item(i);
    // handle each line result
}

C#

LMatchResults matchResults;
LPVErrorCode err = matchTool.Match(img, (LRegion)roi, out matchResults);
if (err != LPVErrorCode.LPVNoError) return;
int c = matchResults.Count();
for (int i = 0; i < c; ++i) {
    LMatchResult result = matchResults.Item(i);
    // handle each line result
}

COM

ILMatchResultsPtr matchResults;
LPVErrorCode err = matchTool->Match(img, roi, &matchResults);
if (err != LPVErrorCode::LPVNoError) return;
int c = matchResults->Count();
for (int i = 0; i < c; ++i) {
    ILMatchResultPtr result = matchResults->Item(i);
    // handle each line result
}

Member Function Documentation

Draw()

void Draw	(	HDC	hdc,
		int	index,
		LPVPatDrawFlags	drawFlags,
		double	zoomX,
		double	zoomY,
		double	panX,
		double	panY
	)

Draw one pattern matching result of given index onto provide device context.

Parameters

[in]	index	Input index, it should be a 0-based number smaller than total count.
[in]	drawFlags	Flags to control the pattern drawing behavior, see LPVPatDrawFlags for usage.

See also

DrawAll()

Use Draw Functions

Remarks

This function is currently not available on Linux / MacOS platform.

DrawAll()

void DrawAll	(	HDC	hdc,
		LPVPatDrawFlags	drawFlags,
		double	zoomX,
		double	zoomY,
		double	panX,
		double	panY
	)

Draw all pattern matching results onto provide device context.

Parameters

[in]

drawFlags

Flags to control the pattern drawing behavior, see LPVPatDrawFlags for usage.

See also

Draw()

Use Draw Functions

Remarks

This function is currently not available on Linux / MacOS platform.

Item()

ILMatchResult* Item

(

int

index

)

Fetch one result with given index.

Parameters

[in]

index

Input index, it should be a 0-based number smaller than total count.

Return values

result

Return the matching result of given index.