BACKGROUND

Used in

CONFIG  REQUEST  

Servers

Image  ArcMap  

Parent elements

PROPERTIES 

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 or ArcMap 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.

Back to top 

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>

Back to top