ILCircleResults Interface Reference

This interface holds a collection of circle detection results. More...

Inheritance diagram for ILCircleResults:

Public Member Functions
void	Draw (HDC hdc, int index, LPVCircleDrawFlags drawFlags, double zoomX, double zoomY, double panX, double panY)
void	DrawAll (HDC hdc, LPVCircleDrawFlags drawFlags, double zoomX, double zoomY, double panX, double panY)
void	DrawScoreChart (HDC hdc, LPVChartDrawFlags drawFlags, int xGridStep, int yGridStep)
ILCircleResult *	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 circle detection results.

Usually you get the LCircleResults object from the ILCircleDetector::Detect() as detection result. You can then use this interface to access individual result and draw the results on graphics windows.

Example Code

C++

ILCircleResultsPtr circleResults;
LPVErrorCode err = circleDetector->Detect(img, roi, &circleResults);
if (err != LPVErrorCode::LPVNoError) return;
int c = circleResults->Count();
for (int i = 0; i < c; ++i) {
    LCircleResult result = circleResults->Item(i);
    // handle each circle result
}

C#

LCircleResults circleResults;
LPVErrorCode err = circleDetector.Detect(img, (LAnnulusRegion)roi, out circleResults);
if (err != LPVErrorCode.LPVNoError) return;
int c = circleResults.Count();
for (int i = 0; i < c; ++i) {
    LCircleResult result = circleResults.Item(i);
    // handle each circle result
}

COM

ILCircleResultsPtr circleResults;
LPVErrorCode err = circleDetector->Detect(img, roi, &circleResults);
if (err != LPVErrorCode::LPVNoError) return;
int c = circleResults->Count();
for (int i = 0; i < c; ++i) {
    LCircleResult result = circleResults->Item(i);
    // handle each circle result
}

Member Function Documentation

Draw()

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

Draw one circle 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 circle drawing behavior, see LPVCircleDrawFlags for usage.

See also

DrawAll()

Use Draw Functions

Remarks

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

DrawAll()

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

Draw all circle results onto provide device context.

Parameters

[in]

drawFlags

Control the drawing behavior, see LPVCircleDrawFlags

See also

Draw()

Use Draw Functions

Remarks

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

DrawScoreChart()

void DrawScoreChart	(	HDC	hdc,
		LPVChartDrawFlags	drawFlags,
		int	xGridStep,
		int	yGridStep
	)

Draw a score chart onto provide device context. It represents the score(y axis) distributions along the region's direction(x axis). It's useful for determining a proper acceptable score.

Parameters

[in]	hdc	Handle to the device context of the destination window or bitmap.
[in]	drawFlags	Flags to control which part of a data chart should be drawn, see LPVChartDrawFlags for usage.
[in]	xGridStep	Specify the step of label on x axis, 0 means we'll determine it on the fly according to the score data.
[in]	yGridStep	Specify the step of label on y axis, 0 means we'll determine it on the fly according to the score data. This function is currently not available on Linux / MacOS platform.

Item()

ILCircleResult* 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 circle result of given index.