ENVELOPE

ENVELOPE

Used in: CONFIG REQUEST RESPONSE MARKUP
Parent elements: EXTRACT FCLASS FEATURE FEATURES IMAGE LAYERINFO PARTITION PROPERTIES SPATIALFILTER

<ENVELOPE	Attribute Description Table
*maxx ="double"* *maxy ="double"* *minx ="double"* *miny ="double"* name ="Initial_Extent \| Extent_Limit" [Initial_Extent] reaspect ="true \| false" [true] > No child elements </ENVELOPE >
Bold: Attribute or child element is required.

Description:

When in PROPERTIES, ENVELOPE defines the map’s initial extent or can be used to describe the extent limit.
When in PARTITION, it defines the extent for a single part of a partitioned data set.
When in SPATIALFILTER, it defines a rectangular area to be used as a spatial filter.
When the parent element is FCLASS or LAYERINFO, it describes the extent of the layer.
When the parent element is IMAGE or EXTRACT, it describes the extent for the map returned in the image or the extent for extracted data.
When in a FEATURES response or in MARKUP and the parent element is FEATURE, it describes the extent of that specific feature.
When parent element is FEATURES, it describes the extent of all features returned in the response.

Restrictions:

Name is used only in viewer configuration files, most commonly default.axl, when parent element is PROPERTIES.
Reaspect is used only when parent element is PROPERTIES. It is valid only for Image MapServices and is ignored in Feature MapServices.

Notes:

None

Attribute Descriptions for ENVELOPE:

Attribute	Usage	Back to Top
maxx	Right top x-coordinate in map units.
maxy	Right top y-coordinate in map units.
minx	Left bottom x-coordinate in map units.
miny	Left bottom y-coordinate in map units.
name	Identifies the type of envelope extent in a viewer configuration file. Initial_Extent is the full extent drawn when a file is first accessed. Extent_Limit is the maximum extent allowable when zooming out. When an extent limit is used in a viewer configuration file, two ENVELOPE elements are needed: <PROPERTIES> <ENVELOPE minx="-61.1" miny="3.7" maxx="91.7" maxy="61.3" name="Initial_Extent"/> <ENVELOPE minx="-61.1" miny="3.7" maxx="91.7" maxy="61.3" name="Extent_Limit"/> <PROPERTIES> The two ENVELOPE extents do not need to be the same.
reaspect	Flag indicating whether the ENVELOPE should be stretched to fit the viewing area in the client. By default, the pixel width and height ratio stays the same. By setting reaspect to false, the pixel width and height are stretched.

Examples for ENVELOPE:

Example 1: Used in CONFIG to set the initial extent.

Back to Top

<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
  <CONFIG>
    <ENVIRONMENT>
      <LOCALE country="US" language="en" variant="" />
      <UIFONT color="0,0,0" name="Arial" size="12" style="regular" />
      <SCREEN dpi="96" />
    </ENVIRONMENT>
    <MAP>
      <PROPERTIES>
       <ENVELOPE minx="-178.2" miny="18.9" maxx="-66.9" maxy="71.4" name="Initial_Extent" />
       <MAPUNITS units="decimal_degrees" />
      </PROPERTIES>
      <WORKSPACES>
       <SHAPEWORKSPACE name="shp_ws-0" directory="<path to USA ESRIDATA>" />
      </WORKSPACES>
      <LAYER type="featureclass" name="STATES" visible="true" id="0">
       <DATASET name="STATES" type="polygon" workspace="shp_ws-0" />
       <SIMPLERENDERER>
         <SIMPLEPOLYGONSYMBOL fillcolor="255,255,153" filltype="solid" />
       </SIMPLERENDERER>
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>

Example 2: When in a GET_IMAGE REQUEST to set the selection area for the spatial filter (first ENVELOPE) and the overall extent of the map (second ENVELOPE).

Back to Top

<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
  <REQUEST>
  <GET_IMAGE>
    <PROPERTIES>
      <ENVELOPE minx="-180" miny="-90" maxx="180" maxy="90" />
      <LAYERLIST>
        <LAYERDEF id="Cities">
          <SIMPLERENDERER>
            <SIMPLEMARKERSYMBOL size="16" color="0,0,0" />
          </SIMPLERENDERER>
         <SPATIALQUERY>
            <SPATIALFILTER relation="area_intersection">
            <ENVELOPE maxy="60" maxx="60" miny="0" minx="0" />
         </SPATIALFILTER>
         </SPATIALQUERY>
      </LAYERDEF>
      </LAYERLIST>
   </PROPERTIES>
  </GET_IMAGE>
  </REQUEST>
</ARCXML>

Example 3: Identifies the initial extent and the extent of a layer in a SERVICEINFO response.

Back to Top

<?xml version="1.0" encoding="UTF8"?>
<ARCXML version="1.1">
  <RESPONSE>
    <SERVICEINFO>
      <ENVIRONMENT>
        <LOCALE language="en" country="US" />
        <UIFONT name="Arial" color="0,0,0" size="12" style="regular" />
        <SEPARATORS cs=" " ts=";"/>
        <SCREEN dpi="96"/>
        <IMAGELIMIT pixelcount="1048576" />
      </ENVIRONMENT>
      <PROPERTIES>
        <ENVELOPE minx="-180" miny="-90" maxx="180" maxy="90" name="Initial_Extent" />
        <MAPUNITS units="decimal_degrees" />
      </PROPERTIES>
      <LAYERINFO type="featureclass" visible="true" name="Cities" id="0">
        <FCLASS type="point">
          <ENVELOPE minx="-165.270004272461" miny="-53.1500015258789" maxx="177.130187988281" maxy="78.1999969482422" />
        </FCLASS>
      </LAYERINFO>
    </SERVICEINFO>
  </RESPONSE>
</ARCXML>