This interface represents a collection of points(LPoints object). More...

Inheritance diagram for ILPoints:

Public Member Functions
void	Add (double x, double y)

void	AddPoints (ILPoints *points)

void	AddPointsInRegion (ILRegion *region)

int	Count ()

LArray< double >	DistancesToLine (ILLine *line)

LArray< double >	DistancesToPoint (ILPoint *point)

LArray< double >	DistancesToPoints (ILPoints *points, LArray< int > indexes)

LArray< double >	DistancesToPolygon (ILPolygon polygon, LArray< ILPoint > rootPoints)

double	DistanceToLine (ILLine *line, LPVAggregation aggType)

double	DistanceToPoint (ILPoint *point, LPVAggregation aggType)

double	DistanceToPoints (ILPoints *points, LPVAggregation aggType)

double	DistanceToPolygon (ILPolygon *polygon, LPVAggregation aggType)

void	Draw (HDC hdc, double zoomX, double zoomY, double panX, double panY)

BOOL	Empty ()

ILCircle *	FitCircle ()

ILEllipse *	FitEllipse ()

ILLine *	FitLine ()

void	FromSortables (ILSortables *sortable, LPVPositionMode posMode)

ILCircle *	GetBoundingCircle ()

ILRect *	GetBoundingRect ()

ILRect *	GetBoundingRotRect ()

ILPoint *	GetCenter ()

ILPolygon *	GetConvexHull ()

void	GetPoints (LArray< double > xs, LArray< double > ys)

ILPoint *	Item (int index)

void	RemovePoints (double lbX, double ubX, double lbY, double ubY)

ILPoints *	Scale (double factorX, double factorY)

void	SetPoints (LArray< double > xs, LArray< double > ys)

ILPoints *	Transform (ILTransform *tf)

ILPoints *	Translate (double offsetX, double offsetY)

Public Member Functions inherited from ILGeomObject
void	Drag (LPVGeomHandle geomHandle, int posX, int posY, double zoomX, double zoomY, double panX, double panY)

void	EnableHandle (LPVGeomHandle geomHandle, BOOL enabled)

LPVGeomHandle	HitTest (int posX, int posY, double zoomX, double zoomY, double panX, double panY)

void	ScaleTo (double factorX, double factorY)

void	TransformTo (ILTransform *tf)

void	TranslateTo (double offsetX, double offsetY)

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 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 represents a collection of points(LPoints object).

Member Function Documentation

◆ Add()

void Add	(	double	x,
		double	y
	)

Add a point to the collection.

Parameters

[in]	x	The x-coordinate of the new point
[in]	y	The y-coordinate of the new point

◆ AddPoints()

void AddPoints ( ILPoints * points )

Add the points in the given collection to this.

Parameters

[in] points The input points

◆ AddPointsInRegion()

void AddPointsInRegion ( ILRegion * region )

Add all points in the given region to the collection.

Parameters

[in] region The input region

◆ Count()

int Count ( )

Get count of the points.

◆ DistancesToLine()

LArray<double> DistancesToLine ( ILLine * line )

Calculate the distance from each point in the collection to the input line, report all the distances. The distance is defined as ILLine::Perpendicular().

Parameters

[in] line The input line.

Return values

vals	Return all the distances, in the same order as the points.

◆ DistancesToPoint()

LArray<double> DistancesToPoint ( ILPoint * point )

Calculate the distance from each point in the collection to the input point, report all the distances. The distance is defined as ILPoint::Distance().

Parameters

[in] point The input point

Return values

vals	Return all the distances, in the same order as the points.

◆ DistancesToPoints()

LArray<double> DistancesToPoints	(	ILPoints *	points,
		LArray< int >	indexes
	)

Calculate the distance from each point in the collection to the nearest point in the input points, report all the distances and the index of the nearest point.

Parameters

[in]	points	The input points
[out]	indexes	Output the index of the nearest point in the input

Return values

vals	Return all the distances, in the same order as the points.

◆ DistancesToPolygon()

LArray<double> DistancesToPolygon	(	ILPolygon *	polygon,
		LArray< ILPoint * >	rootPoints
	)

Calculate the distance from each point in the collection to the input polygon, report all the distances. The distance is defined as ILPolygon::DistanceToPoint().

Parameters

[in]	polygon	The input polygon
[out]	rootPoints	Output the root points on the polygon

Return values

vals	Return all the distances, in the same order as the points.

◆ DistanceToLine()

double DistanceToLine	(	ILLine *	line,
		LPVAggregation	aggType
	)

Calculate the distance from each point in the collection to the input line, report the aggregated metric such as maximum, minimum or average distance. The distance is defined as ILLine::Perpendicular().

Parameters

[in]	line	The input Line
[in]	aggType	The aggregation type

Return values

val	Return the distance metric.

◆ DistanceToPoint()

double DistanceToPoint	(	ILPoint *	point,
		LPVAggregation	aggType
	)

Calculate the distance from each point in the collection to the input point, report the aggregated metric such as maximum, minimum or average distance. The distance is defined as ILPoint::Distance().

Parameters

[in]	point	The input point
[in]	aggType	The aggregation type

Return values

val	Return the distance metric.

◆ DistanceToPoints()

double DistanceToPoints	(	ILPoints *	points,
		LPVAggregation	aggType
	)

Calculate the distance from each point in the collection to the nearest point in the input points, report the aggregated metric such as maximum, minimum or average distance.

Parameters

[in]	points	The input points
[in]	aggType	The aggregation type

Return values

val	Return the distance metric.

◆ DistanceToPolygon()

double DistanceToPolygon	(	ILPolygon *	polygon,
		LPVAggregation	aggType
	)

Calculate the distance from each point in the collection to the input polygon, report the aggregated metric such as maximum, minimum or average distance. The distance is defined as ILPolygon::DistanceToPoint().

Parameters

[in]	polygon	The input polygon
[in]	aggType	The aggregation type

Return values

val	Return the distance metric.

◆ Draw()

void Draw	(	HDC	hdc,
		double	zoomX,
		double	zoomY,
		double	panX,
		double	panY
	)

Draw all the points on HDC.

Since: 2.12 The shape parameter is deprecated and should be set via ILDrawable::SetDrawPoint()

See also: Use Draw Functions

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

◆ Empty()

BOOL Empty ( )

Get whether the collection is empty

Return values

Return true for empty, false otherwise.

◆ FitCircle()

ILCircle* FitCircle ( )

Fit a circle which minimize the total distance between the result and all the points. If out-lier filtering is necessary, use LFitting instead.

Return values

val	Return the fitting result circle

See also: FitLine(), FitEllipse().

◆ FitEllipse()

ILEllipse* FitEllipse ( )

Fit an ellipse which minimize the total distance between the result and all the points.

Return values

val	Return the fitting result ellipse

See also: FitLine(), FitCircle().

◆ FitLine()

ILLine* FitLine ( )

Fit a line which minimize the total distance between the result and all the points. If out-lier filtering is necessary, use LFitting instead.

Return values

val	Return the fitting result line

See also: FitCircle(), FitEllipse().

◆ FromSortables()

void FromSortables	(	ILSortables *	sortable,
		LPVPositionMode	posMode
	)

Set placement of the points from the input sortable collection object.

Parameters

[in]	sortable	The input sortable collection object
[in]	posMode	Specify which points are used as the objects's positions, usually the centers.

◆ GetBoundingCircle()

ILCircle* GetBoundingCircle ( )

Get the bounding circle of all the points

◆ GetBoundingRect()

ILRect* GetBoundingRect ( )

Get the bounding rectangle of all the points

◆ GetBoundingRotRect()

ILRect* GetBoundingRotRect ( )

Get the rotated bounding rectangle of all the points

◆ GetCenter()

ILPoint* GetCenter ( )

Get the center, it's averaging position of the all points, as:

\[ (\overline{x}, \overline{y}) \]

◆ GetConvexHull()

ILPolygon* GetConvexHull ( )

Get the bounding convex hull of all the points

◆ GetPoints()

void GetPoints	(	LArray< double >	xs,
		LArray< double >	ys
	)

Get all the points

Parameters

[in]	xs	Output x-coordinates of the points, you should get the count and reserve the array outside.
[in]	ys	Output y-coordinates of the points

◆ Item()

ILPoint* Item ( int index )

Fetch one point with the given index.

Parameters

[in] index The input index, it should be a 0-based number smaller than total count.

Return values

point Return the point of given index.

◆ RemovePoints()

void RemovePoints	(	double	lbX,
		double	ubX,
		double	lbY,
		double	ubY
	)

Remove some points in the collection which is in the given range.

Parameters

[in]	lbX	The lower bound of the x-coordinate to be removed
[in]	ubX	The upper bound of the x-coordinate to be removed
[in]	lbY	The lower bound of the y-coordinate to be removed
[in]	ubY	The upper bound of the y-coordinate to be removed

◆ Scale()

ILPoints* Scale	(	double	factorX,
		double	factorY
	)

Scale the points by the given factor and return a new collection of points

Parameters

[in]	factorX	The scale factor of x-coordinate
[in]	factorY	The scale factor of y-coordinate. Set to 0 means same zoom factor as `factorX`, aka. isotropic scaling

Return values

results Return the new collection of points

◆ SetPoints()

void SetPoints	(	LArray< double >	xs,
		LArray< double >	ys
	)

Set the points

Parameters

[in]	xs	The x-coordinate of the points
[in]	ys	The y-coordinate of the points

◆ Transform()

ILPoints* Transform ( ILTransform * tf )

Transform the points via the given transformation and return a new collection of points

Parameters

[in] tf The transformation.

Return values

Return the new collection of points

◆ Translate()

ILPoints* Translate	(	double	offsetX,
		double	offsetY
	)

Translate the points by the given offset and return a new collection of points

Parameters

[in]	offsetX	The x-coordinate of the offset
[in]	offsetY	The y-coordinate of the offset

Return values

results Return the new collection points

Public Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ Add()

◆ AddPoints()

◆ AddPointsInRegion()

◆ Count()

◆ DistancesToLine()

◆ DistancesToPoint()

◆ DistancesToPoints()

◆ DistancesToPolygon()

◆ DistanceToLine()

◆ DistanceToPoint()

◆ DistanceToPoints()

◆ DistanceToPolygon()

◆ Draw()

◆ Empty()

◆ FitCircle()

◆ FitEllipse()

◆ FitLine()

◆ FromSortables()

◆ GetBoundingCircle()

◆ GetBoundingRect()

◆ GetBoundingRotRect()

◆ GetCenter()

◆ GetConvexHull()

◆ GetPoints()

◆ Item()

◆ RemovePoints()

◆ Scale()

◆ SetPoints()

◆ Transform()

◆ Translate()