IMAGEWORKSPACE

Used in

Servers

Image Query Feature

Parent elements

Syntax

<IMAGEWORKSPACE	Attribute Description Table
*(r)directory="string"* *(r)name="string"* > No Child Elements </IMAGEWORKSPACE >
(r): Attribute or child element is required.

Description

Specifies a workspace for raster files.

Restrictions

Must refer to an existing data source.
Not valid with ArcMap Server.

Notes

Valid in both viewer configuration files and map configuration files.

The directory specified for IMAGEWORKSPACE varies depending on how rasters are accessed.

Raster Access Method	IMAGEWORKSPACE Location	DATASET Layer Name
Specify by name.	Attribute directory points to location of specified raster.	Name of raster including its extension.
Use all rasters in a directory. Rasters in the same directory automatically tile if they use the same coordinate projection and are drawn when they are within the extent requested.	Attribute directory points to location of the group of rasters.	Use ImageDirectory for the name: name="ImageDirectory"
Use an ArcView GIS image catalog.	Attribute directory points to location of catalog, not rasters.	Name of the image catalog DBF file. For instance, if catalog is named imagecat.dbf, use name="imagecat.dbf".
Add a GRID.	A GRID has two directories: one for the GRID data and one for the INFO files. Both these directories should be grouped together under a parent directory. The directory attribute points to the parent directory above the INFO and GRID directories. A *.clr file can be included to color the GRID. This file should have the same name as the GRID and be included in the parent directory above the INFO and GRID directories.	Name of directory that contains GRID data; for a GRID named WorldImage, use name="WorldImage".

For a listing of supported images, see Using ArcIMS.

Attribute Descriptions for IMAGEWORKSPACE

Attribute	Usage
directory	Directory containing rasters or image catalog. UNC pathnames can be used (\\myComputer\imagedirectory). See Notes section for more information.
name	Workspace name. Must be unique among all data sources.

Examples for IMAGEWORKSPACE

Example 1: When specifying one raster by name.

<?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="192837" miny="3769109" maxx="197809" maxy="3773771" name="Initial_Extent" />
       <MAPUNITS units="meters" />
      <FILTERCOORDSYS id="54030" />
      <FEATURECOORDSYS id="54030"/>
      </PROPERTIES>
      <WORKSPACES>
      <IMAGEWORKSPACE directory="<path to data>" name="jai_ws-0" />
      </WORKSPACES>
      <LAYER type="image" name="reno.sid" visible="true" id="0">
      <DATASET name="reno.sid" type="image" workspace="jai_ws-0" />
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>

Example 2: When specifying multiple rasters in a directory.

<?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="-2006008" miny="-1240677" maxx="-1993628" maxy="-1256187" name="Initial_Extent" />
       <MAPUNITS units="meters" />
      <FILTERCOORDSYS id="54030" />
      <FEATURECOORDSYS id="54030"/>
      </PROPERTIES>
      <WORKSPACES>
      <IMAGEWORKSPACE directory="<path to data>" name="jai_ws-0" />
      </WORKSPACES>
      <LAYER type="image" name="Sierra" visible="false" id="0">
      <DATASET name="*ImageDirectory" type="image" workspace="jai_ws-0" />
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>

Example 3: When specifying an image catalog.

<?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="-2006008" miny="-1240677" maxx="-1993628" maxy="-1256187" name="Initial_Extent" />
       <MAPUNITS units="meters" />
      <FILTERCOORDSYS id="54030" />
      <FEATURECOORDSYS id="54030"/>
      </PROPERTIES>
      <WORKSPACES>
       <IMAGEWORKSPACE name="jai_ws-15" directory="<path to image catalog dbf file>"/>
      </WORKSPACES>
      <LAYER type="image" name="mammoth.dbf" visible="true" id="0">
       <DATASET name="mammoth.dbf" type="image" workspace="jai_ws-15" />
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>

Example 4: When specifying a GRID.

<?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="-2006008" miny="-1240677" maxx="-1993628" maxy="-1256187" name="Initial_Extent" />
       <MAPUNITS units="meters" />
      <FILTERCOORDSYS id="54030" />
      <FEATURECOORDSYS id="54030"/>
      </PROPERTIES>
      <WORKSPACES>
       <IMAGEWORKSPACE directory="<path to directory above INFO directory>" name="jai_ws-15" />
      </WORKSPACES>
      <LAYER type="image" name="Mt St. Helens" visible="true" id="0">
       <DATASET name="helens" type="image" workspace="jai_ws-15" />
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>