RASTER_RANGE

RASTER_RANGE

Used in: CONFIG
Parent elements: RASTER_RENDERER

<RASTER_RANGE	Attribute Description Table
*lower ="double"* *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 >
Bold: 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.
A value cannot be duplicated in a raster renderer. If a duplicate is detected, an error message is returned.
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	Back to Top
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.

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" />
    </ENVIRONMENT>
    <MAP>
      <PROPERTIES>
        <ENVELOPE minx="0" miny="0" maxx="256" maxy="256" name="Initial_Extent" />
        <MAPUNITS units="decimal_degrees" />
      </PROPERTIES>
      <WORKSPACES>
        <SDEWORKSPACE name="sde_ws-0"  server="myserver" instance="port:5151" database="" user="WASHOE" encrypted="true" password="LXEMUR" />
      </WORKSPACES>
      <LAYER type="image" name="Land Use" visible="true" id="0">
        <DATASET name="WASHOE.BIT8_COLORMAP.IMAGE" 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>