IMAGEMAP(1) BSD General Commands Manual IMAGEMAP(1)NAMEimagemap — The WWW image mapper
SYNOPSIS
http://your.site.name/cgi-bin/imagemap/~username/mapfile
DESCRIPTION
‘imagemap’ is a program that lets you handle imagemaps on the web. An
imagemap is basically a picture (for example a GIF file) that has been
divided into areas. A user with a browser that understands imagemaps
(most modern graphical browser do) can then click on a certain part of
the image. An area-specific action then occurs.
For example, consider a GIF picture with two areas on it: a box on the
left side and a circle on the right side. Then the user who created the
pictures can define what will happen if the remote user clicks on the
box, what will happen if the circle is pressed, and also what happens if
the user clicks on the picture, but not on the box or the circle (the
default).
imagemap(1) is not a program that allows the user to define the map.
There are other programs that do this; for example, mapedit(1) is a good
one. imagemap is the program that handles the actions for the webserver.
To make sure that the imagemap(1) program will have access to the mapfile
in a user's private webdirectory, it should be included in the
PathInfoScripts option of the httpd.conf(5) configuration file, with its
relative pathname /cgi-bin/imagemap/. This lets the script be executed
with the privileges of the user whose directory is accessed.
EXAMPLES
What a user must do is create a map file (either by hand, which is not
very easy, or by using a program like mapedit). Then, he or she must use
something like the following in his/her webpage:
<A HREF="http://site/cgi-bin/imagemap/~username/pics/image.map">
<IMG SRC="pics/image.gif" ISMAP>
</A>
In other words, make a href anchor to the imagemapper and use an image as
the contents of the anchor. Do not forgot to specify the ismap keyword in
the img tag.
SEE ALSOhttpd(1), httpd_cgi(7)
The project homepage: http://www.xs-httpd.org/
HISTORY
This program is derived from the NCSA httpd distribution, which can be
found at http://hoohoo.ncsa.uiuc.edu/cgi/. It was cleaned up and con‐
verted for inclusing in the xs-httpd distribution in 1995.
xs-httpd/3.5 March 26, 1996 xs-httpd/3.5
