CxImage类库使用说明1

一。CxImage类库简介

这只是翻译了CxImage开源项目主页上的部分简介及简单使用。

CxImage类库是一 个优秀的图像操作类库。它可以快捷地存取、显示、转换各种图像。有的读者可能说，有那么多优秀的图形库，如OpenIL,FreeImage, PaintLib等等，它们可谓是功能强大，齐全，没必要用其它的类库。但我要说，这些类库基本上没有免费的，使用这些类库，你要被这样那样的许可协议所 束缚。在这点上，CxImage类库是完全免费的。另外，在使用上述类库时，你会遇到重重麻烦。因为它们大部分是平台无关的，且用C语言写成，有的还夹杂 着基本的C++ wrapper和成堆德编译选项的声明需要你去处理。而CxImage类库在这方面做得很好。还有让我最看好的，就是作者完全公开了源代码。相对于那些封 装好的图形库和GDI+来说，这一点使我们可以进一步学习各种编解码技术，而不再浮于各种技术的表面。

CxImage是一个可以用于MFC 的C++类，可以打开，保存，显示，转换各种格式的图像文件,比如BMP, JPEG, GIF, PNG, TIFF, MNG, ICO, PCX, TGA, WMF, WBMP, JBG, J2K 等格式的文件。可以实现BMP<->JPG，PNG <>TIFF格式等等的转换。

既可以实现图像文件的类型转换，也可以实现在内存图像数据的类型转换，并且使用很方便。

它的作者是: Davide Pizzolato ,主页: http://www.xdp.it/

首先,到http://www.codeproject.com/bitmap/CXImage.asp 下载它的源文件和Demo例子.

注: 在Codeproject下载这个类,你得先注册一下,因为这个类可是含金量比较高的,下载量比较大的,当然你也会很高兴成为CodeProject的一名成员的,她不收你的费.授权:

License

The class CxImage is free; as for the TIFF, JPEG, PNG and ZLIB libraries : "If you use this source code in a product, acknowledgment is not required but would be appreciated."

CxImage is open source and licensed under the zlib license . In a nutshell, this means that you can use the code however you wish, as long as you don't claim it as your own.

由于很多人上codeproject的时候,老是上不去,所以,你也可以去这个类库的作者--Davide Pizzolato的主页去下载

他的主页还有另外的源代码,有兴趣的也可以看看.

二。编译CxImage类库

作者已经提供了整个类库配置的工程文件CxImgLib.dsw (VC++6.0)，只要打开它进行编译即可。需要大家注意的是:整个CxImage类库非常大。如果你只需要能处理其中的几种格式，编译该类库时，你可以在配置的头文件ximcfg.h 中找到一些编译开关选项来关闭一些图像库。JPG、PNG、TIFF中的每一个库，都会向最终程序增加约100KB的内容。而CxImage类库压缩后只有约60KB。所以，你需要谨慎挑选一些你真正需要的类库。

// 类库配置文件：ximacfg.h
#define CXIMAGE_SUPPORT_JPG 1
// 如果要实现bmp->jpg 则必须打开
#define CXIMAGE_SUPPORT_BMP 1
#define CXIMAGE_SUPPORT_GIF 1
#define CXIMAGE_SUPPORT_JPG 1
// 以上为必须打开,下面的随便............
#define CXIMAGE_SUPPORT_PNG 0 //不使用它
#define CXIMAGE_SUPPORT_MNG 0
#define CXIMAGE_SUPPORT_ICO 1
#define CXIMAGE_SUPPORT_TIF 0 //
#define CXIMAGE_SUPPORT_TGA 0 //
#define CXIMAGE_SUPPORT_PCX 0 //
#define CXIMAGE_SUPPORT_WBMP 0 //
#define CXIMAGE_SUPPORT_WMF 0 //
#define CXIMAGE_SUPPORT_J2K 0   // Beta, use JP2
#define CXIMAGE_SUPPORT_JBG 0

//.............

其他的可以不打开

编译该类库有好几个选择的工程,如下图所示：

各工程的作用对应如下：

CxImage : cximage.lib - static library CxImageCrtDll : cximagecrt.dll - DLL not using mfc CxImageMfcDll : cximage.dll - DLL using mfc Demo : demo.exe - program linked with cximage.lib and the C libraries DemoDll : demodll.exe - program linked with cximagecrt.dll j2k,jasper,jbig,jpeg,png,tiff,zlib : static C libraries

编译这些工程需要耗费几分钟的时间（中间文件可达60MB）。

三。在程序中应用CxImage类库进行图像类型转换

在你的VC工程中使用这个类库，要对工程进行如下设置(Project Settings)：

|- C/C++
|   |- Code Generation
|   |   |- Use run-time library : Multithreaded DLL (must be the same for
|   |   | all the linked libraries) //应该只要是多线程DLL即可，DEBUG的也行
|   |   |- Struct member alignment : must be the same for all the linked libraries
|   |- Precompiled headers : not using precompiled headers
|   |- Preprocessor
|       |- Additional Include Directories: ..\cximage（该处填CxImage里的.h和.cpp文件拷贝并导入工程后所在的文件夹，填写后在工程中include时编译器会查找该文件 夹，故include的文件无需路径）
|- Link
    |- General
        |- Object/library modules: png.lib
                                                       jpeg.lib
                                                      zlib.lib
                                                       tiff.lib
                                                      jasper.lib
                                                      cximage.lib （把需要的lib文件从CxImage中拷贝到工程中的lib文件所在的目录)

并 且从CxImage中将xfile.h、ximacfg.h、ximadef.h、ximage.cpp、ximage.h、xiofile.h、 xmemfile.cpp、xmemfile.h拷贝到工程文件夹下并将CxImage.h文件加入工程中即可。也可以设置vc6的"tools"中的 "include"路径.

下面介绍应用它进行图像类型转换的方式：

1.从一种图像文件类型转换为另一种文件类型(convert from a format to another)

CxImage   image;    // 定义一个CxImage对象

// 从bmp文件转换为jpg文件(bmp -> jpg)
image.Load( " image.bmp " , CXIMAGE_FORMAT_BMP);    // 先装载bmp文件,需要指定文件类型
     // 判断加载的bmp文件是否存在。
if (image.IsValid())... ... {
       // Returns true if the image has 256 colors   and a linear grey scale palette.
    if(!image.IsGrayScale()) image.IncreaseBpp(24);   // param nbit: 4, 8, 24
     image.SetJpegQuality(99);                // 设置图像的压缩质量参数(从0到100，数值越大，质量越高)
     image.Save("image.jpg",CXIMAGE_FORMAT_JPG);          // 把压缩后的图像以jpg文件类型保存起来。
}

// 从png文件转换为tif文件（png -> tif）
image.Load( " image.png " , CXIMAGE_FORMAT_PNG);
if (image.IsValid()) ... {
     image.Save("image.tif",CXIMAGE_FORMAT_TIF);
}

2。加载程序资源图像(load an image resource)

即从程序的资源图像中构建CxImage对象,有如下几种方式：

// Load the resource IDR_PNG1 from the PNG resource type
CxImage * newImage = new CxImage();
newImage -> LoadResource(FindResource(NULL,MAKEINTRESOURCE(IDR_PNG1),
                        " PNG " ),CXIMAGE_FORMAT_PNG);

或者

// Load the resource IDR_JPG1 from DLL
CxImage * newImage = new CxImage();
HINSTANCE hdll = LoadLibrary( " imagelib.dll " );
if (hdll) ... {
     HRSRC hres=FindResource(hdll,MAKEINTRESOURCE(IDR_JPG1),"JPG");
     newImage->LoadResource(hres,CXIMAGE_FORMAT_JPG,hdll);
     FreeLibrary(hdll);
}

或者

// Load a bitmap resource;
HBITMAP bitmap = ::LoadBitmap(AfxGetInstanceHandle(),
                               MAKEINTRESOURCE(IDB_BITMAP1)));
CxImage * newImage = new CxImage();
newImage -> CreateFromHBITMAP(bitmap);