<?xml version="1.0" encoding='ISO-8859-1'?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" 
  "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
  <!ENTITY % cartoweb SYSTEM "../../cartoweb.ent" >
  %cartoweb;
  ]>
<sect2 id="dev.soapcalls.getmap.images">
  <title>Images</title>
  <para> The Images plugin generates MapServer images. The three types of 
    images are main map, key map and scale bar. Basic parameters, such as image 
    size, are defined in this request/result. More specific parameters, such as 
    map location or content, are defined in other plugins. </para>
  <sect3 id="dev.soapcalls.getmap.images.request">
    <title>Images Request</title>
    <para>
      <programlisting><![CDATA[
<complexType name="Image">
  <all>
    <element name="isDrawn" type="xsd:boolean"/>
    <element name="path" type="xsd:string"/>
    <element name="width" type="xsd:int"/>
    <element name="height" type="xsd:int"/>
  </all>
</complexType>]]></programlisting>
      <itemizedlist>
        <listitem>
          <para>isDrawn - true if the image should be generated (when used in a 
            request) or if it was generated (when returned in a result)</para>
        </listitem>
        <listitem>
          <para>path - relative path of generated image. Not used in 
            request</para>
        </listitem>
        <listitem>
          <para>width - image width</para>
        </listitem>
        <listitem>
          <para>height - image height</para>
        </listitem>
      </itemizedlist>
      <programlisting><![CDATA[
<complexType name="ImagesRequest">
  <all>
    <element name="className" type="xsd:string"/>
    <element name="mainmap" type="types:Image"/>
    <element name="keymap" type="types:Image"/>
    <element name="scalebar" type="types:Image"/>
  </all>
</complexType>]]></programlisting>
      <itemizedlist>
        <listitem>
          <para>className - "ImagesRequest" or extended class name if project 
            implements an extension</para>
        </listitem>
        <listitem>
          <para>mainmap - main map image information</para>
        </listitem>
        <listitem>
          <para>keymap - key map image information</para>
        </listitem>
        <listitem>
          <para>scalebar - scale bar image information</para>
        </listitem>
      </itemizedlist>
    </para>
  </sect3>
  <sect3 id="dev.soapcalls.getmap.images.result">
    <title>Images Result</title>
    <para>
      <programlisting><![CDATA[
<complexType name="ImagesResult">
  <all>
    <element name="className" type="xsd:string"/>
    <element name="mainmap" type="types:Image"/>
    <element name="keymap" type="types:Image"/>
    <element name="scalebar" type="types:Image"/>
  </all>
</complexType>]]></programlisting>
      <itemizedlist>
        <listitem>
          <para>className - "ImagesResult" or extended class name if project 
            implements an extension</para>
        </listitem>
        <listitem>
          <para>mainmap - main map image information (see <xref 
            linkend="dev.soapcalls.getmap.images.request" /> for a description 
            of type Image)</para>
        </listitem>
        <listitem>
          <para>keymap - key map image information</para>
        </listitem>
        <listitem>
          <para>scalebar - scale bar image information</para>
        </listitem>
      </itemizedlist>
    </para>
  </sect3>
</sect2>