CImage类的介绍与使用
CImage类的介绍与使用
程序代码下载处：http://download.csdn.net/source/2098910
下载处：http://hi.baidu.com/wangleitongxing/blog/item/9063b03e5e20f3c97c1e71c8.html
备注：这个程序是在xp系统，vs2008下做的，当初測试没出什么问题。
昨天（2014-11-11）我下了程序在win7以下測试，出现了评论里说的问题，解决方法我已经写在评论里面了。主要是由于路径的问题。大家參照着改动測下应该就没问题了。
Visual C++的CBitmap类和静态图片控件的功能是比較弱的，它仅仅能显示出在资源中的图标、位图、光标以及图元文件的内容，而不像VB中的Image控件能够显示出绝大多数的外部图像文件(BMP、GIF、JPEG等)。因此，想要在对话框或其它窗体中显示外部图像文件则仅仅能借助于第三方提供的控件或代码。 如今，MFC和ATL共享的新类CImage为图像处理提供了很多对应的方法，这使得Visual C++在图像方面的缺憾一去不复返了。
CImage类概述
CImage是MFC和ATL共享的新类，它能从外部磁盘中调入一个JPEG、GIF、BMP和PNG格式的图像文件加以显示，并且这些文件格式能够相互转换。因为CImage在不同的Windows操作系统中其某些性能是不一样的，因此在使用时要特别注意。比如，CImage::PlgBlt和 CImage::MaskBlt仅仅能在 Windows NT 4.0 或更高版本号中使用，但不能执行在Windows 95/98 应用程序中。CImage::AlphaBlend和CImage::TransparentBlt也仅仅能在 Windows 2000/98或其更高版本号中使用。即使在Windows 2000执行程序还必须将stdafx.h文件里的WINVER和_WIN32_WINNT的提前定义改动成0x0500才干正常使用。
CImage封装了DIB(设备无关位图)的功能，因而可以让我们可以处理每一个位图像素。它具有下列最酷特性：
1、AlphaBlend支持像素级的颜色混合，从而实现透明和半透明的效果。
2、PlgBlt能使一个矩形区域的位图映射到一个平行四边形区域中，并且还可能使用位屏蔽操作。
3、TransparentBlt在目标区域中产生透明图像，SetTransparentColor用来设置某种颜色是透明色。
4、MaskBlt在目标区域中产生源位图与屏蔽位图合成的效果。
使用CImage的一般方法
使用CImage的一般方法是这种过程：
(1) 打开应用程序的stdafx.h文件加入CImage类的包括文件：
#include<atlimage.h>
(2) 定义一个CImage类对象，然后调用CImage::Load方法装载一个外部图像文件。
(3) 调用CImage::Draw方法绘制图像。Draw方法具有例如以下定义：
程序代码：
BOOL Draw( HDC hDestDC, int xDest, int yDest,int nDestWidth, int nDestHeight, int xSrc, int ySrc,int nSrcWidth, int nSrcHeight );
BOOL Draw( HDC hDestDC, const RECT& rectDest, const RECT& rectSrc );
BOOL Draw( HDC hDestDC, int xDest, int yDest );
BOOL Draw( HDC hDestDC, const POINT& pointDest );
BOOL Draw( HDC hDestDC, int xDest, int yDest,int nDestWidth, int nDestHeight );
BOOL Draw( HDC hDestDC, const RECT& rectDest );
当中，hDestDC用来指定绘制的目标设备环境句柄，(xDest, yDest)和pointDest用来指定图像显示的位置，这个位置和源图像的左上角点相相应。
nDestWidth和nDestHeight分别指定图像要显示的高度和宽度，xSrc、ySrc、nSrcWidth和nSrcHeight用来指定要显示的源图像的某个部分所在的位置和大小。
rectDest和rectSrc分别用来指定目标设备环境上和源图像所要显示的某个部分的位置和大小。
须要说明的是，Draw方法综合了StretchBlt、TransparentBlt和AlphaBlend函数的功能。默认时，Draw的功能和 StretchBlt同样。但当图像含有透明色或Alpha通道时，它的功能又和TransparentBlt、AlphaBlend同样。因此，在普通情况下，我们都应该尽量调用CImage::Draw方法来绘制图像。
比如，以下的演示样例Ex_Image是实现这种功能：当选择"文件"ò"打开"菜单命令后，弹出一个文件打开对话框。当选定一个图像文件后，就会在窗体客户区中显示该图像文件内容。这个演示样例的详细过程例如以下：
(1) 创建一个默认的单文档程序项目Ex_Image。
(2) 打开stdafx.h文件里加入CImage类的包括文件atlimage.h。
(3) 在view类中加入成员变量CImage m_Image；
CEx_ImageView类加入ID_FILE_OPEN的COMMAND事件映射程序，并加入下列代码：
程序代码：
void CEx_ImageView::OnFileOpen() //Cyan：加入
{
// TODO: 在此加入命令处理程序代码
CString strFilter;
CSimpleArray<GUID>aguidFileTypes;
HRESULT hResult; //获取CImage支持的图像文件的过滤字符串
hResult=m_Image.GetExporterFilterString(strFilter,aguidFileTypes,_T("All Image Files"));
if(FAILED(hResult))
{
MessageBox(_T("GetExporterFilter调用失败！"));
return;
}
CFileDialog dlg(TRUE,NULL,NULL,OFN_FILEMUSTEXIST,strFilter);
if(IDOK!=dlg.DoModal())
return;
m_Image.Destroy();
//将外部图像文件装载到CImage对象中
hResult=m_Image.Load(dlg.GetFileName());
if(FAILED(hResult))
{
MessageBox(_T("调用图像文件失败！"));
return;
}
//设置主窗体标题栏内容
CString str;
str.LoadString(AFX_IDS_APP_TITLE);
AfxGetMainWnd()->SetWindowTextW(str+_T("-")+dlg.GetFileName());
Invalidate();//强制调用OnDraw函数
}
(4) 定位到CEx_ImageView::OnDraw函数处，加入下列代码：
程序代码：
void CEx_ImageView::OnDraw(CDC* pDC)
{
CEx_ImageDoc* pDoc = GetDocument();
ASSERT_VALID(pDoc);
//if (!pDoc)
//return;
// TODO: 在此处为本机数据加入绘制代码
// Cyan：加入
if(!m_Image.IsNull())
{
m_Image.Draw(pDC->m_hDC,0,0);
}
}
(5) 打开Ex_ImageView.h文件，加入一个公共的成员数据m_Image：
程序代码：
public: CImage m_Image;(Cyan:我认为设置成私有成员比較好)
(6) 编译并执行。单击"打开"工具button，在弹出的对话框中指定一个图像文件后，单击"打开"button。
将图片用其他格式保存
CImage::Save方法能将一个图像文件按还有一种格式来保存，它的原型例如以下：
HRESULT Save( LPCTSTR pszFileName, REFGUID guidFileType= GUID_NULL);
当中，pszFileName用来指定一个文件名称，guidFileType用来指定要保存的图像文件格式，当为GUID_NULL时，其文件格式由文件的扩展名来决定，这也是该函数的默认值。它还能够是GUID_BMPFile(BMP文件格式)、GUID_PNGFile(PNG文件格式)、 GUID_JPEGFile(JPEG文件格式)和GUID_GIFFile(GIF文件格式)。
比如，以下的过程是在Ex_Image演示样例基础上进行的，我们在CEx_ImageView类加入ID_FILE_SAVE_AS的COMMAND事件映射程序，并加入下列代码：
程序代码：
void CEx_ImageView::OnFileSaveAs() //Cyan：加入
{
// TODO: 在此加入命令处理程序代码
if(m_Image.IsNull())
{
MessageBox(_T("请打开要另存的图像！"));
return;
}
CString strFilter;
strFilter="bmp位图文件|*.bmp|JPEG图像文件|*.jpg|GIF图像文件|*.gif|PNG图像文件|*.png||";
CFileDialog dlg(FALSE,NULL,NULL,NULL,strFilter);
if(IDOK!=dlg.DoModal())
return;
//假设没有指定文件扩展名，则为其加入一个
CString strFileName,strExtension;
strFileName=dlg.m_ofn.lpstrFile;
if(dlg.m_ofn.nFileExtension==0)
{
switch(dlg.m_ofn.nFilterIndex)
{
case 1:
strExtension="bmp";
break;
case 2:
strExtension="jpg";
break;
case 3:
strExtension="gif";
break;
case 4:
strExtension="png";
break;
default:
break;
}
strFileName=strFileName+_T(".")+strExtension;
}
//图像保存
HRESULT hResult=m_Image.Save(strFileName);
if(FAILED(hResult))
{
MessageBox(_T("保存图像文件失败！"));
}
}
彩色图像转换成灰度图像
因为很多图像文件使用颜色表来发挥显示设备的色彩显示能力，因而将一张彩色图片变成黑色图片时须要调用CImage::IsIndexed来推断是否使用颜色表，若是则改动颜色表，否则直接将像素进行颜色设置。比如以下的代码：
程序代码：
void CEx_ImageView::OnToGray()//Cyan：加入
{
// TODO: 在此加入命令处理程序代码
if(m_Image.IsNull())
return;
if(!m_Image.IsIndexed())
{
//直接改动像素颜色
COLORREF pixel;
int maxY=m_Image.GetHeight();
int maxX=m_Image.GetWidth();
byte r,g,b,avg;
for(int x=0;x<maxX;x++)
{
for(int y=0;y<maxY;y++)
{
pixel=m_Image.GetPixel(x,y);
r=GetRValue(pixel);
g=GetGValue(pixel);
b=GetBValue(pixel);
avg=(int)(((int)r+g+b)/3);
m_Image.SetPixelRGB(x,y,avg,avg,avg);
}
}
}
else
{
//获取并改动颜色表
int maxColors=m_Image.GetMaxColorTableEntries();
RGBQUAD* lpColorTable;
lpColorTable=new RGBQUAD[maxColors];
m_Image.GetColorTable(0,maxColors,lpColorTable);
for(int i=0;i<maxColors;i++)
{
int avg=(lpColorTable[i].rgbRed+lpColorTable[i].rgbGreen+lpColorTable[i].rgbBlue)/3;
lpColorTable[i].rgbRed=avg;
lpColorTable[i].rgbGreen=avg;
lpColorTable[i].rgbBlue=avg;
}
m_Image.SetColorTable(0,maxColors,lpColorTable);
delete(lpColorTable);
}
Invalidate();//强制调用OnDraw
}
