<html>
<head>
<title>Image maps</title>
<meta name="keywords" content="">
</head>

<body bgcolor=#113377 text=#000000 vlink=#551a8b alink=#00c0ff link=#0000ee>




















































<table width=100% border=0>
<tr>
  <td valign=top>
  <table width=100% cellpadding=5 cellspacing=0 border=0>
    <tr><td bgcolor="#ffffff" align=center>
       <img height=40 src="../../img/logga.gif" border=0 alt="" width=102>
    </td></tr>
    <tr><td valign=top>
      <img src=internal-roxen-unit width=1 height=3 alt="">
    </td></tr>
    <tr valign=top>
      <td bgcolor="#ffffff">




        <table cellpadding=0 cellspacing=0 border=0>
          
       <!--a1  Introduction manual.tmpl-->
    
            <tr><td><a href="../introduction/index.html"><img border=0 src="../../img/chapter.gif"></a>&nbsp;</td>
	      <td><a href="../introduction/index.html">Introduction</a></td>
	    </tr>
    
          
       <!--a1  Publishing web pages manual.tmpl-->
    
            <tr><td><a href="../publishing/index.html"><img src="../../img/chapter.gif" border=0></a>&nbsp;</td>
	      <td><a href="../publishing/index.html">Publishing web pages</a></td>
	    </tr>
    
          
       <!--a1  RXML manual.tmpl-->
    
            <tr><td><a href="../rxml/index.html"><img src="../../img/chapter.gif" border=0></a>&nbsp;</td>
	      <td><a href="../rxml/index.html">RXML</a></td>
	    </tr>
    
          
       <!--a1  Information tags manual.tmpl-->
    
            <tr><td><a href="../information/index.html"><img border=0 src="../../img/chapter.gif"></a>&nbsp;</td>
	      <td><a href="../information/index.html">Information tags</a></td>
	    </tr>
    
          
       <!--a1  String tags manual.tmpl-->
    
            <tr><td><a href="../string/index.html"><img src="../../img/chapter.gif" border=0></a>&nbsp;</td>
	      <td><a href="../string/index.html">String tags</a></td>
	    </tr>
    
          
       <!--a1  Variable tags manual.tmpl-->
    
            <tr><td><a href="../variable/index.html"><img src="../../img/chapter.gif" border=0></a>&nbsp;</td>
	      <td><a href="../variable/index.html">Variable tags</a></td>
	    </tr>
    
          
       <!--a1  URL tags manual.tmpl-->
    
            <tr><td><a href="../url/index.html"><img border=0 src="../../img/chapter.gif"></a>&nbsp;</td>
	      <td><a href="../url/index.html">URL tags</a></td>
	    </tr>
    
          
       <!--a1  If tags manual.tmpl-->
    
            <tr><td><a href="../if/index.html"><img src="../../img/chapter.gif" border=0></a>&nbsp;</td>
	      <td><a href="../if/index.html">If tags</a></td>
	    </tr>
    
          
       <!--a1  Graphics tags manual.tmpl-->
    
            <tr><td><a href="../graphics/index.html"><img src="../../img/chapter.gif" border=0></a>&nbsp;</td>
	      <td><a href="../graphics/index.html">Graphics tags</a></td>
	    </tr>
    
          
       <!--a1  Database tags manual.tmpl-->
    
            <tr><td><a href="../database/index.html"><img border=0 src="../../img/chapter.gif"></a>&nbsp;</td>
	      <td><a href="../database/index.html">Database tags</a></td>
	    </tr>
    
          
       <!--a1  LDAP manual.tmpl-->
    
            <tr><td><a href="../ldap/index.html"><img src="../../img/chapter.gif" border=0></a>&nbsp;</td>
	      <td><a href="../ldap/index.html">LDAP</a></td>
	    </tr>
    
          
       <!--a1  Programming tags manual.tmpl-->
    
            <tr><td><a href="../programming/index.html"><img src="../../img/chapter.gif" border=0></a>&nbsp;</td>
	      <td><a href="../programming/index.html">Programming tags</a></td>
	    </tr>
    
          
       <!--a1  SSI tags manual.tmpl-->
    
            <tr><td><a href="../ssi/index.html"><img border=0 src="../../img/chapter.gif"></a>&nbsp;</td>
	      <td><a href="../ssi/index.html">SSI tags</a></td>
	    </tr>
    
          
       <!--a1  Image maps manual.tmpl-->
    
            <tr><td><a href="index.html"><img src="../../img/chapter.gif" border=0></a>&nbsp;</td>
	      <td><a href="index.html"><b>Image maps</b></a></td>
	    </tr>
    
          
	</table>
	
        <table cellpadding=0 cellspacing=0 border=0>
	  
        </table>

        <table cellpadding=0 cellspacing=0 border=0>
          
      <!--c1 intraseek -->
    
      <!--c2 intraseek -->
           
    
          
      <!--c1 logview -->
    
      <!--c2 logview -->
           
    
          
      <!--c1 platform -->
    
      <!--c2 platform -->
           
    
          
      <!--c1 platform -->
    
      <!--c2 platform -->
           
    
          
      <!--c1 platform -->
    
      <!--c2 platform -->
           
    
          
      <!--c1  -->
    
            <tr><td><a href="../supports/index.html"><img src="../../img/chapter.gif" border=0></a>&nbsp;</td>
	      <td><a href="../supports/index.html">Supports system</a></td>
	    </tr>
    
          
      <!--c1  -->
    
            <tr><td><a href="../security/index.html"><img border=0 src="../../img/chapter.gif"></a>&nbsp;</td>
	      <td><a href="../security/index.html">Security</a></td>
	    </tr>
    
          
      <!--c1  -->
    
            <tr><td><a href="../appendix/index.html"><img border=0 src="../../img/chapter.gif"></a>&nbsp;</td>
	      <td><a href="../appendix/index.html">Appendix</a></td>
	    </tr>
    
          
	</table>

      </td>
    </tr>
    <tr><td height=100%>&nbsp;</td></tr>
  </table>
  </td>
  <td>
    <img src=internal-roxen-unit width=3 height=1 alt="">
  </td>

  <td valign=top>
    <table cellspacing=0 cellpadding=5 width=100% height=100% border=0>
    <tr>
      <td bgcolor="#ffffff">
       <b><font size=+2>Image maps</font></b>

	<p>Image maps are used for images where you can click on different parts
to go to different pages. Nowadays, this is usually handled in the
browser, by client-side image maps. But it is also possible to do this
in the server. This is done through <tt>.map</tt> files, where you
define which page the user should be brought to when clicking
somewhere on the image.

<p>The HTML code needed to use an image map is:

<pre><tt>&lt;a href=<i>file.map</i>&gt;
  &lt;img src=image.gif ismap&gt;
&lt;/a&gt;</tt></pre

<p>For server-side image maps to work the <i>ISMAP
image-maps</i> module must be enabled. The map file is a text
file where one clickable area is defined per line. The file will be
scanned one line at a time till a directive that includes the point
the user clicked is found. The possible directives are:

<dl>

<dt><b>(X1,Y1)-(X2,Y2) URL</b><dd>


<i>(X1, Y1)</i> are the coordinates
of the upper left corner of a rectangular area whose lower right
corner has the coordinates <i>(X2, Y2)</i>. Any point inside the
rectangle will take the user to the <i>URL</i>.

<p>
<dt><b>(X,Y),R URL</b><dd>


Any point inside the circle centered at
<i>(X,Y)</i> and with the radius <i>R</i> will take the user to the
<i>URL</i>.

<p>
<dt><b>(X,Y) URL</b><dd>


This specifies a single point and ties a
URL to it. If more than one point is specified in the file, the one
closest to the position on which the user clicks will be used.

<p>
<dt><b>ppm: path</b><dd>


Use the PPM file referred to by path. Each
color in that file may give a different URL.

<p>
<dt><b>pgm: path</b><dd>


As PPM, but the file is a grey scale file.

<p>
<dt><b>color:(r,g,b):URL</b><dd>


In all PPM files referenced, this
color will point to the <i>URL</i>. r,g and b are decimal integers
between 0 and 255 and the color defined is the combination of the red
(r), green (g) and blue (b) intensities. If the file searched is a
grey scale PGM file, the grey scale will be (r+g+b)/3.

<p>
<dt><b>color:(r,g,b)-(r,g,b):URL</b><dd>


All colors in the range
will point to <i>URL</i>. If the file searched is a PGM (grey scale)
picture, the grey scale will be (r+g+b)/3.

<p>
<dt><b>color:greyscale-greyscale:URL</b><dd>


All colors with an
intensity falling within the range will point to <i>URL</i>.

<p>
<dt><b>default:URL</b><dd>


The url <i>URL</i> will be returned if
nothing else matched. Don't forget to set it.

<p>
<dt><b>void:URL</b><dd>


The url <i>URL</i> will be returned if the
client doesn't support image maps or if the map file is accessed
without coordinates.
</dl>


      </td>
    </tr>
    </table>
  </td>
</tr>
<tr>
</table>
</body>
</html>
