xpcd 0.3.1
==========


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 5 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). You need hpcdtoppm for decoding
the PhotoCD images. And you need an viewer of your choice for displaying
the Images (xv, ImageMagick or something like that).


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.

2) Run './configure'. xpcd will be installed to /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/'

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
     - 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.

Note: 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'.


HOWTO CONFIG ?

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


QUESTIONS OR (I hope not :-) BUGS ?

email them to me.


   Have fun !

----------
kraxel@cs.tu-berlin.de

Gerd Knorr
Dirschauer Strasse 6
10245 Berlin
Germany

