转贴 CxImage类库使用说明
轉貼 CxImage類庫使用說明
分類：?技術文章2007-09-26 22:12?17114人閱讀?評論(10)?收藏?舉報一。CxImage類庫簡介
這只是翻譯了CxImage開源項目主頁上的部分簡介及簡單使用。
CxImage類庫是一 個優(yōu)秀的圖像操作類庫。它可以快捷地存取、顯示、轉換各種圖像。有的讀者可能說，有那么多優(yōu)秀的圖形庫，如OpenIL,FreeImage, PaintLib等等，它們可謂是功能強大，齊全，沒必要用其它的類庫。但我要說，這些類庫基本上沒有免費的，使用這些類庫，你要被這樣那樣的許可協(xié)議所 束縛。在這點上，CxImage類庫是完全免費的。另外，在使用上述類庫時，你會遇到重重麻煩。因為它們大部分是平臺無關的，且用C語言寫成，有的還夾雜 著基本的C++ wrapper和成堆德編譯選項的聲明需要你去處理。而CxImage類庫在這方面做得很好。還有讓我最看好的，就是作者完全公開了源代碼。相對于那些封 裝好的圖形庫和GDI+來說，這一點使我們可以進一步學習各種編解碼技術，而不再浮于各種技術的表面。
CxImage是一個可以用于MFC 的C++類，可以打開，保存，顯示，轉換各種格式的圖像文件,比如BMP, JPEG, GIF, PNG, TIFF, MNG, ICO, PCX, TGA, WMF, WBMP, JBG, J2K 等格式的文件。可以實現(xiàn)BMP<->JPG，PNG?<>TIFF格式等等的轉換。
既可以實現(xiàn)圖像文件的類型轉換，也可以實現(xiàn)在內存圖像數(shù)據(jù)的類型轉換，并且使用很方便。
它的作者是: 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類庫
作者已經(jīng)提供了整個類庫配置的工程文件CxImgLib.dsw?(VC++6.0)，只要打開它進行編譯即可。需要大家注意的是:整個CxImage類庫非常大。如果你只需要能處理其中的幾種格式，編譯該類庫時，你可以在配置的頭文件ximcfg.h?中找到一些編譯開關選項來關閉一些圖像庫。JPG、PNG、TIFF中的每一個庫，都會向最終程序增加約100KB的內容。而CxImage類庫壓縮后只有約60KB。所以，你需要謹慎挑選一些你真正需要的類庫。
?
?//類庫配置文件：ximacfg.h#define?CXIMAGE_SUPPORT_JPG?1
//如果要實現(xiàn)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);????????????????//?設置圖像的壓縮質量參數(shù)(從0到100，數(shù)值越大，質量越高)
????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);?
3。在內存緩沖中的圖像類型轉換
（1）把內存緩沖中的數(shù)據(jù)解碼成一個Image對象(decode an image from memory)
有如下幾種方式：
CxImage?image((BYTE*)buffer,size,image_type);//把內存緩沖buffer中的數(shù)據(jù)構造成Image對象
------
//或:
CxMemFile?memfile((BYTE*)buffer,size);?//?顯式使用CxMemFile對象
CxImage?image(&memfile,image_type);
//或：
CxMemFile?memfile((BYTE*)buffer,size);
CxImage*?image?=?new?CxImage();
image->Decode(&memfile,type);
?
============
（2）把Image編碼存放到內存緩沖中（encode an image in memory）--------
long?size=0;//得到圖像大小
BYTE*?buffer=0;//存儲圖像數(shù)據(jù)的緩沖
image.Encode(buffer,size,image_type);//把image對象中的圖像以type類型數(shù)據(jù)copy到buffer
...
free(buffer);
或:
CxMemFile?memfile;????????????//?顯式使用CxMemFile對象
memfile.Open();
image.Encode(&memfile,image_type);
BYTE*?buffer?=?memfile.GetBuffer();
long?size?=?memfile.Size();
...
free(buffer);
?
---------------
4。處理系統(tǒng)粘貼板中的圖像（copy/paste an image）
?
//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();
?
5。在picture box中顯示一個png格式的文件
?
HBITMAP?m_bitmap?=?NULL;
CxImage?image("myfile.png",?CXIMAGE_FORMAT_PNG);
...
m_bitmap?=?image.MakeBitmap(m_picture.GetDC()->m_hDC);
m_picture.SetBitmap(m_bitmap);
...
if?(m_bitmap)?DeleteObject(m_bitmap);?
四。其它一 個CxImage對象是一個擴展了的位圖。作者只是在位圖結構上添加了一些起存儲信息作用的成員變量。一個CxImage對象（同時）也是一組層。每個層 只有在需要時才會分配相應的緩沖區(qū)。CxImage::pDib代表著背景圖像，CxImage::pAlpha代表著透明層，CxImage:: pSelection代表著被選中的層，被用來創(chuàng)建圖像處理時讓用戶感興趣的區(qū)域。在這三個特殊層面的基礎上，你可以增加一些額外的層，這些層可以存儲在 CxImage::pLayers中。一般說來，層是一個完整的CxImage對象。因此，你可以構造很復雜的嵌套層。下面是CxImage的一些成員變 量:
?
class?CxImage
{
...
protected:
void*?pDib;????????????//包含文件頭，調色板等等
BITMAPINFOHEADER?head;?//標準的文件頭（位圖）
CXIMAGEINFO?info;??????//擴展了的信息
BYTE*?pSelection;??????//用戶選中的區(qū)域
BYTE*?pAlpha;??????????//alpha通道
CxImage**?pLayers;?????//通用層
}
typedef?struct?tagCxImageInfo?{
DWORD???dwEffWidth;???????//DWORD?掃描線寬
BYTE*???pImage;???????????//圖像位數(shù)
void*???pGhost;???????????//if?this?is?a?ghost,?pGhost?point?to?the?body
DWORD???dwType;???????????//原圖像的格式
char????szLastError[256];?//出錯信息
long????nProgress;????????//監(jiān)視循環(huán)的次數(shù)
long????nEscape;??????????//跳出標志
long????nBkgndIndex;??????//GIF,?PNG,?MNG格式使用
RGBQUAD?nBkgndColor;??????//RGB三原色透明度
BYTE????nQuality;?????????//JPEG格式使用
long????nFrame;???????????//TIF,?GIF,?MNG使用?:實際的幀數(shù)
long????nNumFrames;???????//TIF,?GIF,?MNG使用?:幀總數(shù)
DWORD???dwFrameDelay;?????//GIF,?MNG使用
long????xDPI;?????????????//水平分辨率
long????yDPI;?????????????//垂直分辨率
RECT????rSelectionBox;????//選中的矩形區(qū)
BYTE????nAlphaMax;????????//陰影的最大不透明度
bool????bAlphaPaletteEnabled;??//如果調色板中有Alpha通道則為真
bool????bEnabled;?????????//打開繪圖函數(shù)
long????xOffset;
long????yOffset;
DWORD???dwEncodeOption;???//一些編碼選項
RGBQUAD?last_c;???????????//一些優(yōu)化選項
BYTE????last_c_index;
bool????last_c_isvalid;
long????nNumLayers;
DWORD???dwFlags;
}?CXIMAGEINFO;
關于CxImage類庫作者： Davide Pizzolato,一位電子工程師。1984年開始編程，已不在乎使用何種編程語言來開發(fā)軟件。現(xiàn)就職于Askoll的電子研發(fā)部。
關于CxImage類庫更多的信息，請到它的官網(wǎng)或作者主頁去了解。
官網(wǎng)：http://www.codeproject.com/bitmap/cximage.asp
作者：http://www.xdp.it/
總結
以上是生活随笔為你收集整理的转贴 CxImage类库使用说明的全部內容，希望文章能夠幫你解決所遇到的問題。
- 上一篇： 配置windows驱动开发环境
- 下一篇： API Hook完全手册