ArcObjects Library Reference (Carto)  

IImageType.Format Property

The image format.

[Visual Basic .NET]
Public Property Format As esriImageFormat
[C#]
public esriImageFormat Format {get; set;}
[C++]
HRESULT get_Format(
  esriImageFormat* ImageFormat
);
[C++]
HRESULT put_Format(
  esriImageFormat ImageFormat
);
[C++]

Parameters

ImageFormat [out, retval]

  ImageFormat is a parameter of type esriImageFormat

ImageFormat [in]

  ImageFormat is a parameter of type esriImageFormat

Product Availability

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

Remarks

Supported image formats include: BMP, JPG, DIB, TIFF, PNG, PNG24, EMF, PS, PDF, AI, GIF,  SVG and SVGZ.  When a PNG24 image is requested from MapServer and in the same request specifies a transparent color, a 32-bit PNG is returned in order to support the transparency.  The transparency is within the alpha channel and only supports only binary transparency.

Please note that optimized MapServices do not support the Adobe Illustrator (AI) format. However they additionally support the PNG32 image format with full alpha channel transparency support. PNG32 maintains transparency in the image that is set on the layer in the source map. To find out what image formats are supported by a map service, use the IMapServer2::ServiceConfigurationInfo property. 

If SupportedImageFormatTypes is missing from ServiceConfigurationInfo, the MapService supports image formats mentioned in the first line.

The PNG32 image format is only supported by the  ExportMapImage function on an optimized MapService. In order to maintain backward compatibility, the PNG32 format is not explicitly included in the esriImageFormat enum.  To request the PNG32 format, cast the value 13 to type esriImageFormat in code section below.

Any export function, for both standard and optimized MapServer, that does not support PNG32 returns PNG24 when asked for this image type.

[C#] IImageType pImgType = new ImageType();
pImgType.Format = (esriImageFormat)13;

See Also

IImageType Interface

.NET Related Topics

Managing application state | Map services |