【转】zlib 与 libpng 的配置与使用 part 3 libpng的安装与生成PNG图片

libpng 的安装

接下来，安装 libpng 的过程要稍微轻松些。先下载最新的 libpng 程序库源文件。网址是http://sourceforge.net/projects/libpng/或http://www.libpng.org/pub/png/。不妨设下载的文件是 libpng-1.2.5.tar.gz，将这个文件释放到D:/libpng/。

修改D:/libpng/libpng-1.2.5/scripts/makefile.bc32，这是为Borland C++ 32-bit 版准备的 makefile。将第12行的ZLIB_DIR=../zlib改为ZLIB_DIR=D:/mylibs，再将第20行的#TARGET_CPU=6前的井号(#)去掉。然后执行

D:/libpng/libpng-1.2.5>make -fscripts/makefile.bc32

MAKE Version 5.2  Copyright (c) 1987, 2000 Borland

 

D:/libpng/libpng-1.2.5>pngtest

Testing libpng version 1.2.5

   with zlib   version 1.1.4

. . .

 PASS (9782 zero samples)

. . .

libpng passes test

看到“9782 zero samples”字样，表明 libpng 安装成功。新生成的 pngout.png应该与原有的 pngtest.png 完全一样。将 png.h、pngconf.h 连同编译生成的libpng.lib 一起拷贝到D:/mylibs/。

生成 PNG 文件

我们自己写一两个程序来测试 libpng 生成 PNG 文件的功能。testpng1.cpp 生成灰度(gray)图象；testpng2.cpp 生成256色图象，其中调色盘(palette)有多种配置。这两个程序生成的图片文件分别展示于图1和图2中。编译参数为：

bcc32 -Id:/mylibs -Ld:/mylibs testpng1.cpp libpng.lib zlib.lib

为了日后使用方便，我把D:/mylibs/ 加入到 BCC 5.5 的 include 搜索路径和 lib 搜索路径中。

// testpng1.cpp

// test for black & white pictures.

// 请下载文章的配套源码 http://www.chenshuo.com

testpng1.cpp 和 testpng2.cpp 的差别在png_set_IHDR这行，前一个是png_set_IHDR(png_ptr, info_ptr, width, height, 8, PNG_COLOR_TYPE_GRAY, ...);，
后一个是
png_set_IHDR(png_ptr, info_ptr, width, height, 8, PNG_COLOR_TYPE_PALETTE,  ...);。

// testpng2.cpp

// test for colorful pictures

// 请下载文章的配套源码 http://www.chenshuo.com

 

图1 灰度 PNG 图片	图2 彩色 PNG 图片

libpng 带的 example.c 是很好的学习范例。使用 libpng 时，先要 include png.h。这个头文件包含了 libpng 自定义的许多类型，如程序中出现的 png_struct、png_info 等等，前者是 libpng 内部使用的结构体，后者用来表示某个 PNG 文件的相关信息。

编写生成PNG的程序先声明几个必要的变量，其中 png_structp 就是 png_struct* ：

    FILE *fp;

    png_structp png_ptr;

    png_infop info_ptr;

    png_colorp palette;

然后以 binary write 方式打开欲写入的 PNG 文件。

    fp = fopen(filename.c_str(), "wb");

欲使用 libpng ，先分配并初始化 png_struct ：

    png_ptr = png_create_write_struct(PNG_LIBPNG_VER_STRING, NULL, NULL, NULL);

然后以 png_ptr 为参数初始化 info_ptr 。以后用 png_get_*() 或 png_set_*() 函数来读取或设置 PNG 文件的属性。

    info_ptr = png_create_info_struct(png_ptr);

设置错误处理方式，也可以在第6行指定处理错误的 callback 函数。

    if (setjmp(png_jmpbuf(png_ptr)))

    {

        // . . .

    }

接下来告诉 libpng 用 fwrite 来写入 PNG 文件，并传给它已按二进制方式打开的 FILE* fp ：

    png_init_io(png_ptr, fp);

设置 PNG 文件的基本属性，如高度、宽度、色深(单色、16色、256色或真彩色)、色彩类型(灰度、调色板、RGB)等等。这里我们生成一个256 (2⁸=256)色、采用调色板(PNG_COLOR_TYPE_PALETTE )的 PNG 文件。

    const int width  = 120;

    const int height = 512;

 

    png_set_IHDR(png_ptr, info_ptr, width, height, 8, PNG_COLOR_TYPE_PALETTE,

        PNG_INTERLACE_NONE, PNG_COMPRESSION_TYPE_BASE, PNG_FILTER_TYPE_BASE);

接下来设置调色板，先分配空间。常数 PNG_MAX_PALETTE_LENGTH 的值是256：

    palette = (png_colorp)png_malloc(png_ptr,

            PNG_MAX_PALETTE_LENGTH * sizeof (png_color));

这里的 png_color 表示调色板中某一种颜色的 RGB 分量。

typedef struct png_color_struct

{

   png_byte red;

   png_byte green;

   png_byte blue;

} png_color;

然后用自己写的 set_palette 函数设置调色板。

    set_palette(palette, RED_BLACK);

set_palette 函数能生成三种类型的调色板， GRAY 灰度、 RED_BLACK 红与黑、 SPECTRUM 频谱。

其中生成 GRAY 调色板的代码是：

for (int i = 0; i < PNG_MAX_PALETTE_LENGTH; ++i ) {

    palette[i].red = palette[i].green = palette[i].blue = i;

}

告诉 libpng 采用我们准备好的调色板，并写 PNG 文件的头部。

    png_set_PLTE(png_ptr, info_ptr, palette, PNG_MAX_PALETTE_LENGTH);

    png_write_info(png_ptr, info_ptr);

在这些准备工作做完之后，进入最关键的一步——绘制图片内容，这里我们只是依次使用调色板的各种颜色来绘制水平直线。我们准备足够大的一块内存 image 来表示整幅图像中的所有点，这些点按从左到右，从上到下的顺序排列。注意，PNG 文件是行优先，在写入 PNG 文件时，不用告诉它整幅图形在哪，只要告诉它每一行(由数组 row_pointers 表示)在哪就行了。所以如果图像中某些行是相同的，就可以让行指针 row_pointer 重复指向这些行的地址，这样能节省内存空间。我写的这个程序没有采用这个办法，必尽内存不是什么大问题。

    png_uint_32 k;

    png_byte image[height][width];

    png_bytep row_pointers[height];

 

    for (k = 0; k < height; k++) {

        memset(image[k], k / 2, width);

        row_pointers[k] = image[k];

    }

接下来一次写入整幅图像，是最省力的办法：

    png_write_image(png_ptr, row_pointers);

末了，进行必要的扫尾工作：

    png_write_end(png_ptr, info_ptr);

    png_free(png_ptr, palette);

    png_destroy_write_struct(&png_ptr, &info_ptr);

 

    fclose(fp);

至此，大功告成。