SCALEDEPENDENTRENDERER

SCALEDEPENDENTRENDERER

Used in: CONFIG   REQUEST   RESPONSE
Servers: Image   Feature
Parent elements: GROUPRENDERER   LAYER   LAYERDEF   LAYERINFO   SCALEDEPENDENTRENDERER

<SCALEDEPENDENTRENDERER	Attribute Description Table
lower ="double or string" upper ="double or string" > <GROUPRENDERER... /> [Or] <SCALEDEPENDENTRENDERER... /> [Or] <SIMPLELABELRENDERER... /> [Or] <SIMPLERENDERER... /> [Or] <VALUEMAPLABELRENDERER... /> [Or] <VALUEMAPRENDERER... /> [Or] </SCALEDEPENDENTRENDERER >
Bold: Attribute or child element is required.

Description:

Displays specified rendering information at certain scales. A layer can have different renderings depending on the current scale. For example, when zoomed out, you can draw a street layer one pixel in width. As you zoom farther in, you can draw the street layer eight pixels in width and in a different color.

Restrictions:

Only one child element can be used inside a SCALEDEPENDENTRENDERER.
Not valid with ArcMap Server.

Notes:

Scales can be set in ArcXML using a relative scale or by calculating the number of map units per pixel. A relative scale represents the scale in a ratio such as 1:24000. In this example, 1 meter equals 24000 meters, or 1 inch equals 24000 inches. When using relative scale, always use a colon (:) between the two values.

Map units per pixel refers to the number of meters, feet, or decimal degrees represented by one pixel in a map. To convert from a relative scale to map units per pixel, the size of a pixel must first be calculated. The formula for finding the number of meters in a pixel is 0.0254 / dpi. The value 0.0254 is the number of meters in an inch, and dpi is the dpi set in the ArcIMS service or request. If no dpi is set in the service or request, the dpi is assumed to be 96. As an example of pixel size, if the dpi is 96, the pixel size is 0.0254 / 96 or 0.000265 m. To convert from a relative scale to map units per pixel:
1. If the scale is in meters. To calculate the number of meters per pixel, take the relative scale and multiply by 0.000265. For example, if the relative scale is 1:24000, then the number of meters per pixel is 24000 * 0.000265, or 6.36 meters.
2. If the scale is in feet. Do the calculation for meters (#1). Multiply the result by 3.28 (the number of feet in a meter). For example, if the number of meters per pixel is 6.36, the number of feet is 6.36 * 3.28, or 20.86 feet.
3. If the scale is in decimal degrees. For these calculations, the earth is assumed to be an exact circle with a circumference of 40030.174 km. One degree is 111.195 km (40030.174/360 degrees), or 111195 meters. To calculate the number of degrees, first do the calculation for meters (#1). Next, divide the result by 111195. For example, if the number of meters per pixel is 6.36, the number of degrees is 6.36 / 111195, or 0.0000571968.
For more information on using renderers, see Using ArcXML Renderers.

Attribute Descriptions for SCALEDEPENDENTRENDERER:

Attribute	Usage	Back to Top
lower	Minimum scale to display renderer using a relative scale such as 1:24000. Scale can also be calculated as the number of map units per pixel.
upper	Maximum scale to display renderer using a relative scale such as 1:24000. Scale can also be calculated as the number of map units per pixel.

Examples for SCALEDEPENDENTRENDERER:

Example 1: Changing road symbology at a scale of 1:20000000.

Back to Top

Example 2: Using VALUEMAPRENDERER and VALUEMAPLABELRENDERER inside a SCALEDEPENDENTRENDERER.

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="-74.066" miny="40.689" maxx="-73.823" maxy="40.883" name="Initial_Extent" />
      <MAPUNITS units="decimal_degrees" />
      </PROPERTIES>
      <WORKSPACES>
        <SHAPEWORKSPACE name="shp_ws-0" directory="path to data" />
      </WORKSPACES>
      <LAYER type="featureclass" name="Roads" visible="true" id="4" maxscale="1:35000">
        <DATASET name="nyc_roads" type="line" workspace="shp_ws-0" />
        <GROUPRENDERER>
          <SCALEDEPENDENTRENDERER lower="1:21300" >
            <VALUEMAPRENDERER lookupfield="ROAD_TYPE">
              <EXACT value="Freeway">
                <SIMPLELINESYMBOL type="solid" width="3" color="255,0,0" />
              </EXACT>
              <EXACT value="Street">
                <SIMPLELINESYMBOL type="solid" width="1" color="0,0,255" />
              </EXACT>
              <OTHER>
                <SIMPLELINESYMBOL type="solid" width="1" color="0,255,0" />
              </OTHER>
            </VALUEMAPRENDERER>
          </SCALEDEPENDENTRENDERER>
          <SCALEDEPENDENTRENDERER upper="1:21300">
            <GROUPRENDERER>
              <VALUEMAPRENDERER lookupfield="ROAD_TYPE">
                <EXACT value="Freeway">
                  <SIMPLELINESYMBOL type="solid" width="9" color="0,0,0" />
                </EXACT>
                <EXACT value="Street">
                  <SIMPLELINESYMBOL type="solid" width="8" color="255,255,255" />
                </EXACT>
                <OTHER>
                  <SIMPLELINESYMBOL type="solid" width="1" color="0,0,255" />
                </OTHER>
              </VALUEMAPRENDERER>
              <VALUEMAPRENDERER lookupfield="ROAD_TYPE">
                <EXACT value="Freeway">
                  <SIMPLELINESYMBOL type="solid" width="7" color="255,0,0" />
                </EXACT>
              </VALUEMAPRENDERER>
              <VALUEMAPRENDERER lookupfield="ROAD_TYPE">
                <EXACT value="Freeway">
                  <SIMPLELINESYMBOL type="solid" width="3" color="0,0,0" />
                </EXACT>
              </VALUEMAPRENDERER>
              <VALUEMAPRENDERER lookupfield="ROAD_TYPE">
                <EXACT value="Freeway">
                  <SIMPLELINESYMBOL type="solid" width="1" color="255,255,255" />
                </EXACT>
              </VALUEMAPRENDERER>
            </GROUPRENDERER>
          </SCALEDEPENDENTRENDERER>
          <SCALEDEPENDENTRENDERER upper="1:25000">
            <VALUEMAPLABELRENDERER lookupfield="ROAD_TYPE" labelfield="NAME" linelabelposition="PlaceOnTop" howmanylabels="One_label_per_name">
              <EXACT value="Freeway">
                <TEXTSYMBOL font="Arial" fontsize="14" fontstyle="bold" fontcolor="0,0,255" glowing="153,153,153"/>
              </EXACT>
              <EXACT value="Street">
                <TEXTSYMBOL font="Arial" fontsize="14" fontstyle="bold" fontcolor="0,0,0" />
              </EXACT>
              <OTHER>
                <TEXTSYMBOL font="Arial" fontsize="14" fontstyle="regular" fontcolor="0,0,255" />
              </OTHER>
            </VALUEMAPLABELRENDERER>
          </SCALEDEPENDENTRENDERER>
        </GROUPRENDERER>
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>