IMAGEPROPERTIES

Used in

Servers

Image

Parent elements

Syntax

<IMAGEPROPERTIES	Attribute Description Table
transcolor="0,0,0 - 255,255,255" transparency="0.0 - 1.0" [1.0] > No Child Elements </IMAGEPROPERTIES >

Description

Sets the opaqueness of a raster layer such as a TIFF image or sets a color as transparent.

Restrictions

In map configuration files, either transcolor or transparency must be present. It is also acceptable to have both attributes present. In viewer configuration files, only transparency is used.

Notes

In map configuration files, transparency is applied to the entire image and transcolor is 100 percent transparent. The attribute transcolor can be a different color than the transparent color used for BACKGROUND.
When transparency is set on an Image Service layer in a viewer configuration file, the transparency is set for the entire layer, not for the individual sublayers.

Attribute Descriptions for IMAGEPROPERTIES

Attribute	Usage
transcolor	Transparency color using RGB values. White is 255,255,255.
transparency	Value to set percentage of transparency. 1.0 is 0 percent transparent. 0.0 is 100 percent transparent.

Examples for IMAGEPROPERTIES

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" />
      <SCREEN dpi="96" />
    </ENVIRONMENT>
    <MAP>
      <PROPERTIES>
        <ENVELOPE minx="477075.998116" miny="3761051.655341" maxx="495210.599161" maxy="3773575.12005" name="Initial_Extent" />
        <MAPUNITS units="meters" />
        <FILTERCOORDSYS id="54030" />
        <FEATURECOORDSYS id="54030"/>
        <BACKGROUND transcolor="255,255,255" color="255,255,255" />
      </PROPERTIES>
      <WORKSPACES>
        <IMAGEWORKSPACE directory="F:\Data\Redlands1" name="jai_ws-0" />
      </WORKSPACES>
      <LAYER type="image" name="redlands.sid" visible="true" id="0">
      <DATASET name="redlands.sid" type="image" workspace="jai_ws-0" />
      <IMAGEPROPERTIES transparency="0.5" transcolor="255,255,255" />
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>

Example 2: When in a viewer 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" />
      <SCREEN dpi="96" />
    </ENVIRONMENT>
    <MAP>
      <PROPERTIES>
      <ENVELOPE minx="-74.07187110438655" miny="40.6899519190673" maxx="-73.81759897554464" maxy="40.883113267364" name="Initial_Extent" />
      <MAPUNITS units="decimal_degrees" />
      </PROPERTIES>
      <WORKSPACES>
      <IMAGESERVERWORKSPACE name="mapper_ws-0" url="http://mycomputer.domain.com/servlet/com.esri.esrimap.Esrimap" service="nyc" />
      </WORKSPACES>
      <LAYER type="image" name="nyc" visible="true" id="0">
      <DATASET name="nyc" type="image" workspace="mapper_ws-0" />
      <IMAGEPROPERTIES transparency="0.5" />
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>