zlib用法简单说明

天云上人

本文的目的是: 简单说明如何把zlib加入到MFC程序中,提供内存压缩功能.
; Q4 m7 l2 ^& {" T/ L  ^, ~
3 `" e6 X! S6 W  `1. 如何获得zlib
7 w; F( V: K0 b/ V1 D  j$ D# q
zlib的主页是:http://www.zlib.net/
- g; R& j$ C( H6 ~
2 i: x; {8 `- z9 h9 Y5 D2. 用VC++6.0打开
+ D) @+ r* ?2 y2 r, P% b9 q
: ~3 I% C8 M( V5 _& v4 a' J4 \把下载的源代码解压打开,VC6.0的工程已经建好了,在\projects\visualc6. 双击zlib.dsw, 可以在VC++6.0中看到里面有3个工程: zlib 是库文件(编译设置选中 win32 lib debug / release), 工程example 是如何使用 zlib.lib 的示例, 工程minigzip 是如何用 zlib 提供的函数读写.gz文件的示例(*.gz的文件一般Linux下比较常用).

3. 如何加入到我的工程

编译好 zlib.lib 后, 你就得到了调用一个静态库所需要的所有文件了(zlib.lib, zlib.h, zconf.h). 如何调用静态库不用我说了吧.

4. 用zlib能干什么

) i: l4 ~1 X6 F) y1 B先来看看 zlib 都提供了那些函数, 都在zlib.h中,看到一堆宏不要晕,其实都是为了兼容各种编译器和一些类型定义.死死抓住那些主要的函数的原型声明就不会受到这些东西的影响了.
+ @& Z7 g! [3 }: ?4 F/ o+ U( G. j
7 t  J) g) o  s" }6 g& h关键的函数有那么几个:
7 b( p6 z# K/ L1 G) P6 Z  v6 t
(1)int compress (Bytef *dest,   uLongf *destLen, const Bytef *source, uLong sourceLen);

& h4 B, \# Y' W2 f! H把源缓冲压缩成目的缓冲, 就那么简单, 一个函数搞定

2 P) a5 ]% W  n8 n& V(2) int compress2 (Bytef *dest,   uLongf *destLen,const Bytef *source, uLong sourceLen,int level);

功能和上一个函数一样,都一个参数可以指定压缩质量和压缩数度之间的关系(0-9)不敢肯定这个参数的话不用太在意它,明白一个道理就好了: 要想得到高的压缩比就要多花时间

9 h* Q" K* F( Y( C! e(3) uLong compressBound (uLong sourceLen);

" r. Z$ l$ |' |+ w3 n计算需要的缓冲区长度. 假设你在压缩之前就想知道你的产度为 sourcelen 的数据压缩后有多大, 可调用这个函数计算一下,这个函数并不能得到精确的结果,但是它可以保证实际输出长度肯定小于它计算出来的长度

(4) int uncompress (Bytef *dest,   uLongf *destLen,const Bytef *source, uLong sourceLen);
$ G0 n7 c  H2 T2 Q) \7 E1 P
7 l( q  L% l( x" L) P解压缩(看名字就知道了:)

% |. N  v$ e3 o5 ]2 }) O, V(5) deflateInit() + deflate() + deflateEnd()
1 r2 J% a* p: q+ E7 ~
5 d" z+ ^5 ~5 h& y5 w/ m" i3个函数结合使用完成压缩功能,具体用法看 example.c 的 test_deflate()函数. 其实 compress() 函数内部就是用这3个函数实现的(工程 zlib 的 compress.c 文件)

* d, s, y8 d* e(6) inflateInit() + inflate() + inflateEnd()
3 @! O3 N/ n+ Q8 W) d  K+ c
和(5)类似,完成解压缩功能.
) q2 h( V/ d- F
(7) gz开头的函数. 用来操作*.gz的文件,和文件stdio调用方式类似. 想知道怎么用的话看example.c 的 test_gzio() 函数,很easy.

( T6 X3 P2 o7 l4 j(8) 其他诸如获得版本等函数就不说了.
总结: 其实只要有了compress() 和uncompress() 两个函数,在大多数应用中就足够了.

题外话: 我最初看到zlib的源代码时被好多宏吓倒了,呵呵,后来仔细看下去才发现原来接口那么简单. 至于那些英文说明也没想象中的那么难懂.只要有尝试的勇气,总能有些收获.
* K8 F% X: o- i+ g' g; h
本文来自CSDN博客，转载请标明出处：http://blog.csdn.net/querw/archive/2006/12/21/1452041.aspx

天云上人

zlib 的安装

　　libpng 是一套免费的、公开源代码的程序库，支持对 PNG 图形文件的创建、读写等操作。libpng 使用 zlib 程序库作为压缩引擎，zlib 也是著名的 gzip (GNU zip) 所采用的压缩引擎。

　　我们首先安装zlib，从其官方网站下载最新的源程序，不妨假设文件名是zlib-1.1.4.tar.gz。网址：http://www.gzip.org/zlib/。

　　在 D:\ 建立 libpng 目录，将 zlib-1.1.4.tar.gz 释放到这个目录。尽管没有合适的makefile，我们仍然可以直接编译链接 zlib.lib：

1. D:\libpng\zlib-1.1.4>bcc32 -c -O2 -6 -w-8004 -w-8057 -w-8012 *.cBorland C++ 5.5.1 for Win32 Copyright (c) 1993, 2000 Borlandadler32.c:compress.c:crc32.c:deflate.c:example.c:gzio.c:infblock.c:infcodes.c:inffast.c:inflate.c:inftrees.c:infutil.c:maketree.c:minigzip.c:trees.c:uncompr.c:zutil.c: D:\libpng\zlib-1.1.4>tlib zlib.lib +adler32.obj +compress.obj +crc32.obj+deflate.obj +gzio.obj +infblock.obj +infcodes.obj
   
2. +inffast.obj +inflate.obj +inftrees.obj +infutil.obj +maketree.obj
   
3. +trees.obj+uncompr.obj +zutil.obj
   
4. TLIB 4.5 Copyright (c) 1987, 1999 Inprise Corporation

复制代码

　　注意，在 tlib 的命令行中，没有 example.obj 和 minigzip.obj。接下来，测试 zlib.lib 是否编译成功，执行：

1. D:\libpng\zlib-1.1.4>bcc32 minigzip.obj zlib.libBorland C++ 5.5.1 for Win32 Copyright (c) 1993, 2000 BorlandTurbo Incremental Link 5.00 Copyright (c) 1997, 2000 Borland D:\libpng\zlib-1.1.4>bcc32 example.obj zlib.libBorland C++ 5.5.1 for Win32 Copyright (c) 1993, 2000 BorlandTurbo Incremental Link 5.00 Copyright (c) 1997, 2000 Borland D:\libpng\zlib-1.1.4>exampleuncompress(): hello, hello!gzread(): hello, hello!gzgets() after gzseek: hello!inflate(): hello, hello!large_inflate(): OKafter inflateSync(): hello, hello!inflate with dictionary: hello, hello!

复制代码

执行 example.exe，看见“hello, hello!”，表明生成的 zlib.lib 是好的。

　　zlib 是通用的压缩库，提供了一套 in-memory 压缩和解压函数，并能检测解压出来的数据的完整性(integrity)。zlib 也支持读写 gzip (.gz) 格式的文件。下面介绍两个最有用的函数——compress 和 uncompress。

1. int compress(Bytef *dest, uLongf *destLen, const Bytef *source, uLong sourceLen);

复制代码

　　compress函数将 source 缓冲区中的内容压缩到 dest 缓冲区。 sourceLen 表示source 缓冲区的大小(以字节计)。注意函数的第二个参数 destLen 是传址调用。当调用函数时，destLen表示 dest 缓冲区的大小，destLen > (sourceLen + 12)*100.1%。当函数退出后，destLen 表示压缩后缓冲区的实际大小。此时 destLen / sourceLen 正好是压缩率。

　　compress 若成功，则返回 Z_OK；若没有足够内存，则返回 Z_MEM_ERROR；若输出缓冲区不够大，则返回 Z_BUF_ERROR。

1. int uncompress(Bytef *dest, uLongf *destLen, const Bytef *source, uLong sourceLen);

复制代码

　　uncompress 函数将 source 缓冲区的内容解压缩到 dest 缓冲区。sourceLen 是 source 缓冲区的大小(以字节计)。注意函数的第二个参数 destLen 是传址调用。当调用函数时，destLen 表示 dest 缓冲区的大小， dest 缓冲区要足以容下解压后的数据。在进行解压缩时，需要提前知道被压缩的数据解压出来会有多大。这就要求在进行压缩之前，保存原始数据的大小(也就是解压后的数据的大小)。这不是 zlib 函数库的功能，需要我们做额外的工作。当函数退出后， destLen 是解压出来的数据的实际大小。

　　uncompress 若成功，则返回 Z_OK ；若没有足够内存，则返回 Z_MEM_ERROR；若输出缓冲区不够大，则返回 Z_BUF_ERROR。若输入数据有误，则返回 Z_DATA_ERROR。

　　zlib 带的 example.c 是个很好的学习范例，值得一观。我们写个程序，验证 zlib 的压缩功能。所写的测试程序保存为 testzlib.cpp ，放在 zlib-1.1.4 目录下。程序源代码：

1. // testzlib.cpp 简单测试 zlib 的压缩功能#include <cstring>#include <cstdlib>#include
   . Y0 p; \% i6 j$ N9 L* C: P
2. <iostream>#include "zlib.h" using namespace
   " `1 [* [& i" G3 s" q; m
3. std; int main(){int err;Byte compr[200], uncompr[200];// big enoughuLong comprLen, uncomprLen;const char* hello = "12345678901234567890123456789012345678901234567890";uLong len = strlen(hello) + 1;comprLen = sizeof(compr) / sizeof(compr[0]);err = compress(compr, &comprLen, (const Bytef*)hello, len);if (err != Z_OK) {cerr << "compess error: " << err << '\n';exit(1);}cout << "orignal size: " << len << " , compressed size : " << comprLen << '\n';strcpy((char*)uncompr, "garbage");err = uncompress(uncompr, &uncomprLen, compr, comprLen);if (err != Z_OK) {cerr << "uncompess error: " << err << '\n';exit(1);}cout << "orignal size: " << len << " , uncompressed size : " << uncomprLen << '\n';if (strcmp((char*)uncompr, hello)) {cerr << "BAD uncompress!!!\n";exit(1);} else {cout << "uncompress() succeed: \n" << (char *)uncompr;}}

复制代码

编译执行这个程序，输出应该是

1. D:\libpng\zlib-1.1.4>bcc32 testzlib.cpp zlib.lib D:\libpng\zlib-1.1.4>testzliborignal size: 51 , compressed size : 22orignal size: 51 , uncompressed size : 51uncompress() succeed:12345678901234567890123456789012345678901234567890

复制代码

至此， zlib的安装任务算是完成了。为了以后使用方便，我将zlib.lib、zlib.h、zconf.h拷贝到D:\mylibs\。
# d4 ]* l7 x. C