README-file for     Photo-CD software for DOS and OS/2
                    Version 1.5
                    (c) 1993/94 by Holger Hinze

PCD.EXE is a simple program for showing your Photo-CD pictures in OS/2
fullscreen sessions or under DOS (only 386 or higher).

PCD15.ZIP contains the following files:
--------------------------------------
    README.PCD
    PCD.EXE

only needed for OS/2:
    EMX.DLL
    EMXIO.DLL
    VESA_ET4.DLL
    VESA_TR8.DLL
    PCD.ICO

only needed for DOS:
    EMX.EXE




The following configuration is needed for running it under DOS:
==============================================================

    DOS (no DOS session of OS/2)
    CD-ROM drive
    EMX.EXE
    386-processor (or higher)
    VESA bios extension for your graphics card (if not supported directly
       from your cards bios)



The following configuration is needed for running it under OS/2:
===============================================================

    OS/2 2.x
    CD-ROM drive
    Vesa-fullscreendriver VESA_xxx.DLL (see note below)
    emx-DLLs EMX.DLL and EMXIO.DLL (version 0.8h or higher)

You should move VESA_xxx.DLL, EMX.DLL and EMXIO.DLL to a directory mentioned 
somewhere in your LIBPATH.




VESA_xxx.DLL (only for OS/2):
============================
If you have a ET4000 or Trident 8900 based graphics adapter, you can use one of the
included files VESA_ET4.DLL or VESA_TR8.DLL. These DLLs support only 256 colormodes.
For ET4000 hicolor cards or other cards look for the Vesa-package VESA15.ZIP from
Johannes Martin. It contains a ET4000 hicolordriver and information how to generate 
drivers for other cards. (The presentation-manager-driver included there does not
work with this program!).

If you don't use VESA_ET4.DLL, you must set the environment-variable VESADLL to the
VESA-driver you use.

   e.g.  SET VESADLL=VESA_TR8



How to start the program:
=========================

The simplest way to run PCD.EXE is starting it without any parameter.
The program will then ask you for the following parameters:

  -  number of the first picture to show. The number of picture is extended
     by the program to the filename IMGxxxx.PCD, where xxxx is the
     number of the picture.
  -  resolution of the picture. Only the 3 lower resolutions available
     on Photo-CD are possible: 768x512, 384x256, 192x128 pixel.
  -  which mode to show the pictures. You can show it either in 256 color,
     in 32768 color, as grayscale or extract one of the 3 basic colors red, green or blue.

You can add one or more of the following parameters. In this case it 
doesn't ask you for the missing parameters and uses defaultvalues instead of.

   HICOL	use hicolormode
   BW		show as grayscale
                (RGB is default)
   HIRES	show with resolution 768x512 (default)
   MEDRES	show with resolution 384x256
   LORES	show with resolution 192x128
   n		number of the first picture to show (default is 1)
   filename	path and filename of a picture to show
	        (only filenames of the type IMGnnnn.PCD are allowed,
		 PCDPATH will not be added to the filename)

  e.g.  PCD.EXE 5 HICOL    shows IMG0005.PCD in high resolution and hicolor.


After loading the first picture the program will show you the picture number
in the right bottom corner of the screen. (only in graphicmodes with at least
800x600 pixel)
You can change to the next/previous picture by using the keys  ->  and  <- .
While showing a picture the program tries to load the next one. So, if you
change to the next picture by pressing  ->  ,you normally don't have to wait
until the picture has been loaded.
 
You also can change to an other picture by typing the number directly 
(up to 3 decimals). In this case the keys you have pressed are shown 
left to the picturenumber. These numbers are shown in green, if the picture 
can be loaded, and in red, if there are problems (e.g. picture doesn't exist).

To exit the program press the <esc>-key.


You can set the following environment variables for running the program correctly:

   PCDPATH   You can specify the path to search for your pictures.
	     e.g.  SET PCDPATH=C:\PCD\MY_IMAGES\  (must end with '\')

	     If PCDPATH is not defined, the program tries to find a drive
	     containing the directory  \PHOTO_CD\IMAGES\


   PCDRGBVIO Specifies the VESA mode for 256-color and grayscalepictures.
	     You can use any 256 colormode.
	     e.g.  SET PCDRGBVIO=19      in decimal
		   SET PCDRGBVIO=0x13    in hex

	     possible modes are:
		0x013     320x200
		0x101	  640x480
		0x103	  800x600  (default)
		0x105	  1024x768


   PCDHIVIO  Specifies the VESA mode for hicolorpictures.
	     You can use any 32k Hicolormode.
	     e.g.  SET PCDHIVIO=272      in decimal
		   SET PCDHIVIO=0x110    in hex

	     possible modes are:
		0x10d     320x200
		0x110	  640x480
		0x113	  800x600  (default)
		0x116	  1024x768




License:
========
This program is freeware.
You are allowed to copy the program package.

PCD.EXE was written and is Copyright (c) 1993/94 by

	Holger Hinze
	Fliederwg 7
	D-64839 Muenster
	Germany

internet: hinzemue@rbg.informatik.th-darmstadt.de