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

[Visual Basic 6.0]
Sub DefineFromControlPoints(
    ByVal numPoints As Long, _
    fromPoints As IPoint, _
    toPoints As IPoint _
)

[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
);

[Java]
public void defineFromControlPoints (
    int numPoints,
    IPoint fromPoints,
    IPoint toPoints
)
throws
    IOException,
    AutomationException

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

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

Example

Send feedback on this page