English

How To: Use the ENVELOPE tag in a GET_LAYOUT request

Summary

The ENVELOPE tag of a GET_LAYOUT request defines an envelope for either the layout as a whole or an individual data frame within the layout. The tag consists of four attributes: minx, miny, maxx, and maxy. These are the coordinate values defining the image envelope.

The ENVELOPE tag can be used in both the PROPERTIES and DATAFRAME child elements of the GET_LAYOUT request.

For more information please refer to the ArcXML Programmer's Reference Guide topic "Using GET_LAYOUT and LAYOUT with ArcMap Image Services", by following the link in Related Information, below.

Procedure

  • When ENVELOPE is used in PROPERTIES the coordinates refer to the layout page in page units.
    For instance, the following code specifies a layout envelope of 8.5 by 11 inches, assuming the ArcMap document layout page units is inches.
    Code:
    <PROPERTIES>
     <ENVELOPE minx= "0" miny= "0" maxx= "8.5" maxy= "11" />
    </PROPERTIES >
    Note:
    If the coordinates specified in the ENVELOPE tag within PROPERTIES differ from the original ArcMap document layout page the layout result will not adjust to the new size. Instead, the result will show a portion of the layout or show extra white space based on the coordinates given.
  • When ENVELOPE is used in DATAFRAME, the coordinates refer to the data frame in map units. When ENVELOPE coordinates are specified within DATAFRAME the spatial extent of the data frame will change accordingly.

    The following code specifies a data frame envelope defined by a minimum and maximum X and Y coordinate values. The coordinate system of the data frame is a Robinson Projection (54030).
    Code:
    <DATAFRAME id= "DataFrameName" >
     <ENVELOPE minx= "-8260377" miny= "-3192427" maxx= "3697151" maxy= "5775719" />
    </DATAFRAME >
    In another example, a data frame envelope is defined by a minimum and maximum latitude and longitude. The data frame uses a Geographic coordinate system.
    Code:
    <DATAFRAME id= "DataFrameName" >
     <ENVELOPE minx= "-94" miny= "32" maxx= "-73" maxy= "46" />
    </DATAFRAME >
    Note:
    The units used when specifying ENVELOPE should either match the map units of the data frame, or match the units of the coordinate system specified by the FILTERCOORDSYS tag. Also, the coordinates specified may be adjusted to maintain the aspect ratio of the data frame.

Related Information