(C) Simon Kapadia 1997 as part of a MSc Project
Please do not use this software.  It probably won't work, and may break your
machine (and I am not responsible if anything at all happens bad, ok?)
"If it breaks, you get to keep the pieces..."

Driver for the Colour Quickcam under Linux 2.0.30
-------------------------------------------------

This driver contains the following files:

	cam.c		-	The actual driver.
	cam.h		-	General header file for cam applications.
	
	takepic.c	-	Application that takes a series of pictures
				with a pause between each one
	photo.c		-	Uses SVGALIB to display pictures, can write
				them to files if wanted.
	vidcam.c	-	Uses SVGALIB to display a stream of pictures
				as fast as the camera can send them.
	
	Makefile	- 	General Linux Makefile
	

INSTALLATION

First of all, change the two user-definable settings in the Makefile, the
port address and port status (see Makefile for instructions).  Then type
make, and pray :)  Provided nothing goes wrong and you have SVGALIB installed,
you should be fine.  Finally, type make install to actually create the driver
file (/dev/cam).  That's it (in theory).

USAGE

The driver is a kernel module, which means that it must be inserted into the
running kernel code before it can be used.  If you are using kerneld, add the
following entry to /etc/conf.modules:

	alias char-major-60 cam


and kerneld should sort everything out for you.  If you do these things by 
hand, type insmod cam to load the module and rmmod cam to remove it.  Of 
course, you have to have your kernel set up for module usage and modversions, 
but for that you go to the module-HOWTO.

takepic is a simple program which just reads a picture from the cam and throws 
it out to the standard output - redirect it to a file (eg takepic > test.ppm) 
and use something like zgv to view it.

photo is somewhat more complicated, in that it will show you the picture on the 
screen before you save it.  Press any key to take a new picture, s to save the
picture (you will be prompted for a filename), and q to quit.

vidcam turns the qcam into a primitive kind of video camera - it will display 
pictures on your screen as fast as the camera can send them.  Use the z key to 
increase the decimation (worse quality but faster pictures), and Z to decrease 
it.  The standard vi movement keys (h = left, j=down, k=up, l=right) will pan 
the image to the limits of the camera.

