com.esri.arcgis.carto
Interface IImageServer2

All Superinterfaces:

IImageServer, Serializable

All Known Subinterfaces:

IImageServer3, IImageServer4

All Known Implementing Classes:

ImageServer, ImageServerIP, ImageServerLP

public interface IImageServer2
extends IImageServer, Serializable

Provides access to members that control an image server.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Method Summary

IMapImage

exportMapImage(IGeoImageDescription pImageDescription, IImageType pImageType) Exports into a well-known image with a correct aspect ratio for a given image description.

Methods inherited from interface com.esri.arcgis.carto.IImageServer

exportImage, getImage, getServiceInfo, getVersion

Method Detail

exportMapImage

IMapImage exportMapImage(IGeoImageDescription pImageDescription,
                         IImageType pImageType)
                         throws IOException,
                                AutomationException

Exports into a well-known image with a correct aspect ratio for a given image description.

Description

Exports an image to a supported format including JPEG, PNG, BMP, and TIFF, scales the image into a square pixel size, and returns both the image data and the adjusted image extent for a given image description. Comparing to ExportImage, ExportMapImage exports a MapImage which contains information defined in ImageResult plus image extent and map scale.

Remarks

If the size of the image exceeds the limit defined in the image service
configuration, this method will return an error.

If the pixel type defined in ImageDescription is different from the pixel type of
the image service, the pixel values will be converted according to the specified
pixel type if possible. Otherwise, an error will be returned at 9.3.

New at 10, if the image service pixel type cannot be converted to the requested pixel type, a default raster renderer will be applied. A proper default renderer is created using the same rule as when a raster dataset of the same properties, e.g. number of band, pixel type, and etc is added to map.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Parameters:

pImageDescription - A reference to a com.esri.arcgis.carto.IGeoImageDescription (in)

pImageType - A reference to a com.esri.arcgis.carto.IImageType (in)

Returns:

A reference to a com.esri.arcgis.carto.IMapImage

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.