RASTER_RENDERER

Used in

Servers

Image

Parent elements

Syntax

<RASTER_RENDERER > No Attributes (m)<RASTER_EXACT... /> <RASTER_OTHER... /> (m)<RASTER_RANGE... /> </RASTER_RENDERER >
(m): Child element can be used multiple times.

Description

Renders images by classifying pixel values.

Restrictions

Supported image formats for using RASTER_RENDERER are: ArcSDE Raster, BIL, BMP, BSQ, CIB, GIF, GIS, GRID, IMG, JPEG, LAN, GEOTIFF, TIFF, and IMPELL only. Only single band images are supported with RASTER_RENDERER. Multiband images are not supported.
RASTER_RENDERER 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.

Examples for RASTER_RENDERER

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>