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

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