xpcd 1.01
=========


WHAT IS xpcd ?

xpcd is an X11-based Program for handling PhotoCD-images. You can select the
images with your mouse, preview the image in a small window, and load the
image with any of the 6 possible resolutions. You can also select a part of
the Image with your mouse and load only the selected part.


WHAT I NEED TO RUN xpcd ?

You need to have X11 running (of course). And you need either a viewer
of your choice (xv, ImageMagick, ...) or The GIMP for displaying the
Images.

hpcdtoppm is required too, but I included it. hpcdtoppm is (c) Hadmut
Danisch, see the manpage for his copy policy (basically free for
noncommercial use). The original sources are in the hpcdtoppm-0.6
directory. Makefile is completely rewritten (to fit the configure
script), other files are untouched.


HOWTO INSTALL ?

1) Edit the Xpcd.ad file and fill in your default viewer. May be you want to
   change some options too. See the comments in this file for details.

   NOTE 1: the viewer configuration has changed from 0.3.2 to
   0.3.3!. The viewer gets the image from stdin now!

2) Run './configure'. xpcd and hpcdtoppm are installed in /usr/local
   by default. If you want to install it somewhere else (may be into
   the X11-tree) enter something like './configure --prefix=/usr/X11R6'

   If you want to have xpcd and GIMP work together, run
   './configure --with-gimp' to compile in gimp-support. Tell GIMP
   about xpcd by adding a line like
       file-plug-in xpcd 000 "xpcd" "pcd"
   to your $HOME/.gimprc file. And don't forget to check the
   plug-in-path variable.

3) Run 'make'. This should compile everything. If not, send me an email.
   And don't forget to include the following information:
     - Which flower of UNIX and which compiler you are using
       (chances are bad with a non-ansi compiler. Use gcc instead)
     - the config.h file produced by the 'configure' script
     - and - of cource - the error-messages.
   Even better (if you have solved the problem yourself) is a context diff
   with a few words about the changes.

4) Run 'make install' to install it.

Note1:  If the 'configure' script finds the Xaw3d library, xpcd will
        be linked using the 3D Athena Widgets. If you don't like this,
        edit the Makefile before running 'make'.

Note 2: There is a nice tcl/tk (tk 4.0) setup script now. It is a
        graphical front end for the configure script and make. run
        './setup' if you want to try it.
        You still have to edit the Xpcd.ad and $HOME/.gimprc files
        yourself. And the more advanced features of the ./configure
        scripts (like building in a different directory) can't be used
        this way.


HOWTO CONFIGURE ?

There are some command line options and X resources for that. See the comments
in Xpcd.ad the man-Page for more information.


HOWTO USE ?

Simply run it, there is'nt much what can go wrong.

For using with The GIMP: Load a single image file or the thumbnails
(photo_cd/overview.pcd) to startup xpcd.


QUESTIONS OR (I hope not :-) BUGS ?

email them to me.

   Have fun !


--
Gerd Knorr <kraxel@cs.tu-berlin.de>
