DragonFly On-Line Manual Pages

Search: Section:  

IMAGEMAP(1)            DragonFly General Commands Manual           IMAGEMAP(1)


NAME

     imagemap - 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 ALSO

     httpd(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
     converted for inclusing in the xs-httpd distribution in 1995.

xs-httpd/3.5                    March 26, 1996                    xs-httpd/3.5

Search: Section: