This document is archived and information here might be outdated.  Recommended version.


IAffineTransformation2D.DefineFromEnvelopesEx Method (ArcObjects .NET 10.8 SDK)
ArcObjects Help for .NET developers > ArcObjects Help for .NET developers > ArcObjects namespaces > Geometry > ESRI.ArcGIS.Geometry > Interfaces > IA > IAffineTransformation2D Interface > IAffineTransformation2D.DefineFromEnvelopesEx Method
ArcGIS Developer Help

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 bool keepAspect
keepAspect is a parameter of type bool flipIt
flipIt is a parameter of type 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