The Improved imagemap Script

The Central Configuration File

/usr/local/etc/httpd/conf/imagemap.conf.

If you would like to change the location of this file, edit cgi-bin/src/imagemap.c, change the setting of CONF_FILE, and recompile with make imagemap.

In this file, lines beginning with a # are comments. Every other non-blank line consists of:

name : path

name is the name of the particular mapping. You use it when you reference the image.

path is the full path to the map configuration file for this mapping.

The Map Configuration File

Lines beginning with # are comments. Every other non-blank line consists of the following:

method url coord1 coord2 ... coordn

coord are each coordinates, format x,y. The number depends on method.

method is one of the following:

• circle

  For a circle. Coordinates: center edgepoint

• poly

  For a polygon of at most 100 vertices. Each coordinate is a vertex.

• rect

  For a rectangle. Coordinates: upper-left lower-right

• a virtual pathname to a file on your server (i.e. a URL to your server without the http://hostname part)
• a URL

Referencing Your New Map

For example, if you have a ScriptAlias /cgi-bin/ /usr/local/etc/httpd/cgi-bin, named your map fish, and used the image fish33.gif for the map, the following line of HTML will reference it:

<A HREF="/cgi-bin/imagemap/fish"><IMG SRC="fish33.gif" ISMAP></A>

A Complete Example

Central Configuration File

fish : /usr/local/etc/httpd/conf/fish.map

Map Configuration File

Return to administration overview