zlib用法简单说明

天云上人

本文的目的是: 简单说明如何把zlib加入到MFC程序中,提供内存压缩功能.

. i: j% w, L2 ?9 `1. 如何获得zlib

zlib的主页是:http://www.zlib.net/
; [5 B# B: b' p
' F/ w* D* g" P* |) e+ G3 w% b2. 用VC++6.0打开

把下载的源代码解压打开,VC6.0的工程已经建好了,在\projects\visualc6. 双击zlib.dsw, 可以在VC++6.0中看到里面有3个工程: zlib 是库文件(编译设置选中 win32 lib debug / release), 工程example 是如何使用 zlib.lib 的示例, 工程minigzip 是如何用 zlib 提供的函数读写.gz文件的示例(*.gz的文件一般Linux下比较常用).
0 y5 M9 p  w( T6 X1 V& i% x- g
/ K. `4 z# ~) h; e/ d! X3. 如何加入到我的工程
: D) ?' M% u. B" X  c0 I
编译好 zlib.lib 后, 你就得到了调用一个静态库所需要的所有文件了(zlib.lib, zlib.h, zconf.h). 如何调用静态库不用我说了吧.
% C1 w5 V0 R- d0 \" v
$ U8 y$ L( v, ]( _  G; E, L& f6 ]4. 用zlib能干什么
" j/ p: T- @" y* m* X/ Z+ {9 ^
  q% v4 u+ P, a! ]7 l先来看看 zlib 都提供了那些函数, 都在zlib.h中,看到一堆宏不要晕,其实都是为了兼容各种编译器和一些类型定义.死死抓住那些主要的函数的原型声明就不会受到这些东西的影响了.
& U# B% D9 N' K: T# R
关键的函数有那么几个:

! }+ x9 s! J0 y" I" Q' [(1)int compress (Bytef *dest,   uLongf *destLen, const Bytef *source, uLong sourceLen);
1 C4 }, k8 g9 Z
把源缓冲压缩成目的缓冲, 就那么简单, 一个函数搞定
6 i% X: U4 d5 K0 j9 m
# W% {. ]1 p- Q# B; Q(2) int compress2 (Bytef *dest,   uLongf *destLen,const Bytef *source, uLong sourceLen,int level);

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

(3) uLong compressBound (uLong sourceLen);
% N  p/ \, @  P5 g0 K( E
计算需要的缓冲区长度. 假设你在压缩之前就想知道你的产度为 sourcelen 的数据压缩后有多大, 可调用这个函数计算一下,这个函数并不能得到精确的结果,但是它可以保证实际输出长度肯定小于它计算出来的长度

! _' F; m/ k) M(4) int uncompress (Bytef *dest,   uLongf *destLen,const Bytef *source, uLong sourceLen);

- S) p( Y* H; M解压缩(看名字就知道了:)

(5) deflateInit() + deflate() + deflateEnd()
" C8 A' Y! B. i6 R
3个函数结合使用完成压缩功能,具体用法看 example.c 的 test_deflate()函数. 其实 compress() 函数内部就是用这3个函数实现的(工程 zlib 的 compress.c 文件)

# A. P) s1 Z# W8 V4 b2 z(6) inflateInit() + inflate() + inflateEnd()

; C( ?6 r" [& L0 J$ S和(5)类似,完成解压缩功能.
4 J' L5 E0 n  q8 c! R7 Y" \( v* v7 g6 q
3 W' h6 D2 g1 n2 K(7) gz开头的函数. 用来操作*.gz的文件,和文件stdio调用方式类似. 想知道怎么用的话看example.c 的 test_gzio() 函数,很easy.
: F% j$ {5 ~/ I# b% J
, e. L3 f; X7 }" j+ T% W(8) 其他诸如获得版本等函数就不说了.
总结: 其实只要有了compress() 和uncompress() 两个函数,在大多数应用中就足够了.

% g* ?0 h" R7 s5 o' V% H: L题外话: 我最初看到zlib的源代码时被好多宏吓倒了,呵呵,后来仔细看下去才发现原来接口那么简单. 至于那些英文说明也没想象中的那么难懂.只要有尝试的勇气,总能有些收获.
* v- q# B2 O  h' w( X( k
本文来自CSDN博客，转载请标明出处：http://blog.csdn.net/querw/archive/2006/12/21/1452041.aspx
3 d# L5 r. j* \- h. b, }; F- q

天云上人

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
   : t( s, S/ S# R( Y4 ^
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
   / e' K( X  Q" h# P$ \
2. <iostream>#include "zlib.h" using namespace
   
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\。
" q7 v. x) k1 Y9 X5 m# F# M