zlib用法简单说明

天云上人

本文的目的是: 简单说明如何把zlib加入到MFC程序中,提供内存压缩功能.
$ S1 w( Y3 d/ k# q9 R* \
1. 如何获得zlib
- R) z' v$ u7 V. I5 ^- D7 Y
9 h- F: t; c* k+ C( O3 l/ kzlib的主页是:http://www.zlib.net/
  t+ c2 P' S7 k' }8 P; a  @
8 w! ^1 j* V9 i# I* j$ @1 M: K2. 用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下比较常用).
4 J4 O, t- T. u( k
3. 如何加入到我的工程
3 i8 L* O' \7 Z. Y8 B
$ m+ `! B& t6 h" k编译好 zlib.lib 后, 你就得到了调用一个静态库所需要的所有文件了(zlib.lib, zlib.h, zconf.h). 如何调用静态库不用我说了吧.

" c* {5 g+ k# U4 b# s2 K4. 用zlib能干什么
7 Z; L) z- V- G# G5 A: ~
+ o4 i9 ?4 I. M8 s# P, D先来看看 zlib 都提供了那些函数, 都在zlib.h中,看到一堆宏不要晕,其实都是为了兼容各种编译器和一些类型定义.死死抓住那些主要的函数的原型声明就不会受到这些东西的影响了.
% O6 @6 ^6 \# H! {7 ~' l9 N: p
: n' q2 J$ m5 y, _关键的函数有那么几个:

+ \6 _) b/ p  U  x; L  t2 r% {(1)int compress (Bytef *dest,   uLongf *destLen, const Bytef *source, uLong sourceLen);

把源缓冲压缩成目的缓冲, 就那么简单, 一个函数搞定

4 h3 f5 C% u  Q+ ^6 x: V2 [% P(2) int compress2 (Bytef *dest,   uLongf *destLen,const Bytef *source, uLong sourceLen,int level);

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

(3) uLong compressBound (uLong sourceLen);
  F6 z- W# P2 C5 S, R6 E/ X" r  i" s/ x! h
计算需要的缓冲区长度. 假设你在压缩之前就想知道你的产度为 sourcelen 的数据压缩后有多大, 可调用这个函数计算一下,这个函数并不能得到精确的结果,但是它可以保证实际输出长度肯定小于它计算出来的长度
/ n% _- Y- g+ R6 [) Q
(4) int uncompress (Bytef *dest,   uLongf *destLen,const Bytef *source, uLong sourceLen);

( M1 h$ F5 x; ~6 |5 h4 I  K$ A解压缩(看名字就知道了:)

9 L- i" ^& J( v$ O6 V1 k  B) P. c( H" E(5) deflateInit() + deflate() + deflateEnd()
) K- Y% h/ K% v% M; \: o
3个函数结合使用完成压缩功能,具体用法看 example.c 的 test_deflate()函数. 其实 compress() 函数内部就是用这3个函数实现的(工程 zlib 的 compress.c 文件)
. z9 s7 U/ u7 U" S, F
! o% m' N' N% h+ D9 B' P(6) inflateInit() + inflate() + inflateEnd()

7 W. _& W" W& h# r和(5)类似,完成解压缩功能.
. L6 ^! S  [  `8 K$ }0 {
(7) gz开头的函数. 用来操作*.gz的文件,和文件stdio调用方式类似. 想知道怎么用的话看example.c 的 test_gzio() 函数,很easy.
8 A* a- J/ i$ _8 \$ i
(8) 其他诸如获得版本等函数就不说了.
/ t  S) }( A' m4 Y! d总结: 其实只要有了compress() 和uncompress() 两个函数,在大多数应用中就足够了.

题外话: 我最初看到zlib的源代码时被好多宏吓倒了,呵呵,后来仔细看下去才发现原来接口那么简单. 至于那些英文说明也没想象中的那么难懂.只要有尝试的勇气,总能有些收获.
6 x4 o3 f; A# B# I6 s% a! n3 c- J
本文来自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
   % L" W. o7 H! |/ Q  X
2. +inffast.obj +inflate.obj +inftrees.obj +infutil.obj +maketree.obj
   " Q6 |$ e* s$ F+ F+ {
3. +trees.obj+uncompr.obj +zutil.obj
   # A9 x* K2 _4 K5 \3 z! s$ G# X
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
   , M1 M  |4 ]) |+ [
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\。
7 o3 {7 z" V7 e% k* ]1 d1 Z- |