IMAGEPROPERTIES

IMAGEPROPERTIES

Used in: CONFIG REQUEST
Parent elements: LAYER

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

Description:

In a map configuration file, sets the opaqueness of an image layer such as a TIFF image. It also can be used to set a color as transparent.
In a viewer configuration file, sets the opaqueness of an Image MapService or an image layer.

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:

The attribute transcolor can be a different color than the transparent color used for BACKGROUND.
When transparency is set on an Image MapService 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	Back to Top
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.

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" />
      <SCREEN dpi="96" />
    </ENVIRONMENT>
    <MAP>
      <PROPERTIES>
        <ENVELOPE minx="477075.998116" miny="3761051.655341" maxx="495210.599161" maxy="3773575.12005" name="Initial_Extent" />
        <MAPUNITS units="decimal_degrees" />
        <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.

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" />
      <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>