MakeImageMap.ifx
                                ~~~~~~~~~~~~~~~~

So what's an imagemap?
~~~~~~~~~~~~~~~~~~~~~~
Well, you've probably encountered them quite often on the Web, mostly in
graphical menues ... You probably remember them as "the-picture-thingie-I-
clicked-on-and-got-to-a-nice-page-on"...

There are currently two kinds of imagemaps ... Server Side and Client Side ...

Server Side imagemaps works by receiving coordinates from the client (AMosaic,
IBrowse, Netscape etc...) and treating them through a program on the server
(your INet supplier must have this program).

Client Side imagemaps works from within the actual document, giving commands to
your Web-browser what will happen if you click within a specified area. (This is
not supported by AMosaic)

The advantage of Client Side imagemaps is that the user actually sees the links
as he points at them, thus making the map more understandable for common people.


This is an example Server Side imagemap:
--8<--
default /path-to-document/document-name
point /path-to-document/document-name 50,10
rect /path-to-document/document-name 100,30 200,60
circle /path-to-document/document-name 200,40 200,90
poly /path-to-document/document-name 389,106 300,38 349,0 419,94 390,106
-->8--

Where "default" is the place to go if it can't find the area...

This is called by:
--8<--
<A HREF="http://www.somewhere.here/cgi-bin/imagemap/path-to-map/name-of-map">
<IMG SRC="/path-to-image/image-to-be-mapped" ISMAP></A>
-->8--

"cgi-bin/imagemap" is the imagemap program on the server...


This is an example Client Side imagemap:
--8<--
<MAP NAME="name-of-map">
<AREA SHAPE="RECT" COORDS="20,30,40,50" HREF="name-of-document">
<AREA SHAPE="RECT" COORDS="0,0,400,500" NOHREF>
</MAP>
-->8--

Where "NOHREF" tells it not to do anything if it encounters this area (anything
not specified is "NOHREF")...

This is called by:
--8<--
<IMG SRC="/path-to-image/image-to-be-mapped" USEMAP="#name-of-map-in-document">
-->8--


How to make it work
~~~~~~~~~~~~~~~~~~~
First of all you need ImageFX 2.0 or higher...

Copy MakeImageMap.ifx and WriteImageMap.ifx to ImageFX:rexx/

Start ImageFX (ImageFX or ImageFX_WBP preferably) and run MakeImageMap.ifx.
Select the image you are going to make the map out of. Then press "OK" for
Server Side or "Cancel" for Client Side...

Then it should be straight-forward what to do next, edit away and press "OK"
when you are finished to save the map...

If you clear the string or press "Cancel" when you are asked for an URL in
Client Side mode you get a "NOHREF"...

BTW, make sure that your rectangles are made from the upper-left corner to the
lower-right, and please note that the circle function doesn't support elipses.
If it encounters an elipse it will assume it's a circle, so the display will be
a bit misguiding if you happen to draw an elipse...


What does WriteImageMap.ifx do?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
This is just a server for the wedges I had to use to make this program work ...

Nothing to worry about, just leave it alone and everything will be fine.


Some history (gawd, I hate this!)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1.x: Beta.
1.3: First release on Aminet.
1.4: Added CIRCLE and POLY to Client Side maps.


Who made this?
~~~~~~~~~~~~~~
Sigbjørn Skjæret (the one and only! ;) ) made these small programs when he was
experimenting upon making his own imagemap-server, and needed a simple tool to
design the maps...

You can reach me at the following address:

Sigbjørn Skjæret
Brettevillesgt. 24
N-0481 Oslo
Norway

My E-Mail address is cisc@hedning.no, and you can look at my horrible (it's on
the Netscape Hall of Shame (http://www.meat.com/netscape_hos.html)) homepage at
http://www.hedning.no/~cisc...