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


IAffineTransformation2D.DefineFromEnvelopesEx Method (ArcObjects .NET 10.5 SDK)
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