Tnpic - create thumbnails of GIF/JPEG files combined into one JPEG
Copyright (C) 1993-1996 Russell Marks.

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, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.


For the uninitiated...
----------------------

This is a `standalone' re-release of an old utility I bundled with zgv
up until version 2.3. It's rather limited, but for what it does, it
works reasonably well.

If you want a more general util to generate picture file indexes, or
one which supports more formats, I recommend `icontact', from
comp.sources.misc volume 42 (archived at ftp.uu.net I believe,
mirrored at N sites, and on at least one Usenet CD set). It's very
flexible, and frankly is a lot better than tnpic, though possibly a
little slower. The drawbacks are that it requires perl and netpbm, and
that you have to set it up to use fixed-width text for labels to work.
(Look up the `-F' option in the icontact man page for how to change
the font used.)


History
-------

Tnpic was originally part of zgv, but was dropped after zgv 2.3, as it
was (IMHO) obsolete and a ridiculous mess. But *it does work*, so I'm
(finally) releasing it separately in case anybody misses it.

Note that this will almost certainly be the last time I ever bother
doing any hacking on tnpic. If someone else wants to take it over and
release new versions or whatever, no problem, you're welcome.

This version was ripped straight out of zgv 2.3, but has been hacked
just enough to get it to work with v5 (and later) of the IJG's JPEG
library instead of the old v4.


Compiling
---------

[There's an ELF executable here (compiled with gcc 2.7.0 and libc
5.2.16), so you needn't compile it if you don't want to, you can just
do `make install' instead.]

As you may now have gathered, you need the IJG's JPEG library to be
able to compile tnpic. :-) Here's a quote from zgv's README.src
explaining this (the text applies equally to tnpic):

> The Independant JPEG Group's JPEG software is required for zgv to
> compile. In the directory you have the JPEG software in, do a `make
> libjpeg.a', and also make sure JPEGDIR in zgv's Makefile is set to the
> directory you have the JPEG software's source in. You must use at
> least version 5 of the library - version 4 is now not supported, as
> the library underwent quite a rewrite between versions 4 and 5.
> Versions 5, 5a, and 6 have all been tested and all work.
> 
> The README in v5 of the JPEG software says:
> 
> "The "official" archive site for this software is ftp.uu.net (Internet
> address 192.48.96.9).  The most recent released version can always be found
> there in directory graphics/jpeg.  This particular version will be archived
> as graphics/jpeg/jpegsrc.v5.tar.gz."
> 
> ...so look there for the source.
> 
> By the way, if you haven't previously compiled the JPEG software,
> you'll need to copy makefile.ansi to Makefile and do some other stuff;
> see their README and associated files for more info on that. (NB: With
> version 5a and above, you can use the `configure' script as you would
> with GNU stuff, which is much easier.)

Once you've got that sorted out, a simple `make' then `make install'
should suffice.



Contacting me
-------------

No email address at the moment I'm afraid. :-(

Postal address:
		Russell Marks,
		3 Rapley Close,
		Camberley,
		Surrey,
		GU15 4ER,
		United Kingdom.

If you insist on abbreviating my name, please use "R. J. Marks".


Share and enjoy!

-Rus.
