IMcSpatialCalibSetPointMapping Method
|
|
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.
Namespace:
MediaCy.IQL.Calibrations
Assembly:
MediaCy.IQL.Calibrations (in MediaCy.IQL.Calibrations.dll) Version: 10.0.6912.0
SyntaxSub SetPointMapping (
DegreeX As Integer,
DegreeY As Integer,
Points As Object,
NumPoints As Integer
)
Parameters
- DegreeX
- Type: SystemInt32
The required polynomial degree in X. Enough points must be provided. - DegreeY
- Type: SystemInt32
The required polynomial degree in Y. Enough points must be provided - Points
- Type: SystemObject
An array of doubles in the following format: P1.x, P1.y, P2.x, P2.y,..., P1'.x, P1'.y, P2'x... - NumPoints
- Type: SystemInt32
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.
Return Value
Type:
HRESULT
RemarksThe 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.
See Also