ILFitting Interface Reference

This interface functionalities of geometric shape fitting from some given points. More...

Inheritance diagram for ILFitting:

Public Member Functions
ILCircle *	FitCircle (ILPoints *points)
ILLine *	FitLine (ILPoints *points)
Public Member Functions inherited from ILObject
ILObject *	Copy ()
LPVErrorCode	Load (LString filename)
void	Reset ()
LPVErrorCode	Save (LString filename)
BOOL	Valid ()

Properties
int	CountThreshold [get, set]
	The minimum required count of points that contribute to a valid fitting result. By default, it's -1 means bypass the count check.
double	DistThreshold [get, set]
	The distance threshold between the fitting result and a valid point. Points with a longer distance than this value will be treated as out-lier then be excluded from the fitting. By default, it's -1 means bypass the out-lier filtering.
int	MaxIteration [get, set]
	The maximum iteration count used for optimizing the fitting. By default, it's 10.
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 functionalities of geometric shape fitting from some given points.

Compared with the fitting method in ILPoints interface, it's able to filtering out-lier points and is more robust to insufficient inputs.

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

Example Code

C++

ILFittingPtr fittingTool = LFitting::Create();
fittingTool->DistThreshold = 3;
fittingTool->CountThreshold = 10;
ILLinePtr line = fittingTool->FitLine(points);

C#

LFitting fittingTool = new LFitting();
fittingTool.DistThreshold = 3;
fittingTool.CountThreshold = 10;
LLine line = fittingTool.FitLine(points);

COM

ILFittingPtr fittingTool = LFitting::Create();
// or, ILFittingPtr fittingTool(__uuidof(LFitting)), for absence of built-in Create functions (before 2.2.0)
fittingTool->DistThreshold = 3;
fittingTool->CountThreshold = 10;
ILLinePtr line = fittingTool->FitLine(points);

Member Function Documentation

FitCircle()

ILCircle* FitCircle

(

ILPoints *

points

)

Fit a circle based on the input points, which minimize the total distances and go through most of the inputs.

Parameters

[in]

points

The input points.

Return values

val	Return the fitting result circle

FitLine()

ILLine* FitLine

(

ILPoints *

points

)

Fit a line based on the input points, which minimize the total distances and go through most of the inputs.

Parameters

[in]

points

The input points.

Return values

val	Return the fitting result line