BACKGROUND

Used in

Servers

Image

Parent elements

Syntax

<BACKGROUND	Attribute Description Table
(r)color="0,0,0 - 255,255,255" transcolor="0,0,0 - 255,255,255" > No Child Elements </BACKGROUND >
(r): Attribute or child element is required.

Description

Defines color of map's background.

Restrictions

When using transcolor, depending on the browser, the image formats that support transparent colors vary. JPG images do not support transparent colors. The table below lists which image formats support transparent colors for different browsers.

Browser	Supported Transparent Image Formats
ArcIMS HTML Viewer in Internet Explorer 5.5 or higher	PNG8, GIF
ArcIMS HTML Viewer in Netscape 6.2 or higher	PNG8, PNG24, GIF
ArcExplorer-Java Edition	PNG8, PNG24, GIF
ArcIMS Java Viewers in Internet Explorer and Netscape	PNG8, PNG24, GIF

Notes

In order to set the background of an Image Service as transparent, color and transcolor should be set to the same value. White is "255,255,255".

Attribute Descriptions for BACKGROUND

Attribute	Usage
color	Background color for map using RGB values.
transcolor	Transparent color in output image using RGB values. Only supported for GIF and PNG output formats.

Examples for BACKGROUND

Example 1: Included in the PROPERTIES section for both CONFIG and REQUEST.

<?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.21" miny="18.92" maxx="-66.96" maxy="71.41" name="Initial_Extent" />
        <MAPUNITS units="decimal_degrees" />
        <FILTERCOORDSYS id="4326" />
        <FEATURECOORDSYS id="4326"/>
        <BACKGROUND color="255,255,255" transcolor="255,255,255"/>
      </PROPERTIES>
      <WORKSPACES>
        <SHAPEWORKSPACE name="shp_ws-0" directory="<path to USA ESRIDATA>"/>
      </WORKSPACES>
      <LAYER type="featureclass" name="CITIES" visible="true" id="2">
      <DATASET name="CITIES" type="point" workspace="shp_ws-0" />
      <SIMPLERENDERER>
        <SIMPLEMARKERSYMBOL type="square" width="5" />
      </SIMPLERENDERER>
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>