readme.txt

压缩算法的C语言源程序

#######################################################################
#                           CLIB v1.2d                                #
#                A Compression Library for DJGPP                      #
#                          (c)1999 Jay                                #
#######################################################################

Disclaimer
----------
I am not responsible for any bugs in the source code or anything that
happens to your computer cause by the source. Use at own risk. This
code is also freeware. That means you may copy it and distribute it
freely as long as you're not stealing my work and taking credit for it.

Features
--------
CLib features RLE, Huffman, LZW, LZ77, and Deflate compression methods.
Warning: This is still a development version, meaning there is probably
a whole bunch of bugs lurking around.

What's new?
-----------

v1.2d
* Rewritten everything in C. That means it should be C compatible.
  However, many of the cool C++ features used before don't work.
* This version may or may not compile with other compilers...
* Implemented true deflate.... As you can see, I can decompress GZIP
  files. I haven't tried ZIP files yet.
* Implemented a Huffman Lookup table for fast decompression.

v1.0
* First version

Installation Requirements and Instructions
------------------------------------------
You will require DJGPP (http://www.delorie.com/djgpp/) to compile the
sources. Apparently, I've tested this with Borland C++ 4.5 Win32
Console App and it seems to work. Try this on various compilers. 32-bit
compilers only though. However, this is mainly made for DJGPP. This
build was compiled with GCC v2.8.1 so I'm not sure whether other
version work, but it should. To compile all the sources, type `make'
in the main directory of the library. To install the package, you must
copy compress.h from the include directory to the include directory of
your DJGPP directory.  You must also copy libcompress.a from the lib
directory to the DJGPP lib directory.

Files in the package
--------------------
readme.txt			This file
makefile			Makefile for DJGPP
compress.ide			Borland C++ 4.5 IDE
Doc\compress.rtf		Compression Tutorial
Doc\clib.rtf			CLIB's API documentation
Example\gzipc.cpp		GZIP decompressing test file
Example\huff.cpp		Huffman Coding Example
Example\crc.cpp			CRC32 generator
Include\compress.h		CLib header file
Src\deflate.c			Source for deflate algorithm
Src\gslib.c			gsLib wrapper file
Src\huffman.c			Huffman codec
Src\lz77.c			LZ77 codec
Src\lzw.c			LZW codec
Src\rle.c			RLE codec
Src\stream.cpp			File IO for the codecs

Compiling Instructions
----------------------
Always include compress.h in the header file.
eg.
#include <compress.h>
And link with the -lcompress flag.
for eg.
gcc main.c -lcompress -o main.exe

About gsLib
-----------
You're probably wondering about the gslib.c. The truth about CLib, is
that it is infact part of gsLib (a graphics-sound library made by me),
which is also why you may have noticed that the RLE and LZW routines
are based for the decompression of PCX and GIF files.

Credits
-------

David Bourgin - For the LZW source is based on his.
Jean-loup Gailly - A few stuff were borrowed from GZIP.