ArcObjects Library Reference (Geometry)  

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

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

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

IAffineTransformation2D Interface