ILCalibPointPairs Interface Reference

This interface holds a collection of image and world point pairs. More...

Inheritance diagram for ILCalibPointPairs:

Public Member Functions
void	AddPointPair (double imagePointX, double imagePointY, double worldPointX, double worldPointY)
void	Draw (HDC hdc, int index, double zoomX, double zoomY, double panX, double panY)
void	DrawAll (HDC hdc, double zoomX, double zoomY, double panX, double panY)
ILPoint *	GetImagePoint (int index)
ILPoints *	GetImagePoints ()
ILPoint *	GetWorldPoint (int index)
ILPoints *	GetWorldPoints ()
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 image and world point pairs.

Usually you get the LCalibPointPairs object from the ILCalibBoard::Detect() as detection result. You can then use this interface to access individual point pair and draw them on graphics windows. You can also construct a point pair collection manually via AddPointPair().

Example Code

C++

ILCalibPointPairsPtr pntPairs = LCalibPointPairs::Create();
LPVErrorCode err = calibBoard->Detect(img, &pntPairs);
if (err != LPVErrorCode::LPVNoError) return;
int c = pntPairs->Count();
for (int i = 0; i < c; ++i) {
    ILPointPtr imgPnt = pntPairs->GetImagePoint(i);
    ILPointPtr worldPnt = pntPairs->GetWorldPoint(i);
    // handle each point pair
}

C#

LCalibPointPairs pntPairs;
LPVErrorCode err = calibBoard.Detect(img, out pntPairs);
if (err != LPVErrorCode.LPVNoError) return;
int c = pntPairs->Count();
for (int i = 0; i < c; ++i) {
    LPoint imgPnt = pntPairs->GetImagePoint(i);
    LPoint worldPnt = pntPairs->GetWorldPoint(i);
    // handle each point pair
}

COM

ILCalibPointPairsPtr pntPairs = LCalibPointPairs::Create();
// or, ILCalibPointPairsPtr pntPairs(__uuidof(LCalibPointPairs)), for absence of built-in Create functions (before 2.2.0)
LPVErrorCode err = calibBoard->Detect(img, &pntPairs);
if (err != LPVErrorCode::LPVNoError) return;
int c = pntPairs->Count();
for (int i = 0; i < c; ++i) {
    ILPointPtr imgPnt = pntPairs->GetImagePoint(i);
    ILPointPtr worldPnt = pntPairs->GetWorldPoint(i);
    // handle each point pair
}

Member Function Documentation

AddPointPair()

void AddPointPair	(	double	imagePointX,
		double	imagePointY,
		double	worldPointX,
		double	worldPointY
	)

Add a pair of image and world points to the collection

Parameters

[in]	imagePointX	The x-coordinate of the image point.
[in]	imagePointY	The y-coordinate of the image point.
[in]	worldPointX	The x-coordinate of the world point.
[in]	worldPointY	The y-coordinate of the world point.

Draw()

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

Draw a image point in one point pair of given index onto provide device context.

Parameters

[in]

index

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

See also

Use Draw Functions

Remarks

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

See also

DrawAll().

DrawAll()

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

Draw all image points in the collection onto provide device context.

See also

Use Draw Functions

Remarks

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

See also

Draw().

GetImagePoint()

ILPoint* GetImagePoint

(

int

index

)

Fetch one image point with given index.

Parameters

[in]

index

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

Return values

imagePoint

Return the image point of given index.

GetImagePoints()

ILPoints* GetImagePoints

(

)

Fetch all image points.

Return values

imagePoints

Return the collection of image points.

GetWorldPoint()

ILPoint* GetWorldPoint

(

int

index

)

Fetch one world point with given index.

Parameters

[in]

index

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

Return values

worldPoint

Return the world point of given index.

GetWorldPoints()

ILPoints* GetWorldPoints

(

)

Fetch all world points.

Return values

imagePoints

Return the collection of world points.