Home » Archimedes archive » Acorn User » AU 1997-Xmas B.adf » PD » NetPlex/!Netplex/!Help/HTML/14-image

NetPlex/!Netplex/!Help/HTML/14-image

This website contains an archive of files for the Acorn Electron, BBC Micro, Acorn Archimedes, Commodore 16 and Commodore 64 computers, which Dominic Ford has rescued from his private collection of floppy disks and cassettes.

Some of these files were originally commercial releases in the 1980s and 1990s, but they are now widely available online. I assume that copyright over them is no longer being asserted. If you own the copyright and would like files to be removed, please contact me.

Tape/disk: Home » Archimedes archive » Acorn User » AU 1997-Xmas B.adf » PD
Filename: NetPlex/!Netplex/!Help/HTML/14-image
Read OK:
File size: 1392 bytes
Load address: 0000
Exec address: 0000
File contents
<HTML>

<HEAD>
<TITLE>Netplex - Imagemaps</TITLE>
</HEAD>

<BODY TEXT="#000000" BGCOLOR="#ffffff" LINK="#004499" VLINK="#00224c" ALINK="#00cc00">


<H1><IMG SRC="images/world" ALIGN=ABSMIDDLE>  Imagemaps</H1>
<HR>

<A NAME="introduction"><H2>Introduction</H2></A>

<P>One of the nicer effects available on web pages is to be able to click on an embedded image and be redirected to a different web page depending on where you click.  This is achieved with a process called <I>Imagemapping</I>.</P>

<P>To use imagemapping the creator of a web page includes an image reference similar to the following in their document:</P>

<P><PRE>
&lt;A HREF="/cgi-bin/imagemap/example"&gt;
&lt;IMG SRC="images/netplex" ISMAP&gt;
&lt;/A&gt;
</PRE></P>

<P>You would initially expect that this would simply provide a link to an object called '/cgi-bin/imagemap/example'.  However, note the ISMAP directive, this tells the web browser that the specified image is an imagemap and when the user clicks on it, it should append the x and y coordinates of the <I>click-point</I> as a query string to the URL and then perform a GET request on the specified object.  So when the user clicks on the image, the browser requests a URL similar to this :</P>

<P><CENTER>/cgi-bin/imagemap/example?50,75</CENTER></P>

<P>As /cgi-bin/imagemap is a CGI program, when the client requests the above URL it will dynamically produce a response to the client, causing it to jump to a particular page depending on where the click-point was.</P>

<P>You may have noticed that the example URL is somewhat unusual, it points to a valid file '/cgi-bin/imagemap' but then has '/example' after it.  What it is actually doing is passing the string 'example' (no leading slash) as a parameter to the imagemap program.  This parameter specifies the <I>name</I> of the map that the server should look in to determine which page to jump to.</P>

<A NAME="setup"><H2>Setting Up Imagemaps</H2></A>

<P>Netplex implements imagemapping as a small CGI program (cgi-bin.imagemap) which will be invoked when someone clicks on an image after being set up as that outlined above.  The imagemap program reads the name passed to it, finds the associated map file, sees which URL the click-point refers to and then sends the client a relocate message so that it will automatically jump to the correct page.</P>

<A NAME="cfg-imagemaps"></A>
<P>Before using any imagemaps you must create a <A HREF="10-confi">Configuration file</A> which details the mapping between the name passed (e.g. 'example') and the actual filename of the map.  This Configuration file must be placed in the root web page directory and called 'Imagemaps'.  An example of this is :</P>

<P><PRE>
# Example Imagemap Configuration file
#
# The format is &lt;name of map&gt;:&lt;filename of map&gt;
#
Imagemaps
example:&lt;Netplex$WebPagesDir&gt;.imagemap.example
</PRE></P>

<P>So when the client asks for '/cgi-bin/imagemap/example', the name 'example' is looked up in this file and the imagemap program then uses the file &lt;Netplex$WebPagesDir&gt;.imagemap.example as the map.</P>

<P>The next file you must make is the map itself.  This is the actual file which details which parts of the image link to which URLs.  It takes the following form :</P>

<P><PRE>
# Image Map produced by Gerph's Imagen 1.44 (18 Oct 1996)
#
default http://localhost/imagemap/default
circle http://localhost/imagemap/world 35,37 57,64 
circle http://localhost/imagemap/world 297,83 319,110 
poly http://localhost/imagemap/text 56,112 276,113 277,131 221,132 221,148 113,147 112,134 57,133 
rect http://localhost/imagemap/np 24,18 301,98 
</PRE></P>

<P>Map files define, in terms of <I>circle</I>s, <I>rect</I>angles and <I>poly</I>gons, which areas in the image lead to other URLs.  Although you can create them by hand it's a better bet to get a copy of <A HREF="http://users.essex.ac.uk/users/jrflet/">Justin Fletcher's</A> excellent <I>Imagen</I> map editor which allows you to interactively create and edit map files.  Note that Netplex uses NCSA format map files (as opposed to CERN format maps).  The Netplex imagemapper will also accept URLs in relative-to-root form, e.g. '/imagemap/world'.</P>

<A NAME="example"><H2>Example</H2></A>

<P>You can try out the imagemapping support for yourself by copying the example Configuration file called 'Imagemaps' from the !Netplex.!Help.HTML.imagemap directory into the root web page directory.  After you have done this, clicking on different parts of the picture below will yeild an appropriate response from the imagemapper.</P>

<CENTER>
<A HREF="/cgi-bin/imagemap/example">
<IMG SRC="images/netplex" ISMAP>
</A>
</CENTER>

<HR>

<P><CENTER>
<A HREF="13-cgi"><IMG SRC="images/buttons/bak" WIDTH=32 HEIGHT=32 BORDER=0 ALT="[ Previous ]"></A>
<A HREF="index"><IMG SRC="images/buttons/up" WIDTH=32 HEIGHT=32 BORDER=0 ALT="[ Index ]"></A>
<A HREF="a0-perfo"><IMG SRC="images/buttons/fwd" WIDTH=32 HEIGHT=32 BORDER=0 ALT="[ Next ]"></A>
</CENTER></P>

</BODY>

</HTML>
00000000  3c 48 54 4d 4c 3e 0a 0a  3c 48 45 41 44 3e 0a 3c  |<HTML>..<HEAD>.<|
00000010  54 49 54 4c 45 3e 4e 65  74 70 6c 65 78 20 2d 20  |TITLE>Netplex - |
00000020  49 6d 61 67 65 6d 61 70  73 3c 2f 54 49 54 4c 45  |Imagemaps</TITLE|
00000030  3e 0a 3c 2f 48 45 41 44  3e 0a 0a 3c 42 4f 44 59  |>.</HEAD>..<BODY|
00000040  20 54 45 58 54 3d 22 23  30 30 30 30 30 30 22 20  | TEXT="#000000" |
00000050  42 47 43 4f 4c 4f 52 3d  22 23 66 66 66 66 66 66  |BGCOLOR="#ffffff|
00000060  22 20 4c 49 4e 4b 3d 22  23 30 30 34 34 39 39 22  |" LINK="#004499"|
00000070  20 56 4c 49 4e 4b 3d 22  23 30 30 32 32 34 63 22  | VLINK="#00224c"|
00000080  20 41 4c 49 4e 4b 3d 22  23 30 30 63 63 30 30 22  | ALINK="#00cc00"|
00000090  3e 0a 0a 0a 3c 48 31 3e  3c 49 4d 47 20 53 52 43  |>...<H1><IMG SRC|
000000a0  3d 22 69 6d 61 67 65 73  2f 77 6f 72 6c 64 22 20  |="images/world" |
000000b0  41 4c 49 47 4e 3d 41 42  53 4d 49 44 44 4c 45 3e  |ALIGN=ABSMIDDLE>|
000000c0  20 20 49 6d 61 67 65 6d  61 70 73 3c 2f 48 31 3e  |  Imagemaps</H1>|
000000d0  0a 3c 48 52 3e 0a 0a 3c  41 20 4e 41 4d 45 3d 22  |.<HR>..<A NAME="|
000000e0  69 6e 74 72 6f 64 75 63  74 69 6f 6e 22 3e 3c 48  |introduction"><H|
000000f0  32 3e 49 6e 74 72 6f 64  75 63 74 69 6f 6e 3c 2f  |2>Introduction</|
00000100  48 32 3e 3c 2f 41 3e 0a  0a 3c 50 3e 4f 6e 65 20  |H2></A>..<P>One |
00000110  6f 66 20 74 68 65 20 6e  69 63 65 72 20 65 66 66  |of the nicer eff|
00000120  65 63 74 73 20 61 76 61  69 6c 61 62 6c 65 20 6f  |ects available o|
00000130  6e 20 77 65 62 20 70 61  67 65 73 20 69 73 20 74  |n web pages is t|
00000140  6f 20 62 65 20 61 62 6c  65 20 74 6f 20 63 6c 69  |o be able to cli|
00000150  63 6b 20 6f 6e 20 61 6e  20 65 6d 62 65 64 64 65  |ck on an embedde|
00000160  64 20 69 6d 61 67 65 20  61 6e 64 20 62 65 20 72  |d image and be r|
00000170  65 64 69 72 65 63 74 65  64 20 74 6f 20 61 20 64  |edirected to a d|
00000180  69 66 66 65 72 65 6e 74  20 77 65 62 20 70 61 67  |ifferent web pag|
00000190  65 20 64 65 70 65 6e 64  69 6e 67 20 6f 6e 20 77  |e depending on w|
000001a0  68 65 72 65 20 79 6f 75  20 63 6c 69 63 6b 2e 20  |here you click. |
000001b0  20 54 68 69 73 20 69 73  20 61 63 68 69 65 76 65  | This is achieve|
000001c0  64 20 77 69 74 68 20 61  20 70 72 6f 63 65 73 73  |d with a process|
000001d0  20 63 61 6c 6c 65 64 20  3c 49 3e 49 6d 61 67 65  | called <I>Image|
000001e0  6d 61 70 70 69 6e 67 3c  2f 49 3e 2e 3c 2f 50 3e  |mapping</I>.</P>|
000001f0  0a 0a 3c 50 3e 54 6f 20  75 73 65 20 69 6d 61 67  |..<P>To use imag|
00000200  65 6d 61 70 70 69 6e 67  20 74 68 65 20 63 72 65  |emapping the cre|
00000210  61 74 6f 72 20 6f 66 20  61 20 77 65 62 20 70 61  |ator of a web pa|
00000220  67 65 20 69 6e 63 6c 75  64 65 73 20 61 6e 20 69  |ge includes an i|
00000230  6d 61 67 65 20 72 65 66  65 72 65 6e 63 65 20 73  |mage reference s|
00000240  69 6d 69 6c 61 72 20 74  6f 20 74 68 65 20 66 6f  |imilar to the fo|
00000250  6c 6c 6f 77 69 6e 67 20  69 6e 20 74 68 65 69 72  |llowing in their|
00000260  20 64 6f 63 75 6d 65 6e  74 3a 3c 2f 50 3e 0a 0a  | document:</P>..|
00000270  3c 50 3e 3c 50 52 45 3e  0a 26 6c 74 3b 41 20 48  |<P><PRE>.&lt;A H|
00000280  52 45 46 3d 22 2f 63 67  69 2d 62 69 6e 2f 69 6d  |REF="/cgi-bin/im|
00000290  61 67 65 6d 61 70 2f 65  78 61 6d 70 6c 65 22 26  |agemap/example"&|
000002a0  67 74 3b 0a 26 6c 74 3b  49 4d 47 20 53 52 43 3d  |gt;.&lt;IMG SRC=|
000002b0  22 69 6d 61 67 65 73 2f  6e 65 74 70 6c 65 78 22  |"images/netplex"|
000002c0  20 49 53 4d 41 50 26 67  74 3b 0a 26 6c 74 3b 2f  | ISMAP&gt;.&lt;/|
000002d0  41 26 67 74 3b 0a 3c 2f  50 52 45 3e 3c 2f 50 3e  |A&gt;.</PRE></P>|
000002e0  0a 0a 3c 50 3e 59 6f 75  20 77 6f 75 6c 64 20 69  |..<P>You would i|
000002f0  6e 69 74 69 61 6c 6c 79  20 65 78 70 65 63 74 20  |nitially expect |
00000300  74 68 61 74 20 74 68 69  73 20 77 6f 75 6c 64 20  |that this would |
00000310  73 69 6d 70 6c 79 20 70  72 6f 76 69 64 65 20 61  |simply provide a|
00000320  20 6c 69 6e 6b 20 74 6f  20 61 6e 20 6f 62 6a 65  | link to an obje|
00000330  63 74 20 63 61 6c 6c 65  64 20 27 2f 63 67 69 2d  |ct called '/cgi-|
00000340  62 69 6e 2f 69 6d 61 67  65 6d 61 70 2f 65 78 61  |bin/imagemap/exa|
00000350  6d 70 6c 65 27 2e 20 20  48 6f 77 65 76 65 72 2c  |mple'.  However,|
00000360  20 6e 6f 74 65 20 74 68  65 20 49 53 4d 41 50 20  | note the ISMAP |
00000370  64 69 72 65 63 74 69 76  65 2c 20 74 68 69 73 20  |directive, this |
00000380  74 65 6c 6c 73 20 74 68  65 20 77 65 62 20 62 72  |tells the web br|
00000390  6f 77 73 65 72 20 74 68  61 74 20 74 68 65 20 73  |owser that the s|
000003a0  70 65 63 69 66 69 65 64  20 69 6d 61 67 65 20 69  |pecified image i|
000003b0  73 20 61 6e 20 69 6d 61  67 65 6d 61 70 20 61 6e  |s an imagemap an|
000003c0  64 20 77 68 65 6e 20 74  68 65 20 75 73 65 72 20  |d when the user |
000003d0  63 6c 69 63 6b 73 20 6f  6e 20 69 74 2c 20 69 74  |clicks on it, it|
000003e0  20 73 68 6f 75 6c 64 20  61 70 70 65 6e 64 20 74  | should append t|
000003f0  68 65 20 78 20 61 6e 64  20 79 20 63 6f 6f 72 64  |he x and y coord|
00000400  69 6e 61 74 65 73 20 6f  66 20 74 68 65 20 3c 49  |inates of the <I|
00000410  3e 63 6c 69 63 6b 2d 70  6f 69 6e 74 3c 2f 49 3e  |>click-point</I>|
00000420  20 61 73 20 61 20 71 75  65 72 79 20 73 74 72 69  | as a query stri|
00000430  6e 67 20 74 6f 20 74 68  65 20 55 52 4c 20 61 6e  |ng to the URL an|
00000440  64 20 74 68 65 6e 20 70  65 72 66 6f 72 6d 20 61  |d then perform a|
00000450  20 47 45 54 20 72 65 71  75 65 73 74 20 6f 6e 20  | GET request on |
00000460  74 68 65 20 73 70 65 63  69 66 69 65 64 20 6f 62  |the specified ob|
00000470  6a 65 63 74 2e 20 20 53  6f 20 77 68 65 6e 20 74  |ject.  So when t|
00000480  68 65 20 75 73 65 72 20  63 6c 69 63 6b 73 20 6f  |he user clicks o|
00000490  6e 20 74 68 65 20 69 6d  61 67 65 2c 20 74 68 65  |n the image, the|
000004a0  20 62 72 6f 77 73 65 72  20 72 65 71 75 65 73 74  | browser request|
000004b0  73 20 61 20 55 52 4c 20  73 69 6d 69 6c 61 72 20  |s a URL similar |
000004c0  74 6f 20 74 68 69 73 20  3a 3c 2f 50 3e 0a 0a 3c  |to this :</P>..<|
000004d0  50 3e 3c 43 45 4e 54 45  52 3e 2f 63 67 69 2d 62  |P><CENTER>/cgi-b|
000004e0  69 6e 2f 69 6d 61 67 65  6d 61 70 2f 65 78 61 6d  |in/imagemap/exam|
000004f0  70 6c 65 3f 35 30 2c 37  35 3c 2f 43 45 4e 54 45  |ple?50,75</CENTE|
00000500  52 3e 3c 2f 50 3e 0a 0a  3c 50 3e 41 73 20 2f 63  |R></P>..<P>As /c|
00000510  67 69 2d 62 69 6e 2f 69  6d 61 67 65 6d 61 70 20  |gi-bin/imagemap |
00000520  69 73 20 61 20 43 47 49  20 70 72 6f 67 72 61 6d  |is a CGI program|
00000530  2c 20 77 68 65 6e 20 74  68 65 20 63 6c 69 65 6e  |, when the clien|
00000540  74 20 72 65 71 75 65 73  74 73 20 74 68 65 20 61  |t requests the a|
00000550  62 6f 76 65 20 55 52 4c  20 69 74 20 77 69 6c 6c  |bove URL it will|
00000560  20 64 79 6e 61 6d 69 63  61 6c 6c 79 20 70 72 6f  | dynamically pro|
00000570  64 75 63 65 20 61 20 72  65 73 70 6f 6e 73 65 20  |duce a response |
00000580  74 6f 20 74 68 65 20 63  6c 69 65 6e 74 2c 20 63  |to the client, c|
00000590  61 75 73 69 6e 67 20 69  74 20 74 6f 20 6a 75 6d  |ausing it to jum|
000005a0  70 20 74 6f 20 61 20 70  61 72 74 69 63 75 6c 61  |p to a particula|
000005b0  72 20 70 61 67 65 20 64  65 70 65 6e 64 69 6e 67  |r page depending|
000005c0  20 6f 6e 20 77 68 65 72  65 20 74 68 65 20 63 6c  | on where the cl|
000005d0  69 63 6b 2d 70 6f 69 6e  74 20 77 61 73 2e 3c 2f  |ick-point was.</|
000005e0  50 3e 0a 0a 3c 50 3e 59  6f 75 20 6d 61 79 20 68  |P>..<P>You may h|
000005f0  61 76 65 20 6e 6f 74 69  63 65 64 20 74 68 61 74  |ave noticed that|
00000600  20 74 68 65 20 65 78 61  6d 70 6c 65 20 55 52 4c  | the example URL|
00000610  20 69 73 20 73 6f 6d 65  77 68 61 74 20 75 6e 75  | is somewhat unu|
00000620  73 75 61 6c 2c 20 69 74  20 70 6f 69 6e 74 73 20  |sual, it points |
00000630  74 6f 20 61 20 76 61 6c  69 64 20 66 69 6c 65 20  |to a valid file |
00000640  27 2f 63 67 69 2d 62 69  6e 2f 69 6d 61 67 65 6d  |'/cgi-bin/imagem|
00000650  61 70 27 20 62 75 74 20  74 68 65 6e 20 68 61 73  |ap' but then has|
00000660  20 27 2f 65 78 61 6d 70  6c 65 27 20 61 66 74 65  | '/example' afte|
00000670  72 20 69 74 2e 20 20 57  68 61 74 20 69 74 20 69  |r it.  What it i|
00000680  73 20 61 63 74 75 61 6c  6c 79 20 64 6f 69 6e 67  |s actually doing|
00000690  20 69 73 20 70 61 73 73  69 6e 67 20 74 68 65 20  | is passing the |
000006a0  73 74 72 69 6e 67 20 27  65 78 61 6d 70 6c 65 27  |string 'example'|
000006b0  20 28 6e 6f 20 6c 65 61  64 69 6e 67 20 73 6c 61  | (no leading sla|
000006c0  73 68 29 20 61 73 20 61  20 70 61 72 61 6d 65 74  |sh) as a paramet|
000006d0  65 72 20 74 6f 20 74 68  65 20 69 6d 61 67 65 6d  |er to the imagem|
000006e0  61 70 20 70 72 6f 67 72  61 6d 2e 20 20 54 68 69  |ap program.  Thi|
000006f0  73 20 70 61 72 61 6d 65  74 65 72 20 73 70 65 63  |s parameter spec|
00000700  69 66 69 65 73 20 74 68  65 20 3c 49 3e 6e 61 6d  |ifies the <I>nam|
00000710  65 3c 2f 49 3e 20 6f 66  20 74 68 65 20 6d 61 70  |e</I> of the map|
00000720  20 74 68 61 74 20 74 68  65 20 73 65 72 76 65 72  | that the server|
00000730  20 73 68 6f 75 6c 64 20  6c 6f 6f 6b 20 69 6e 20  | should look in |
00000740  74 6f 20 64 65 74 65 72  6d 69 6e 65 20 77 68 69  |to determine whi|
00000750  63 68 20 70 61 67 65 20  74 6f 20 6a 75 6d 70 20  |ch page to jump |
00000760  74 6f 2e 3c 2f 50 3e 0a  0a 3c 41 20 4e 41 4d 45  |to.</P>..<A NAME|
00000770  3d 22 73 65 74 75 70 22  3e 3c 48 32 3e 53 65 74  |="setup"><H2>Set|
00000780  74 69 6e 67 20 55 70 20  49 6d 61 67 65 6d 61 70  |ting Up Imagemap|
00000790  73 3c 2f 48 32 3e 3c 2f  41 3e 0a 0a 3c 50 3e 4e  |s</H2></A>..<P>N|
000007a0  65 74 70 6c 65 78 20 69  6d 70 6c 65 6d 65 6e 74  |etplex implement|
000007b0  73 20 69 6d 61 67 65 6d  61 70 70 69 6e 67 20 61  |s imagemapping a|
000007c0  73 20 61 20 73 6d 61 6c  6c 20 43 47 49 20 70 72  |s a small CGI pr|
000007d0  6f 67 72 61 6d 20 28 63  67 69 2d 62 69 6e 2e 69  |ogram (cgi-bin.i|
000007e0  6d 61 67 65 6d 61 70 29  20 77 68 69 63 68 20 77  |magemap) which w|
000007f0  69 6c 6c 20 62 65 20 69  6e 76 6f 6b 65 64 20 77  |ill be invoked w|
00000800  68 65 6e 20 73 6f 6d 65  6f 6e 65 20 63 6c 69 63  |hen someone clic|
00000810  6b 73 20 6f 6e 20 61 6e  20 69 6d 61 67 65 20 61  |ks on an image a|
00000820  66 74 65 72 20 62 65 69  6e 67 20 73 65 74 20 75  |fter being set u|
00000830  70 20 61 73 20 74 68 61  74 20 6f 75 74 6c 69 6e  |p as that outlin|
00000840  65 64 20 61 62 6f 76 65  2e 20 20 54 68 65 20 69  |ed above.  The i|
00000850  6d 61 67 65 6d 61 70 20  70 72 6f 67 72 61 6d 20  |magemap program |
00000860  72 65 61 64 73 20 74 68  65 20 6e 61 6d 65 20 70  |reads the name p|
00000870  61 73 73 65 64 20 74 6f  20 69 74 2c 20 66 69 6e  |assed to it, fin|
00000880  64 73 20 74 68 65 20 61  73 73 6f 63 69 61 74 65  |ds the associate|
00000890  64 20 6d 61 70 20 66 69  6c 65 2c 20 73 65 65 73  |d map file, sees|
000008a0  20 77 68 69 63 68 20 55  52 4c 20 74 68 65 20 63  | which URL the c|
000008b0  6c 69 63 6b 2d 70 6f 69  6e 74 20 72 65 66 65 72  |lick-point refer|
000008c0  73 20 74 6f 20 61 6e 64  20 74 68 65 6e 20 73 65  |s to and then se|
000008d0  6e 64 73 20 74 68 65 20  63 6c 69 65 6e 74 20 61  |nds the client a|
000008e0  20 72 65 6c 6f 63 61 74  65 20 6d 65 73 73 61 67  | relocate messag|
000008f0  65 20 73 6f 20 74 68 61  74 20 69 74 20 77 69 6c  |e so that it wil|
00000900  6c 20 61 75 74 6f 6d 61  74 69 63 61 6c 6c 79 20  |l automatically |
00000910  6a 75 6d 70 20 74 6f 20  74 68 65 20 63 6f 72 72  |jump to the corr|
00000920  65 63 74 20 70 61 67 65  2e 3c 2f 50 3e 0a 0a 3c  |ect page.</P>..<|
00000930  41 20 4e 41 4d 45 3d 22  63 66 67 2d 69 6d 61 67  |A NAME="cfg-imag|
00000940  65 6d 61 70 73 22 3e 3c  2f 41 3e 0a 3c 50 3e 42  |emaps"></A>.<P>B|
00000950  65 66 6f 72 65 20 75 73  69 6e 67 20 61 6e 79 20  |efore using any |
00000960  69 6d 61 67 65 6d 61 70  73 20 79 6f 75 20 6d 75  |imagemaps you mu|
00000970  73 74 20 63 72 65 61 74  65 20 61 20 3c 41 20 48  |st create a <A H|
00000980  52 45 46 3d 22 31 30 2d  63 6f 6e 66 69 22 3e 43  |REF="10-confi">C|
00000990  6f 6e 66 69 67 75 72 61  74 69 6f 6e 20 66 69 6c  |onfiguration fil|
000009a0  65 3c 2f 41 3e 20 77 68  69 63 68 20 64 65 74 61  |e</A> which deta|
000009b0  69 6c 73 20 74 68 65 20  6d 61 70 70 69 6e 67 20  |ils the mapping |
000009c0  62 65 74 77 65 65 6e 20  74 68 65 20 6e 61 6d 65  |between the name|
000009d0  20 70 61 73 73 65 64 20  28 65 2e 67 2e 20 27 65  | passed (e.g. 'e|
000009e0  78 61 6d 70 6c 65 27 29  20 61 6e 64 20 74 68 65  |xample') and the|
000009f0  20 61 63 74 75 61 6c 20  66 69 6c 65 6e 61 6d 65  | actual filename|
00000a00  20 6f 66 20 74 68 65 20  6d 61 70 2e 20 20 54 68  | of the map.  Th|
00000a10  69 73 20 43 6f 6e 66 69  67 75 72 61 74 69 6f 6e  |is Configuration|
00000a20  20 66 69 6c 65 20 6d 75  73 74 20 62 65 20 70 6c  | file must be pl|
00000a30  61 63 65 64 20 69 6e 20  74 68 65 20 72 6f 6f 74  |aced in the root|
00000a40  20 77 65 62 20 70 61 67  65 20 64 69 72 65 63 74  | web page direct|
00000a50  6f 72 79 20 61 6e 64 20  63 61 6c 6c 65 64 20 27  |ory and called '|
00000a60  49 6d 61 67 65 6d 61 70  73 27 2e 20 20 41 6e 20  |Imagemaps'.  An |
00000a70  65 78 61 6d 70 6c 65 20  6f 66 20 74 68 69 73 20  |example of this |
00000a80  69 73 20 3a 3c 2f 50 3e  0a 0a 3c 50 3e 3c 50 52  |is :</P>..<P><PR|
00000a90  45 3e 0a 23 20 45 78 61  6d 70 6c 65 20 49 6d 61  |E>.# Example Ima|
00000aa0  67 65 6d 61 70 20 43 6f  6e 66 69 67 75 72 61 74  |gemap Configurat|
00000ab0  69 6f 6e 20 66 69 6c 65  0a 23 0a 23 20 54 68 65  |ion file.#.# The|
00000ac0  20 66 6f 72 6d 61 74 20  69 73 20 26 6c 74 3b 6e  | format is &lt;n|
00000ad0  61 6d 65 20 6f 66 20 6d  61 70 26 67 74 3b 3a 26  |ame of map&gt;:&|
00000ae0  6c 74 3b 66 69 6c 65 6e  61 6d 65 20 6f 66 20 6d  |lt;filename of m|
00000af0  61 70 26 67 74 3b 0a 23  0a 49 6d 61 67 65 6d 61  |ap&gt;.#.Imagema|
00000b00  70 73 0a 65 78 61 6d 70  6c 65 3a 26 6c 74 3b 4e  |ps.example:&lt;N|
00000b10  65 74 70 6c 65 78 24 57  65 62 50 61 67 65 73 44  |etplex$WebPagesD|
00000b20  69 72 26 67 74 3b 2e 69  6d 61 67 65 6d 61 70 2e  |ir&gt;.imagemap.|
00000b30  65 78 61 6d 70 6c 65 0a  3c 2f 50 52 45 3e 3c 2f  |example.</PRE></|
00000b40  50 3e 0a 0a 3c 50 3e 53  6f 20 77 68 65 6e 20 74  |P>..<P>So when t|
00000b50  68 65 20 63 6c 69 65 6e  74 20 61 73 6b 73 20 66  |he client asks f|
00000b60  6f 72 20 27 2f 63 67 69  2d 62 69 6e 2f 69 6d 61  |or '/cgi-bin/ima|
00000b70  67 65 6d 61 70 2f 65 78  61 6d 70 6c 65 27 2c 20  |gemap/example', |
00000b80  74 68 65 20 6e 61 6d 65  20 27 65 78 61 6d 70 6c  |the name 'exampl|
00000b90  65 27 20 69 73 20 6c 6f  6f 6b 65 64 20 75 70 20  |e' is looked up |
00000ba0  69 6e 20 74 68 69 73 20  66 69 6c 65 20 61 6e 64  |in this file and|
00000bb0  20 74 68 65 20 69 6d 61  67 65 6d 61 70 20 70 72  | the imagemap pr|
00000bc0  6f 67 72 61 6d 20 74 68  65 6e 20 75 73 65 73 20  |ogram then uses |
00000bd0  74 68 65 20 66 69 6c 65  20 26 6c 74 3b 4e 65 74  |the file &lt;Net|
00000be0  70 6c 65 78 24 57 65 62  50 61 67 65 73 44 69 72  |plex$WebPagesDir|
00000bf0  26 67 74 3b 2e 69 6d 61  67 65 6d 61 70 2e 65 78  |&gt;.imagemap.ex|
00000c00  61 6d 70 6c 65 20 61 73  20 74 68 65 20 6d 61 70  |ample as the map|
00000c10  2e 3c 2f 50 3e 0a 0a 3c  50 3e 54 68 65 20 6e 65  |.</P>..<P>The ne|
00000c20  78 74 20 66 69 6c 65 20  79 6f 75 20 6d 75 73 74  |xt file you must|
00000c30  20 6d 61 6b 65 20 69 73  20 74 68 65 20 6d 61 70  | make is the map|
00000c40  20 69 74 73 65 6c 66 2e  20 20 54 68 69 73 20 69  | itself.  This i|
00000c50  73 20 74 68 65 20 61 63  74 75 61 6c 20 66 69 6c  |s the actual fil|
00000c60  65 20 77 68 69 63 68 20  64 65 74 61 69 6c 73 20  |e which details |
00000c70  77 68 69 63 68 20 70 61  72 74 73 20 6f 66 20 74  |which parts of t|
00000c80  68 65 20 69 6d 61 67 65  20 6c 69 6e 6b 20 74 6f  |he image link to|
00000c90  20 77 68 69 63 68 20 55  52 4c 73 2e 20 20 49 74  | which URLs.  It|
00000ca0  20 74 61 6b 65 73 20 74  68 65 20 66 6f 6c 6c 6f  | takes the follo|
00000cb0  77 69 6e 67 20 66 6f 72  6d 20 3a 3c 2f 50 3e 0a  |wing form :</P>.|
00000cc0  0a 3c 50 3e 3c 50 52 45  3e 0a 23 20 49 6d 61 67  |.<P><PRE>.# Imag|
00000cd0  65 20 4d 61 70 20 70 72  6f 64 75 63 65 64 20 62  |e Map produced b|
00000ce0  79 20 47 65 72 70 68 27  73 20 49 6d 61 67 65 6e  |y Gerph's Imagen|
00000cf0  20 31 2e 34 34 20 28 31  38 20 4f 63 74 20 31 39  | 1.44 (18 Oct 19|
00000d00  39 36 29 0a 23 0a 64 65  66 61 75 6c 74 20 68 74  |96).#.default ht|
00000d10  74 70 3a 2f 2f 6c 6f 63  61 6c 68 6f 73 74 2f 69  |tp://localhost/i|
00000d20  6d 61 67 65 6d 61 70 2f  64 65 66 61 75 6c 74 0a  |magemap/default.|
00000d30  63 69 72 63 6c 65 20 68  74 74 70 3a 2f 2f 6c 6f  |circle http://lo|
00000d40  63 61 6c 68 6f 73 74 2f  69 6d 61 67 65 6d 61 70  |calhost/imagemap|
00000d50  2f 77 6f 72 6c 64 20 33  35 2c 33 37 20 35 37 2c  |/world 35,37 57,|
00000d60  36 34 20 0a 63 69 72 63  6c 65 20 68 74 74 70 3a  |64 .circle http:|
00000d70  2f 2f 6c 6f 63 61 6c 68  6f 73 74 2f 69 6d 61 67  |//localhost/imag|
00000d80  65 6d 61 70 2f 77 6f 72  6c 64 20 32 39 37 2c 38  |emap/world 297,8|
00000d90  33 20 33 31 39 2c 31 31  30 20 0a 70 6f 6c 79 20  |3 319,110 .poly |
00000da0  68 74 74 70 3a 2f 2f 6c  6f 63 61 6c 68 6f 73 74  |http://localhost|
00000db0  2f 69 6d 61 67 65 6d 61  70 2f 74 65 78 74 20 35  |/imagemap/text 5|
00000dc0  36 2c 31 31 32 20 32 37  36 2c 31 31 33 20 32 37  |6,112 276,113 27|
00000dd0  37 2c 31 33 31 20 32 32  31 2c 31 33 32 20 32 32  |7,131 221,132 22|
00000de0  31 2c 31 34 38 20 31 31  33 2c 31 34 37 20 31 31  |1,148 113,147 11|
00000df0  32 2c 31 33 34 20 35 37  2c 31 33 33 20 0a 72 65  |2,134 57,133 .re|
00000e00  63 74 20 68 74 74 70 3a  2f 2f 6c 6f 63 61 6c 68  |ct http://localh|
00000e10  6f 73 74 2f 69 6d 61 67  65 6d 61 70 2f 6e 70 20  |ost/imagemap/np |
00000e20  32 34 2c 31 38 20 33 30  31 2c 39 38 20 0a 3c 2f  |24,18 301,98 .</|
00000e30  50 52 45 3e 3c 2f 50 3e  0a 0a 3c 50 3e 4d 61 70  |PRE></P>..<P>Map|
00000e40  20 66 69 6c 65 73 20 64  65 66 69 6e 65 2c 20 69  | files define, i|
00000e50  6e 20 74 65 72 6d 73 20  6f 66 20 3c 49 3e 63 69  |n terms of <I>ci|
00000e60  72 63 6c 65 3c 2f 49 3e  73 2c 20 3c 49 3e 72 65  |rcle</I>s, <I>re|
00000e70  63 74 3c 2f 49 3e 61 6e  67 6c 65 73 20 61 6e 64  |ct</I>angles and|
00000e80  20 3c 49 3e 70 6f 6c 79  3c 2f 49 3e 67 6f 6e 73  | <I>poly</I>gons|
00000e90  2c 20 77 68 69 63 68 20  61 72 65 61 73 20 69 6e  |, which areas in|
00000ea0  20 74 68 65 20 69 6d 61  67 65 20 6c 65 61 64 20  | the image lead |
00000eb0  74 6f 20 6f 74 68 65 72  20 55 52 4c 73 2e 20 20  |to other URLs.  |
00000ec0  41 6c 74 68 6f 75 67 68  20 79 6f 75 20 63 61 6e  |Although you can|
00000ed0  20 63 72 65 61 74 65 20  74 68 65 6d 20 62 79 20  | create them by |
00000ee0  68 61 6e 64 20 69 74 27  73 20 61 20 62 65 74 74  |hand it's a bett|
00000ef0  65 72 20 62 65 74 20 74  6f 20 67 65 74 20 61 20  |er bet to get a |
00000f00  63 6f 70 79 20 6f 66 20  3c 41 20 48 52 45 46 3d  |copy of <A HREF=|
00000f10  22 68 74 74 70 3a 2f 2f  75 73 65 72 73 2e 65 73  |"http://users.es|
00000f20  73 65 78 2e 61 63 2e 75  6b 2f 75 73 65 72 73 2f  |sex.ac.uk/users/|
00000f30  6a 72 66 6c 65 74 2f 22  3e 4a 75 73 74 69 6e 20  |jrflet/">Justin |
00000f40  46 6c 65 74 63 68 65 72  27 73 3c 2f 41 3e 20 65  |Fletcher's</A> e|
00000f50  78 63 65 6c 6c 65 6e 74  20 3c 49 3e 49 6d 61 67  |xcellent <I>Imag|
00000f60  65 6e 3c 2f 49 3e 20 6d  61 70 20 65 64 69 74 6f  |en</I> map edito|
00000f70  72 20 77 68 69 63 68 20  61 6c 6c 6f 77 73 20 79  |r which allows y|
00000f80  6f 75 20 74 6f 20 69 6e  74 65 72 61 63 74 69 76  |ou to interactiv|
00000f90  65 6c 79 20 63 72 65 61  74 65 20 61 6e 64 20 65  |ely create and e|
00000fa0  64 69 74 20 6d 61 70 20  66 69 6c 65 73 2e 20 20  |dit map files.  |
00000fb0  4e 6f 74 65 20 74 68 61  74 20 4e 65 74 70 6c 65  |Note that Netple|
00000fc0  78 20 75 73 65 73 20 4e  43 53 41 20 66 6f 72 6d  |x uses NCSA form|
00000fd0  61 74 20 6d 61 70 20 66  69 6c 65 73 20 28 61 73  |at map files (as|
00000fe0  20 6f 70 70 6f 73 65 64  20 74 6f 20 43 45 52 4e  | opposed to CERN|
00000ff0  20 66 6f 72 6d 61 74 20  6d 61 70 73 29 2e 20 20  | format maps).  |
00001000  54 68 65 20 4e 65 74 70  6c 65 78 20 69 6d 61 67  |The Netplex imag|
00001010  65 6d 61 70 70 65 72 20  77 69 6c 6c 20 61 6c 73  |emapper will als|
00001020  6f 20 61 63 63 65 70 74  20 55 52 4c 73 20 69 6e  |o accept URLs in|
00001030  20 72 65 6c 61 74 69 76  65 2d 74 6f 2d 72 6f 6f  | relative-to-roo|
00001040  74 20 66 6f 72 6d 2c 20  65 2e 67 2e 20 27 2f 69  |t form, e.g. '/i|
00001050  6d 61 67 65 6d 61 70 2f  77 6f 72 6c 64 27 2e 3c  |magemap/world'.<|
00001060  2f 50 3e 0a 0a 3c 41 20  4e 41 4d 45 3d 22 65 78  |/P>..<A NAME="ex|
00001070  61 6d 70 6c 65 22 3e 3c  48 32 3e 45 78 61 6d 70  |ample"><H2>Examp|
00001080  6c 65 3c 2f 48 32 3e 3c  2f 41 3e 0a 0a 3c 50 3e  |le</H2></A>..<P>|
00001090  59 6f 75 20 63 61 6e 20  74 72 79 20 6f 75 74 20  |You can try out |
000010a0  74 68 65 20 69 6d 61 67  65 6d 61 70 70 69 6e 67  |the imagemapping|
000010b0  20 73 75 70 70 6f 72 74  20 66 6f 72 20 79 6f 75  | support for you|
000010c0  72 73 65 6c 66 20 62 79  20 63 6f 70 79 69 6e 67  |rself by copying|
000010d0  20 74 68 65 20 65 78 61  6d 70 6c 65 20 43 6f 6e  | the example Con|
000010e0  66 69 67 75 72 61 74 69  6f 6e 20 66 69 6c 65 20  |figuration file |
000010f0  63 61 6c 6c 65 64 20 27  49 6d 61 67 65 6d 61 70  |called 'Imagemap|
00001100  73 27 20 66 72 6f 6d 20  74 68 65 20 21 4e 65 74  |s' from the !Net|
00001110  70 6c 65 78 2e 21 48 65  6c 70 2e 48 54 4d 4c 2e  |plex.!Help.HTML.|
00001120  69 6d 61 67 65 6d 61 70  20 64 69 72 65 63 74 6f  |imagemap directo|
00001130  72 79 20 69 6e 74 6f 20  74 68 65 20 72 6f 6f 74  |ry into the root|
00001140  20 77 65 62 20 70 61 67  65 20 64 69 72 65 63 74  | web page direct|
00001150  6f 72 79 2e 20 20 41 66  74 65 72 20 79 6f 75 20  |ory.  After you |
00001160  68 61 76 65 20 64 6f 6e  65 20 74 68 69 73 2c 20  |have done this, |
00001170  63 6c 69 63 6b 69 6e 67  20 6f 6e 20 64 69 66 66  |clicking on diff|
00001180  65 72 65 6e 74 20 70 61  72 74 73 20 6f 66 20 74  |erent parts of t|
00001190  68 65 20 70 69 63 74 75  72 65 20 62 65 6c 6f 77  |he picture below|
000011a0  20 77 69 6c 6c 20 79 65  69 6c 64 20 61 6e 20 61  | will yeild an a|
000011b0  70 70 72 6f 70 72 69 61  74 65 20 72 65 73 70 6f  |ppropriate respo|
000011c0  6e 73 65 20 66 72 6f 6d  20 74 68 65 20 69 6d 61  |nse from the ima|
000011d0  67 65 6d 61 70 70 65 72  2e 3c 2f 50 3e 0a 0a 3c  |gemapper.</P>..<|
000011e0  43 45 4e 54 45 52 3e 0a  3c 41 20 48 52 45 46 3d  |CENTER>.<A HREF=|
000011f0  22 2f 63 67 69 2d 62 69  6e 2f 69 6d 61 67 65 6d  |"/cgi-bin/imagem|
00001200  61 70 2f 65 78 61 6d 70  6c 65 22 3e 0a 3c 49 4d  |ap/example">.<IM|
00001210  47 20 53 52 43 3d 22 69  6d 61 67 65 73 2f 6e 65  |G SRC="images/ne|
00001220  74 70 6c 65 78 22 20 49  53 4d 41 50 3e 0a 3c 2f  |tplex" ISMAP>.</|
00001230  41 3e 0a 3c 2f 43 45 4e  54 45 52 3e 0a 0a 3c 48  |A>.</CENTER>..<H|
00001240  52 3e 0a 0a 3c 50 3e 3c  43 45 4e 54 45 52 3e 0a  |R>..<P><CENTER>.|
00001250  3c 41 20 48 52 45 46 3d  22 31 33 2d 63 67 69 22  |<A HREF="13-cgi"|
00001260  3e 3c 49 4d 47 20 53 52  43 3d 22 69 6d 61 67 65  |><IMG SRC="image|
00001270  73 2f 62 75 74 74 6f 6e  73 2f 62 61 6b 22 20 57  |s/buttons/bak" W|
00001280  49 44 54 48 3d 33 32 20  48 45 49 47 48 54 3d 33  |IDTH=32 HEIGHT=3|
00001290  32 20 42 4f 52 44 45 52  3d 30 20 41 4c 54 3d 22  |2 BORDER=0 ALT="|
000012a0  5b 20 50 72 65 76 69 6f  75 73 20 5d 22 3e 3c 2f  |[ Previous ]"></|
000012b0  41 3e 0a 3c 41 20 48 52  45 46 3d 22 69 6e 64 65  |A>.<A HREF="inde|
000012c0  78 22 3e 3c 49 4d 47 20  53 52 43 3d 22 69 6d 61  |x"><IMG SRC="ima|
000012d0  67 65 73 2f 62 75 74 74  6f 6e 73 2f 75 70 22 20  |ges/buttons/up" |
000012e0  57 49 44 54 48 3d 33 32  20 48 45 49 47 48 54 3d  |WIDTH=32 HEIGHT=|
000012f0  33 32 20 42 4f 52 44 45  52 3d 30 20 41 4c 54 3d  |32 BORDER=0 ALT=|
00001300  22 5b 20 49 6e 64 65 78  20 5d 22 3e 3c 2f 41 3e  |"[ Index ]"></A>|
00001310  0a 3c 41 20 48 52 45 46  3d 22 61 30 2d 70 65 72  |.<A HREF="a0-per|
00001320  66 6f 22 3e 3c 49 4d 47  20 53 52 43 3d 22 69 6d  |fo"><IMG SRC="im|
00001330  61 67 65 73 2f 62 75 74  74 6f 6e 73 2f 66 77 64  |ages/buttons/fwd|
00001340  22 20 57 49 44 54 48 3d  33 32 20 48 45 49 47 48  |" WIDTH=32 HEIGH|
00001350  54 3d 33 32 20 42 4f 52  44 45 52 3d 30 20 41 4c  |T=32 BORDER=0 AL|
00001360  54 3d 22 5b 20 4e 65 78  74 20 5d 22 3e 3c 2f 41  |T="[ Next ]"></A|
00001370  3e 0a 3c 2f 43 45 4e 54  45 52 3e 3c 2f 50 3e 0a  |>.</CENTER></P>.|
00001380  0a 3c 2f 42 4f 44 59 3e  0a 0a 3c 2f 48 54 4d 4c  |.</BODY>..</HTML|
00001390  3e 0a                                             |>.|
00001392