
                                PhotoCD package
                                       
1. What is it?

   This is a package with a lot of PhotoCD related stuff, currently still
   BETA:
   
   libpcd
          A small library for PhotoCD access, see [1]the librarys README
          file for details
          
   ppm
          A program which reads PhotoCD images and writes ppm. If the
          configure script finds the JPEG library installed on your
          system, it will be compiled with JPEG support.
          
   pcdview
          A simple viewer for PhotoCD images. Works both with X11 and the
          linux svgalib (in one binary). svgalib support is optional, so
          it should compile on non-linux systems too.
          
   plug
          A [2]Gimp file plug-in for PhotoCD access.
          
2. Compiling

   Typing './configure && make' should do the trick. The configure script
   has the usual options.
   
   Using '--without-svga' you can disable svgalib support. Required only
   if you have installed svgalib, else svgalib support is switched off
   automatically.
   
   If the configure-script fails to find the gimp-lib, you can give a
   hint using '--with-gimp=/usr/src/wherever-gimp-is/plug-ins'
   
   The viewer can be compiled using either Motif or Athena widgets. The
   configure script should manage this (tries Motif, 3D-Athena, Athena in
   that order), but if you don't like it this way or if you have trouble,
   you can use the --with-widgets=(motif|xaw3d|xaw) option to select a
   widget set explicitly.
   
   NO, I will not provide any binaries. Either you have Motif
   (development), or you have to go with the Athena widgets. Or you ask
   somebody else for binaries...
   
3. Installing

   By hand. Don't forget the app-defaults for pcdview, it would'nt work
   else.
   
4. Program description

   pcdview and ppm give a short help page if started without options. For
   ppm this should be enouth, for pcdview here are some comments:
   
   The program works both with and without X11. It takes a list of
   filenames as command line arguments and allows you to browse them. The
   X11 support is'nt perfect currently (see BUGS below).
   
   When started from the console (no X11), the program tries to guess a
   good graphic mode depending on the image size. Expect that it uses
   every graphic mode it finds. _Be sure your monitor can display all the
   modes you have in your svgalib config file before using this Program_.
   
   With X11 you can browse using the nice buttons & scrollbars, on the
   console you can navigate with the following keys:
   
   cursor keys
          scroll image (if it is too big for your screen)
          
   ESC, Q
          quit
          
   PgDn, SPACE
          next image
          
   PgUp
          previous image
          
   <number>G
          jump to an image. Works much like jumping to a line in less or
          vi.
          
   BUGS:
     * svgalib: Truecolor should work, but is completely untested.
     * X11: Only TrueColor and 8bit PseudoColor visuals are supported.
     * X11: You can't jump to a image, only next/previous image works.
       
5. plug, the Gimp plug-in

   Place it among the other plugins and add a line to your .gimprc,
   that's all. It supports both the thumbnails file (overview.pcd) and
   the normal image files (img????.pcd in the images subdirectory).
   Rename it if you thing plug is'nt a good name.
   
6. TODO List

     * improve pcdviews X11-support (see bug-list)

References

   1. file://localhost/home/kraxel/src/libpcd/libpcd/README.html
   2. http://www.xcf.berkeley.edu/~gimp/
