CxImage类库

一.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位于所有其他模块的顶部。这不是一个完全的符合OOP的方式，但是至少从最初的版本一直到现在，它都工作得很好。现在想要改变整个结构，已经太晚了。但是，你总是可以使用这些继承类来操作相应格式的图像，例如你可以使用CxImageTIF来保存多页的TIFF文件。这样显得非常直观。

  连接所有模块和C库的是CxFile。这是一个虚类，它提供了标准的方法，用于访问硬盘或者内存的文件数据。 
 
  CxImage的继承树
  一个CxImage对象基本上对应于一副位图，同时添加了一些额外的成员变量用于存储一些有用的信息。

class CxImage
  {
  ...
  protected:
  void* pDib;            //包含文件头，调色板和像素数据
  BITMAPINFOHEADER head; //标准文件头
  CXIMAGEINFO info;      //扩展信息
  BYTE* pSelection;      //选区
  BYTE* pAlpha;          //alpha通道
  CxImage** ppLayers;     //普通层
  CxImage** ppFrames;     //动画的帧
  }
CxImage::head 是位图文件的文件头，而CxImage::pDib就是一个普通的位图（就像你在CxImageBMP::Encode中看到的一样）。  
CxImage::info 是一个方便的信息容器。这些信息被不同的文件格式所共享，同时供所有成员函数访问。
typedef struct tagCxImageInfo {
    DWORD   dwEffWidth;       //双字节对齐宽度
    BYTE*   pImage;           //图像数据
void*   pGhost;           //如果这是一个备份(ghost)，
          //则pGhost指向它的原始对象 
    DWORD   dwType;           //原始图像格式
    char    szLastError[256]; //调试信息，最后的错误信息
    long    nProgress;        //进度
    long    nEscape;          //取消
    long    nBkgndIndex;      //GIF, PNG, MNG使用
    RGBQUAD nBkgndColor;      //RGB透明使用
    BYTE    nQuality;         //JPEG使用
    long    nFrame;           //TIF, GIF, MNG使用，表示当前活动帧
    long    nNumFrames;       //TIF, GIF, MNG使用，表示总帧数                        
    DWORD   dwFrameDelay;     //GIF, MNG使用，表示帧的延迟
    long    xDPI;             //水平分辨率  
    long    yDPI;             //垂直分辨率  
    RECT    rSelectionBox;    //对象的外包围框
    BYTE    nAlphaMax;        //最大透明度
bool    bAlphaPaletteEnabled;  //如果调色板中的alpha值是启用的，
     //则这个变量为true 
bool    bEnabled;         //启用绘制函数
    long    xOffset;
    long    yOffset;
DWORD   dwEncodeOption;   //GIF, TIF使用:
    // 0=def.1=unc,2=fax3,3=fax4,
                              // 4=pack,5=jpg
    RGBQUAD last_c;           //用于优化GetNearestIndex
    BYTE    last_c_index;
    bool    last_c_isvalid;
    long    nNumLayers;
    DWORD   dwFlags;
} CXIMAGEINFO;

  CxImage的不同层
  CxImage对象同样是图层的集合，每个图层的缓冲区只在需要的时候申请。
  CxImage::pDib是背景图像。 CxImage::pAlpha是透明层。CxImage::pSelection是选区层，用于创建要对图像的感兴趣区域进行处理的选择区域。在这三个特殊层之上，你可以添加通用的其他层，这些层都保存在CxImage::ppLayers中。通用层也是完整的CxImage对象，所以你可以创建复杂的嵌套层。CxImage::ppFrames 为动态图像(GIF)所预留。 

 在CxImage中添加自定义的函数 
  为CxImage添加一个新的图像处理函数并不困难。在这里，我将以CxImage::Jitter为例子，描述如何为CxImage添加自定义的函数。虽然这个函数很简单， 但是它却展示了使用CxImage时所需要注意的方方面面。

  首先，我们需要声明这个函数：

bool Jitter(long radius=2)

  在ximage.h头文件的CXIMAGE_SUPPORT_DSP部分，你可以在public区域的任何部分声明这个函数。

  现在，我们开始定义这个函数：

bool CxImage::Jitter(long radius)
{
    // 检查图像是否合法，这应当是这个函数的第一行
    if (!pDib) return false;
    
    // 局部变量
    long nx,ny;
    
    // 临时图像，用于存储算法的部分结果
    CxImage tmp(*this,pSelection!=0,true,true);
    
    // 限制函数仅仅作用在选区（通过Selection...()函数定义）的最小区域
    // 这将加快整个循环的速度，提高算法效率
    long xmin,xmax,ymin,ymax;
    if (pSelection){
        xmin = info.rSelectionBox.left; xmax = info.rSelectionBox.right;
        ymin = info.rSelectionBox.bottom; ymax = info.rSelectionBox.top;
    } else {
        xmin = ymin = 0;
        xmax = head.biWidth; ymax=head.biHeight;
    }
    
    // 主循环 : 垂直方向扫描图像
    for(long y=ymin; y <ymax; y++){
    
        // 监视循环的进度
        info.nProgress = (long)(100*y/head.biHeight);
    
        // 检查应用程序是否已经退出
        if (info.nEscape) break;
    
        // 主循环 : 水平方向扫描图像
        for(long x=xmin; x<xmax; x++){
    
        // 如果选区功能启用了，则仅仅处理选区内部的像素
#if CXIMAGE_SUPPORT_SELECTION
            if (SelectionIsInside(x,y))
#endif //CXIMAGE_SUPPORT_SELECTION
            {
                // 主算法
                nx=x+(long)((rand()/(float)RAND_MAX - 0.5)*(radius*2));
                ny=y+(long)((rand()/(float)RAND_MAX - 0.5)*(radius*2));
                if (!IsInside(nx,ny)) {
                    nx=x;
                    ny=y;
                }

                // 保存结果到临时图像中.
                // 如果可以，24位图像请使用PixelColor，
                // 而8，4和1位图像请使用PixelIndex，这样可以加快速度。
                if (head.biClrUsed==0){
                    tmp.SetPixelColor(x,y,GetPixelColor(nx,ny));
                } else {
                    tmp.SetPixelIndex(x,y,GetPixelIndex(nx,ny));
                }

                // 如果启用了透明度功能，则处理透明图层中的像素 
#if CXIMAGE_SUPPORT_ALPHA
                tmp.AlphaSet(x,y,AlphaGet(nx,ny));
#endif //CXIMAGE_SUPPORT_ALPHA

            }
        }
    }

    // 保存结果并退出
    Transfer(tmp);
    return true;
}

 

示例: 如何转换一种格式到另外一种格式 

CxImage  image;
// bmp -> jpg
image.Load("image.bmp", CXIMAGE_FORMAT_BMP);
if (image.IsValid()){
    if(!image.IsGrayScale()) image.IncreaseBpp(24);
    image.SetJpegQuality(80);
    image.Save("image.jpg",CXIMAGE_FORMAT_JPG);
}
// png -> tif
image.Load("image.png", CXIMAGE_FORMAT_PNG);
if (image.IsValid()){
    image.Save("image.tif",CXIMAGE_FORMAT_TIF);
}

  如何从资源中加载图像

//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);

  如何解码内存中的图像 

CxImage image((BYTE*)buffer,size,image_type);
或者
CxMemFile memfile((BYTE*)buffer,size);
CxImage image(&memfile,image_type);
或者
CxMemFile memfile((BYTE*)buffer,size);
CxImage* image = new CxImage();
image->Decode(&memfile,type);

  如何对内存中的图像编码 

long size=0;
BYTE* buffer=0;
image.Encode(buffer,size,image_type);
...
image.FreeMemory(buffer);
或者
CxMemFile memfile;
memfile.Open();
image.Encode(&memfile,image_type);
BYTE* buffer = memfile.GetBuffer();
long size = memfile.Size();
...
image.FreeMemory(buffer);

  如何创建一副多页的TIFF

CxImage *pimage[3];
pimage[0]=&image1;
pimage[1]=&image2;
pimage[2]=&image3;
FILE* hFile;
hFile = fopen("multipage.tif","w+b");
CxImageTIF multiimage;
multiimage.Encode(hFile,pimage,3);
fclose(hFile);
或者
FILE* hFile;
hFile = fopen("c://multi.tif","w+b");
CxImageTIF image;
image.Load("c://1.tif",CXIMAGE_FORMAT_TIF);
image.Encode(hFile,true);
image.Load("c://2.bmp",CXIMAGE_FORMAT_BMP);
image.Encode(hFile,true);
image.Load("c://3.png",CXIMAGE_FORMAT_PNG);
image.Encode(hFile);
fclose(hFile);

  如何复制和粘贴图像

//复制(copy)
HANDLE hDIB = image->CopyToHandle();
if (::OpenClipboard(AfxGetApp()->m_pMainWnd->GetSafeHwnd())) {
    if(::EmptyClipboard()) {
        if (::SetClipboardData(CF_DIB,hDIB) == NULL ) {
            AfxMessageBox( "Unable to set Clipboard data" );
}    }    }
CloseClipboard();
//粘贴(paste)
HANDLE hBitmap=NULL;
CxImage *newima = new CxImage();
if (OpenClipboard()) hBitmap=GetClipboardData(CF_DIB);
if (hBitmap) newima->CreateFromHANDLE(hBitmap);
CloseClipboard();

  如何在图片框控件(Picture Box)中显示图像 

HBITMAP m_bitmap = NULL;
CxImage image("myfile.png", CXIMAGE_FORMAT_PNG);
...
CDC* hdc = m_picture.GetDC();
HBITMAP m_bitmap = image.MakeBitmap(hdc->m_hDC);
HBITMAP hOldBmp = m_picture.SetBitmap(m_bitmap);
if (hOldBmp) DeleteObject(hOldBmp);
if (hdc->m_hDC) m_picture.ReleaseDC(hdc);
...
if (m_bitmap) DeleteObject(m_bitmap);

注：均为转载