make-img-map - Make an image map from a list of images


  gimp-make-img-map [-max_height mh] [-htmlindex hi] [-layoutwidth lw]
               [-flatten] [-bgcolor clr] [-bgpattern ptn] list


This program is an automatic way of scaling and tiling lots of images in order to create an index image.

gimp-make-img-map communicates with GIMP through the Perl Net-Server and automates the process of combining a list of images into an image map for use e.g. within a HTML page.


    -max_height mh   Set max height of images. (Default $max_height)
    -index if        Create an index file mapping filename to bounding box
                     coordinates in output image, where if is the name of
                     the index file. The index file may e.g. be translated by
                     a subsequent program into a html index file.
    -layoutwidth lw  Set total width of layout. (Default $layout_width)
    -flatten         Flatten the final image.
    -bgcolor         Set bg color.
    -bgpattern       Set bg pattern. Overrides the bgcolor.
    -padx px         Extra space around all images in x-direction.
                     (Default $pad_x)
    -pady py         Extra space around all images in y-direction.
                     (Default $pad_y)
    -gutterx gx      Space between images in x-direction. (Default $gutter_x)
    -gutterx gy      Space between images in y-direction. (Default $gutter_y)
    -darkcomp        Compensate for darkening when bumpmapping.
    -decoration alg  Choose algorithm for drawing the decoration in the layout.
                     Known algorithms are:
                     Default is 'drop_shadow'.


Given a text file myimg.list containing the names of four images of arbitrary sizes:



 gimp-make-img-map -bgcolor #440000 -layoutwidth 400 myimg.list

An alternative command line:

 gimp-make-img-map -index myindex.list -max_height 50 -bgpattern Wood \
    -decoration sunken-windows -darkcomp -layoutwidth 200 myimg.list      


If the option -index index.idx is given then the following info is written to the file index.idx:

  red.png 22 20 178 70 
  green.png 55 85 105 135 
  blue.png 120 85 145 135 
  pink.png 62 150 138 200

This info can easily be converted into a html image map with a script similar to the following:

  my $map = q(<map name="mymap">);
  my $idx = 0;
  while(<>) {
     ($img, $x0, $y0, $x1, $y1) = split;
     $map .= "<area shape=\"rect\" coords=\"$x0,$y0,$x1,$y1\" ".
  $map .= "</map>";
  print "$map";
  print "<img src=\"index.jpg\" usemap=\"#mymap\>\n";


  -padx px means at least px and not exactly px. This should be fixed.


    - Add more layout algorithms. (fixed grid, dynamic grid, better
      orphan handling)
    - Add more decoration algorithms (e.g. negative strip, slides,
      sunken windows).
    - Create a way of supplying a template HTML index file into which
      the image map will be added.
    - Create a way of supplying a template HTML file in which
      full size images will be displayed. This file may include
      image annotations that come from the input file.
    - Define format of input file. This file should include
      annotations on/below images, comments in the full size html
      file, perhaps baloon text on top of images.
    - Make all parameters of tiling algorithms into options.
    - Change background of simple-shadow algorithm.
    - Option for either keeping image in gimp, or flattening and
      saving to disk.
    - Add a modular way of adding new layout and decoration algorithms.


Dov Grobgeld <>


    0.13  * Replaced call to gimp_image_get_layers() with call to
            gimp_image_get_active_layer(), as the former was broken
            in Gimp-0.90 .
          * Made kludge to be able to print out my own help message.
    0.14  * Got rid of OO module which is no longer in use.


(c) Dov Grobgeld

Released under the Artistic license.