imgindex.py
Revision:  1.2
Rev Date:  24 Mar 2001

$Id: README,v 1.3 2001/03/24 15:31:59 dyork Exp $

This python script is designed to create an web page (HTML file)
showing an index of the graphic files in a given directory.

It was created out of frustration while trying to figure
out what was on all the floppies I was generating with my
Sony Mavica camera.  Hopefully it will save you some frustration...

Note that this program was originally implemented as a
perl script called 'jpgindex'. It was rewritten in python
as 'imgindex' and *greatly* expanded and improved.

If you have any comments about this script, or if you
make an improved version, please contact Dan York at
dyork@Lodestar2.com

Copyright (C) 1998-2001  Dan York, dyork@Lodestar2.com
http://www.Lodestar2.com/software/imgindex/

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.
http://www.gnu.org/copyleft/gpl.html
----------------------------------------------------------

USAGE

If used alone without any command-line arguments, the program
will look in the current directory, find any files ending in
.jpg, .JPG, .jpeg and .JPEG and create a file "index.html".
The thumbnail images will be 320 pixels wide and 240 pixels
high. (Note that the thumbnails are accomplished by using
the HTML "height" and "width" attributes of the <IMG> tag
and NOT by modifying files, therefore there is no reduction
in the file size of the images.)

It has the following command-line options:

      -a            - index all formats (GIF, JPG and PNG) 
      -c <columns>  - set the number of columns
      -f <filename> - output filename
      -h <height>   - height of images in HTML file
      -t "title"    - title for use in text and HTML <TITLE>
      -w <width>    - width of images in HTML file
      -?            - print this help message

Here are some examples (note that the order of the options
does not matter):

 imgindex.py -f mypics.html -w 640 -h 480 -a -t "My Pictures"
 imgindex.py -a -w 128 -h 96 -c 4 -t "Very small pictures"

----------------------------------------------------------

IF YOU LIKE THIS SOFTWARE and wish to say thanks, just mail
a postcard of the area in which you live to me at:

  Dan York
  59 Aylen Avenue
  Ottawa, ON  K2A3P8
  Canada

(Hey, my father-in-law is a postcard collector and I'm starting
to get interested. ;-)