IAffineTransformation2D.DefineFromEnvelopesEx Method

Defines a transformation that maps a point relative to one envelope to a similar position relative to another envelope.

[Visual Basic .NET]
Public Sub DefineFromEnvelopesEx ( _
    ByVal from As IEnvelope, _
    ByVal to As IEnvelope, _
    ByVal outFrom As IEnvelope, _
    ByVal assumeFalseOrigin As Boolean, _
    ByVal keepAspect As Boolean, _
    ByVal flipIt As Boolean _
)

[C#]
public void DefineFromEnvelopesEx (
    IEnvelope from,
    IEnvelope to,
    IEnvelope outFrom,
    bool assumeFalseOrigin,
    bool keepAspect,
    bool flipIt
);

[C++]
HRESULT DefineFromEnvelopesEx(
  IEnvelope* from,
  IEnvelope* to,
  IEnvelope* outFrom,
  VARIANT_BOOL assumeFalseOrigin,
  VARIANT_BOOL keepAspect,
  VARIANT_BOOL flipIt
);

[C++]
Parameters
from 
  from is a parameter of type IEnvelope
to 
  to is a parameter of type IEnvelope
outFrom 
  outFrom is a parameter of type IEnvelope
assumeFalseOrigin 
  assumeFalseOrigin is a parameter of type VARIANT_BOOL
keepAspect 
  keepAspect is a parameter of type VARIANT_BOOL
flipIt 
  flipIt is a parameter of type VARIANT_BOOL

Product Availability

Description

The IAffineTransformation2D::DefineFromEnvelopesEx allows to define an AffineTransformation based on two envelopes. This method can be used to make it easy to set up a drawing transformation if you're not using maps/display transforms.

Remarks

Parameters:

from: Input IEnvelope object that represents an envelope in the origin space
to: Input IEnvelope object that represents an envelope in the destination space
outFrom: Output IEnvelope object. If provided (can be nothing) this envelope is populated with a from envelope having the same aspect ratio as the to envelope.
assumeFalseOrigin: If assumeFalseOrigin is TRUE, then the transform will assume that an input point with coordinates (0, 0) is actually located at (from.xmin, from.ymin). Otherwise, the transform will include elements that shift each point by (-from.xmin, -from .ymin) before scaling.
keepAspect: Input Boolean value if TRUE the transformation will have the same XScale and YScale.
flipIt: Input Boolean value if TRUE, the transformation will contain an horizontal reflection.

See Also