RASTER_RANGE

Used in

Servers

Image

Parent elements

Syntax

<RASTER_RANGE	Attribute Description Table
*(r)lower="double"* *(r)upper="double"* color="0,0,0 - 255,255,255" [0,0,0] equality="all \| upper \| lower \| none" [lower] label="string" [Value of lower or upper] transparency="0.0 - 1.0" [1.0] > No Child Elements </RASTER_RANGE >
(r): Attribute or child element is required.

Description

Defines description and color for a range of pixel values.

Restrictions

RASTER_RANGE can be used in map configuration files only and is not available from the ArcIMS Author interface.
Raster renderering is available in all viewers. However, labels in the legend are valid only in HTML Viewers.
Valid only with layers that specify a single image. Not valid with an image directory or image catalog.
Valid with Image Server only.

Notes

Three methods are available to define colors in an image.
- ArcSDE colormap or CLR file, which pairs a value and a color. The value is included in the legend. Supported formats are ArcSDE raster, GRID, BIL, and BSQ.
- Table in ArcSDE that pairs a value with a color and description. The description is included in the legend. If no description is available, the value is used instead. If a table is used, the colormap is ignored.
- The RASTER_RENDERER elements. If these elements are used, any colormaps or ArcSDE tables are ignored.
The attribute equality defines the upper and lower bounds of each range. If "all" is used, then lower <= value <= upper. If "upper" is used, lower < value <= upper. If "lower" is used, lower <= value < upper. When using the upper attribute, the uppermost value is included in the range only if equality is set to "upper" or "all". Similarly, when using the lower attribute, the lowermost value is included in the range only if equlity is set to "lower" or "all".

Attribute Descriptions for RASTER_RANGE

Attribute	Usage
color	Color using RGB values. Defines the color corresponding to the specified range of index values.
equality	Defines the upper and lower bounds of each range. If "all" is used, then lower <= value <= upper. If "upper" is used, lower < value <= upper. If "lower" is used, lower <= value < upper.
label	Description to be shown on legend. Valid with HTML Viewers only.
lower	Defines the lower value of the range.
transparency	Value to set percentage of transparency. 1.0 is 0 percent transparent. 0.0 is 100 percent transparent.
upper	Defines the upper value of the range.

Examples for RASTER_RANGE

Example 1: When in a map configuration file.

<?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" />
    </ENVIRONMENT>
    <MAP>
      <PROPERTIES>
        <ENVELOPE minx="-90" miny="-180" maxx="90" maxy="180" name="Initial_Extent" />
        <MAPUNITS units="decimal_degrees" />
        <FILTERCOORDSYS id="4326" />
        <FEATURECOORDSYS id="4326"/>
      </PROPERTIES>
      <WORKSPACES>
        <SDEWORKSPACE name="sde_ws-0"  server="myserver" instance="port:5151" database="" user="sdeuser" encrypted="true" password="LXEMUR" />
      </WORKSPACES>
      <LAYER type="image" name="Land Use" visible="true" id="0">
        <DATASET name="SDEUSER.BIT8_COLORMAP.RASTER" workspace="sde_ws-0" />
        <RASTER_RENDERER>
          <RASTER_EXACT value="0" color="10,200,10" transparency="0.5"  label="Clouds"/>
          <RASTER_RANGE lower="1" upper="101" color="200,40,10" transparency="0.5"  equality="lower" label="Urban"/>
          <RASTER_RANGE transparency="1.0" lower="101" upper="255" color="255,255,10" equality="lower" label="Rural"/>
          <RASTER_OTHER transparency="0.0" label="Other"/>
        </RASTER_RENDERER>
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>

Example 2: When in a SERVICEINFO response.

<?xml version="1.0" encoding="UTF-8"?>
<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=";"/>
        <CAPABILITIES forbidden="" disabledtypes=""/>
        <SCREEN dpi="96"/>
        <IMAGELIMIT pixelcount="1048576" />
      </ENVIRONMENT>
      <PROPERTIES>
        <FEATURECOORDSYS id="26717" />
        <FILTERCOORDSYS id="26717" />
        <ENVELOPE minx="192757" miny="3768666" maxx="197877" maxy="3773786" name="Initial_Extent" />
        <MAPUNITS units="meters" />
        <IMAGEGENERALIZATION mode="1" />
      </PROPERTIES>
      <LAYERINFO type="image" name="Atlanta" visible="true" id="0">
        <RASTER_RENDERER>
          <RASTER_RANGE lower="17" upper="50" color="255,0,0" transparency="0.3" label="17 to 50" equality="all" />
          <RASTER_RANGE lower="50" upper="100" color="0,255,0" transparency="0.3" label="50 to 100" equality="lower" />
          <RASTER_EXACT value="161" color="225,0,255" transparency="0.5" label="161" />
          <RASTER_OTHER color="0,0,0" transparency="0.3" label="Out of range" />
        </RASTER_RENDERER>
      </LAYERINFO>
    </SERVICEINFO>
  </RESPONSE>
</ARCXML>