$ dot -Timap
$ dot -Timap_np
$ dot -Tismap
$ dot -Tcmap
$ dot -Tcmapx
$ dot -Tcmapx_np


Image Map: Server-side and client-side

imap and cmapx produce map files for server-side and client-side image maps. These can be used in a web page with a graphical form of the output, e.g. in JPEG, GIF or PNG format, to attach links to nodes and edges. Graphviz generates an object’s map information only if the object has a non-trival URL or href attribute, or if it has an explicit tooltip attribute.

cmap produces map files for client-side image maps. It’s mostly identical to cmapx, but the latter is well-formed XML amenable to processing by XML tools. In particular, the cmapx output is wrapped in <map></map>.

imap_np and cmapx_np are identical to the imap and cmapx formats, except they rely solely on rectangles as active areas.

ismap is a predecessor (circa 1994) of the imap format. Most servers now use the latter.

For example, to create a server-side map given the dot file:

/* x.gv */
digraph mainmap {
  command [URL=""];
  command -> output [URL="colors.html"];

one would process the graph and generate two output files:

dot -Timap -Tgif -ox.gif x.gv

and then refer to it in a web page:

<A HREF=""><IMG SRC="x.gif" ismap="ismap" /></A>

For client-side maps, one again generates two output files:

dot -Tcmapx -Tgif -ox.gif x.gv

and uses the HTML

<IMG SRC="x.gif" USEMAP="#mainmap" />
... [content of] ...

Note that the name given in the USEMAP attribute must be the same as the ID attribute of the MAP element. The Graphviz renderer uses the name of the graph as the ID. Thus, in the example above, where the graph’s name is mainmap, we have USEMAP="#mainmap" in the IMG attribute, and will look like

<map id="mainmap" name="mainmap">

URLs can be attached to the root graph, nodes and edges. If a node has a URL, clicking in the node will activate the link. If an edge has a URL, various points along the edge (but not necessarily the head or tail) will link to it. In addition, if the edge has a label, that will link to the URL. As for the head of the edge, this is linked to the headURL, if set. Otherwise, it is linked to the edge’s URL if that is defined. The analogous description holds for the tail and the tailURL. A URL associated with the graph is used as a default link.

If the URL of a node contains the escape sequence \N, it will be replaced by the node’s name. If the headURL is defined and contains the escape sequence \N, it will be replaced by the headlabel, if defined. The analogous result holds for the tailURL and the taillabel.

See ID Output Note.

Last modified September 17, 2022: Merge together the imagemap output docs (73140c0)