ILEllipseGauge Interface Reference

This interface provide functionalities of ellipse inspection via the gauge. More...

Inheritance diagram for ILEllipseGauge:

Public Member Functions
LPVErrorCode	Detect (ILImage *img, ILEllipseRegion *region, ILShapeGaugeResult **gaugeResult)
Public Member Functions inherited from ILObject
ILObject *	Copy ()
LPVErrorCode	Load (LString filename)
void	Reset ()
LPVErrorCode	Save (LString filename)
BOOL	Valid ()

Additional Inherited Members
Properties inherited from ILShapeGauge
int	FitCountThreshold [get, set]
	The minimum count of points contribute to a valid fitting result.
double	FitDistThreshold [get, set]
	The distance threshold between the result line and a sample point, for filtering the out-lier points. Set to negative value(-1) to bypass the out-lier filtering.
int	SampleRegionHeight [get, set]
	The height of the sample region, at least 5 pixels. Please check the Detect() function of individual gauge tool, for either it adopts this property or region's height during inspection.
int	SampleRegionInterval [get, set]
	The distance between the centers of two nearby sample regions.
int	SampleRegionWidth [get, set]
	The width of the sample region, at least 5 pixels.
Properties inherited from ILGauge
int	AcceptScore [get, set]
	The accept score used in inspection. It defines the minimum score for identifying the sample point as a valid result. You may pick a proper score with help of the score chart. More...
int	KernelSize [get, set]
	The kernel size used in gradient filtering, should be an odd number which is ≥ 3, say 3, 5, 7, etc.
int	MaxSamplePointCount [get, set]
	The maximum of sample points to find in each sample region.
BOOL	NormScore [get, set]
	Whether we should normalize the score based on maximum gradient or grayscale value in region.
LPVPolarity	Polarity [get, set]
	The detection polarity, either object or edge polarity is acceptable.
LPVGaugeFeatures	SortBy [get, set]
	The method used to sort all sample point candidates, the top ones are reported as final results. More...
LPVFindBy	SortByPosition [get, set]
	Works when SortBy enables LPVGaugeFeaturePosition, prefer either the last, the central or the last ones. More...
BOOL	SortByScoreDescending [get, set]
	Works when SortBy enables LPVGaugeFeatureScore. True to sort all sample point candidates descending(from large score to small, aka. prefer the maximum magnitude), false for sorting in ascending order. More...

Detailed Description

This interface provide functionalities of ellipse inspection via the gauge.

The ellipse gauge is used to measure position and size of the ellipse formed by the elliptical edges. Edge points are sampled along the given region using equally spaced point measurement gauges, and then fit to a ellipse.

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

Example Code

C++

ILEllipseGaugePtr ellipseGauge = LEllipseGauge::Create();
ellipseGauge->Polarity = LPVPolarity::LPVBlack2White;
ellipseGauge->AcceptScore = 40;
ellipseGauge->SampleRegionHeight = 150;
ILShapeGaugeResultPtr ellipseGaugeResult;
LPVErrorCode err = ellipseGauge->Detect(img, ellipseRoi, &ellipseGaugeResult);
if (err != LPVErrorCode::LPVNoError) return;

C#

LEllipseGauge ellipseGauge = new LEllipseGauge();
ellipseGauge.Polarity = LPVPolarity.LPVBlack2White;
ellipseGauge.AcceptScore = 40;
ellipseGauge.SampleRegionHeight = 150;
LShapeGaugeResult ellipseGaugeResult;
LPVErrorCode err = ellipseGauge.Detect(img, ellipseRoi, out ellipseGaugeResult);
if (err != LPVErrorCode.LPVNoError) return;

COM

ILEllipseGaugePtr ellipseGauge = LEllipseGauge::Create();
// or, ILEllipseGaugePtr ellipseGauge(__uuidof(LEllipseGauge)), for absence of built-in Create functions (before 2.2.0)
ellipseGauge->Polarity = LPVPolarity::LPVBlack2White;
ellipseGauge->AcceptScore = 40;
ellipseGauge->SampleRegionHeight = 150;
ILShapeGaugeResultPtr ellipseGaugeResult;
LPVErrorCode err = ellipseGauge->Detect(img, ellipseRoi, &ellipseGaugeResult);
if (err != LPVErrorCode::LPVNoError) return;

Member Function Documentation

Detect()

LPVErrorCode Detect	(	ILImage *	img,
		ILEllipseRegion *	region,
		ILShapeGaugeResult **	gaugeResult
	)

Detect the ellipse using the ellipse gauge.

Parameters

[in]	img	The input image.
[in]	region	The input region, it should be ellipse region, the height of the sample region is controlled by SampleRegionHeight.
[out]	gaugeResult	Return the gauge result, it contains the result ellipse.

Return values

error

Return error code if anything is wrong.