Description

Set a spatial calibration mapping via a set of points. A set of points, and their corresponding calibrated values, are used to define a polynomial mapping of the type described in SetPolynomialMapping.

Return Type

None  
Value Meaning

HRESULT

 

Syntax

object.SetPointMapping DegreeX, DegreeY, Points, NumPoints

The SetPointMapping Method syntax has these parts:

PartDescription
objectAn expression evaluating to an object of type McSpatialCalib.
DegreeXRequired. A Long value.

The required polynomial degree in X. Enough points must be provided.

DegreeYRequired. A Long value.

The required polynomial degree in Y. Enough points must be provided

PointsRequired. A Variant value.

An array of doubles in the following format: P1.x, P1.y, P2.x, P2.y,..., P1'.x, P1'.y, P2'x...

NumPointsRequired. A Long value.

The number of pairs of points (raw + calibrated) in Points. I.e. NumPoints = 3 means that Points contains 3 uncalibrated points and their 3 calibrated values. In all, it's 12 values.

Remarks

The number of points required to generate a polynomial mapping of degrees DegreeX,DegreeY is equal to (DegreeX+1) x (DegreeY+1). For instance, a second degree mapping will require at least nine points and their calibrated equivalents. A uniform linear mapping (partial polynomial of degree one) will require at least two points.