This is an early alpha version of the OV518/OV518+ decompression code. With it,
you can decode an image downloaded from your camera. Please note that this code
is still under development, and may not work very well yet.

COMPATIBILITY:
 - OV518:	Tested; works.
 - OV518+:	Driver does not work yet.
 - OV6630:	Tested; works.
 - OV6630AE:	Tested; works.
 - OV6630AF:	Not tested; should work.
 - OV7620:	Only used with OV518/OV518+; may require driver changes.

INSTALLATION:

1. Run "make" from this directory

2. Install the latest ov511 driver and make sure your camera is detected 

USAGE:

First, you must set up the driver properly:

   1. Load the ov511 driver as follows:
	 modprobe ov511 dumppix=1
      If the driver is in the current directory, use "insmod ov511.o dumppix=1"
      instead.

   2. Plug in your camera. Make sure its light comes on.

   3. If you have more than one video device, determine what minor number the
      camera is using. The output of "dmesg" will tell you this. This number
      tells you whether the camera is at /dev/video0, /dev/video1, etc.

To use this application:

   1. If the camera is at something besides /dev/video0, edit grabimage.

   2. If you do not have an image viewer called /usr/bin/ee, edit grabimage to
      point to your favorite viewer (must be capable of viewing PNG files).

   3. Run ./grabimage

   4. A compressed data file called "out.raw" and an image called "out.png"
      will be created. You can use the individual commands in the "grabimage"
      script to generate these manually if you wish.

   5. If you notice that the quality is much worse than with a previous version,
      test with the old iDCT code by running "make clean" and "make oldidct".

KNOWN PROBLEMS:

   Driver (ov511) issues:

   - Sometimes, a captured image will be all black or "cut off" partway through.
     This is due to at least one bug in the driver that I have not been able to
     fix yet.

   - The driver does not support the OV518's dynamic quantization feature, so
     the image may look "blocky" or too dark/light. (I do not know the proper
     settings to make the quantization tables appear at the end of the image
     data, or how to convert them into data the decompressor understands.)

   - OV518+ is not supported yet. You may be able to get an image, but it will
     almost certainly be corrupted.

   - Resolutions besides 320x240 may not work. Note that d518 is hardcoded to
     this size.

   Problems with this (d518) code:

   - Color is disabled by default, since I don't understand what colorspace the
     data is in yet. (It doesn't appear to be normal U/V data). Remove the NOUV
     #define at the top of d518.c to enable it.
