Predictive Image Codec
First release
/Mic, 2002


What is this?
-------------
PIC is a library for doing lossless coding/decoding of images. At the moment it
handles 8-bit and 24-bit images. Typical compression ratios are between 1.5:1 and 2.5:1.


Usage
-----

function pic_encode(sequence image, integer fn)

	Encodes 'image' and writes the result to 'fn'. 'image' should look like this:

		{atom pointerToBitmapData,
   		 integer width,
		 integer height,
		 integer bitsPerPixel}

	'fn' should be a file opened for binary output [ open("a_file","wb") ].
	The returned value is the number of bytes written to 'fn', or zero if
	the encoding failed.


function pic_decode(integer fn, sequence image)

	The opposite of pic_encode(). Decodes the data in 'fn' and writes it to
	the address pointed to by the first element of 'image'. 
