TABLE OF CONTENTS

1. jpgind/README

jpgind/README

  jpgind -- Program for making web galleries from JPEG/Exif files

  Jpgind is commandline tool for generating web galleries from JPEG/Exif
  files. Each image's page can be supplemented with EXIF info and HTML
  metadata from a separate text file.

  There is limited metadata support. If image source directory contains 
  a file whose name is identical to source image appended with .dat 
  (case sensitive), then that file is parsed. The format is plain 
  ASCII, comment lines starting with hash char '#' in the first column.
  All but comment lines are appended to corresponding image page 'as is.'
  Comment lines may contain some processing directives, one per line, 
  no space between hash char and command string. If there are arguments
  to command directives, those are separated by single space.  
  Currently implemented directives are:

  rotate      Rotate image 90 degrees clockwise.

  Supports (to some degree) Exif 2.1. Exif info processing can be enabled 
  with -E or --exifinfo flags.
  
  Email address, if specified, is scrambled using Javascript to
  prevent web harvesting.
 
  User options can be given in .jpgindrc file located in user home directory
  (using environment variable HOME) or %HOMEDRIVE%/%HOMEPATH% on Wintel.
  Parameters are given one per line. Currently supported parameters are:
      background 
      border
      email
      exifinfo
      quality
      size
      thumbsize
   Commandline options always override these settings.

  - libjpeg from Independent JPEG group
  - EXIF parser code by Matthias Wandel
  - GNU getopt.c, getopt.h, and getopt

  jpgind [options] file...

  -b, --background background pixel value (0..255; default 255)
  -B, --border     border size between thumbs (default 3)
  -d, --debug      debug mode
  -D, --dircreate  flag for directory for output files (default 1)
      --email      specify feedback address
  -E, --exifinfo   specify EXIF info level: off, minimal, general, or debug
  -f               specify file containing input image names
  -F, --filter     filter: 0 = box; 1 = Bartlett (default 0)
  -h, --help       display this option help
      --include-orig  include link to original image
      --link-orig-only  link to original image only
  -M, --medianfilter median filter hooks (default 0): 0 = none,
                     1  = before scaling, 2 = before and after scaling
  -q, --quality      JPEG quality (0..100; default 95)
  -s, --thumbsize    thumbnail image size (default 64)
  -S, --size         image size (default 640)
      --slideshow    HTML slideshow using refresh
      --style        output style: default, jsky, shinkansen, or thumbs
  -T, --title        gallery title
      --version      print version information
  -x                 number of colums in index image
  -y                 number of rows in index image
  -Z, --strict-scaling  try to make thumbnails uniform in size

  0   successful termination
  1   error occurred
  2   invalid input or command-line switches

  This program is written in ANSI C. Currently known to compile in following
  environments: GNU/Linux, Mac OS X, Wintel (GNU MinGW)

  Create HTML pages that go to new directory named 'index' in current 
  working directory:
   jpgind --title "Moon viewing July 15 2002" *.JPG

  Example pages:  http://neko.homeunix.net/~petterik/kukka/
                  http://neko.homeunix.net/~petterik/ruska/

  Petteri Kettunen     http://www.iki.fi/petterik/

  http://www.iki.fi/petterik/jpgind.html            -- jpgind homepage
  jpgind_exif.html
  http://www.iki.fi/petterik/pub/jpgind/            -- sources and RPMs
  http://www.ijg.org/                               -- IJG
  http://www.sentex.net/~mwandel/jhead/             -- jhead 
  http://www.ba.wakwak.com/~tsuruzoh/               -- Exif demystified
  http://ise.stanford.edu/class/psych221/99/emkwok/ -- image scaling
  http://www.mingw.org/                             -- MinGW compiler

  - Cross-compile GNU/Linux-Wintel (apt-get install mingw32)

  -  Does not scale well to large number of images.

  v0.64 2002-12-16:
      - Lifted getopt.c, getopt.h, and getopt1.c from GNU hello. Renamed 
        external variables and getop() to supress linker warnings on Darwin.
      - Long options '--'.
      - --email, address scrambled with Javascript to prevent harvesting
      - usage rewritten and --mydocoutput added to facilitate documentation
      - rc file
      - -f option, read input pathnames from a file
      - many function names renamed e.g. my_func to myFunc
      - several inconsistencies in output styles fixed
  v0.63 2002-11-09:
      - small bug fix in thumbs style
      - packaging using RPM
  v0.62 2002-10-29:
      - Index image routines use now thumbnail x- and y-dimensions
      - Makefile changes: defaults to GNU/Linux
      - internal changes: started wrapping globals to jpgind_t
  v0.61 2002-10-25:
      - Several new files
      - Single Makefile for all supported platforms (GNU/Linux, Mac OS X,
        Wintel MinGW)
      - Option -H dropped, output always generates HTML pages
      - New style: thumbs (-O style=thumbs)
  v0.60 2002-08-24:
      - Exif date handling with -E min option: now showed on top of image.
      - HTML body text color adjusted according to backgound grayscale value
      - J-Sky (J-Phone mobile browser) output style 
      - strict scaling (-Z) applied also to HTML images
  v0.59 2002-07-08:
      - flag -O include-original
      - flag -O link-original-only (bit buggy, need to cd to image 
        directory first)
  v0.58 2002-05-29: 
      - Fixed bug that mixed page titles if slideshow was selected
      - 90-degree rotation (based on metadata contents)
      - bug with -o flag fixed
      - improved debug info (-E debug)
      - default JPEG quality changed to 95
      - included hyperlink to program homepage (=advertisement)
      - html table output option (-H 2) removed, all output uses tables
      - internal re-organisation, new files local.h, procs.h, procs.c,
        style.h, style.c
  v0.57 2002-03-23: check_args(), title switch (-T), fixed navigation
        links, param_info().
  v0.56 2002-03-21: command_line(), shinkansen output style, small
        fixes to Exif part, imagemap for easy surfing on each page.
  v0.55 2002-03-17: EXIF support using code from Matthias Wandel's 
        jhead program.
  v0.54 2002-02-27: Linux port, compiles using the default Makefile with
        rule 'make linux'
  v0.53 2002-02-16: First Windows port, MinGW compiler, libjpeg was build
        the following way:
        1) Downloaded sources from: 
           ftp://ftp.simtel.net/pub/simtelnet/msdos/graphics/jpegsr6.zip
        2) copy makefile.ansi Makefile
        3) copy jconfig.cfg jconfig.h
        4) Edited Makefile and changed: CC= gcc and RM= del
        5) make

  Copyright (C) 2002 Petteri Kettunen

  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
  (at your option) 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.

  You should have received a copy of the GNU General Public License
  along with this program; if not, write to the Free Software
  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  or see online version from URL http://www.fsf.org/licenses/gpl.html#SEC1