Generated from README with ROBODoc v3.2.3 on Mon Dec 16 21:55:28 2002
TABLE OF CONTENTS
- jpgind/README
NAME
jpgind -- Program for making web galleries from JPEG/Exif files
FUNCTION
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.
USES
- libjpeg from Independent JPEG group
- EXIF parser code by Matthias Wandel
- GNU getopt.c, getopt.h, and getopt
USAGE
jpgind [options] file...
OPTIONS
-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
RETURN VALUE
0 successful termination
1 error occurred
2 invalid input or command-line switches
PORTABILITY
This program is written in ANSI C. Currently known to compile in following
environments: GNU/Linux, Mac OS X, Wintel (GNU MinGW)
EXAMPLE
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/
AUTHOR
Petteri Kettunen http://www.iki.fi/petterik/
SEE ALSO
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
IDEAS
- Cross-compile GNU/Linux-Wintel (apt-get install mingw32)
BUGS
- Does not scale well to large number of images.
HISTORY
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
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