IAffineTransformation2D.DefineFromControlPoints Method

Defines the best affine transformation between two sets of points. Can be used to register paper maps on a digitizer.

[Visual Basic .NET]
Public Sub DefineFromControlPoints ( _
    ByVal numPoints As Integer, _
    ByRef fromPoints As IPoint, _
    ByRef toPoints As IPoint _
)

[C#]
public void DefineFromControlPoints (
    int numPoints,
    ref IPoint fromPoints,
    ref IPoint toPoints
);

[C++]
HRESULT DefineFromControlPoints(
  long numPoints,
  IPoint** fromPoints,
  IPoint** toPoints
);

[C++]
Parameters
numPoints 
  numPoints is a parameter of type long
fromPoints [in]
  fromPoints is a parameter of type IPoint
toPoints [in]
  toPoints is a parameter of type IPoint

Product Availability

Description

The DefineFromControlPoints method may be particularly useful if you wish to register a set of control points from a digitizer to existing known control points. This method calculates a best fit affine transformation to map one set of control points onto another. Please see the AffineTransformation2D coclass for a description of the mathematical model.

Errors Returned

A minimum of 3 points are needed.  If this condition is not met, the error E_GEOMETRY_INSUFFICIENT_CONTROLPOINTS is returned.

See Also