IMAGEPROPERTIES

IMAGEPROPERTIES

Used in: CONFIG   REQUEST
Servers: Image
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:

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.
Valid with Image Server only.

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	Back to Top
transcolor	1 Transparency color using RGB values. White is 255,255,255.
transparency	2 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>