有关于BitmapEx 类的一些说明文件

这是一个用于C++ MFC开发的Bitmap图片操作类，在文件中叫CBitmapEx,可用于放大，缩小，翻转，过渡和其他有用的功能，有兴趣的朋友可以下载看看。 部分public method: // // void Create(long width, long height); // void Create(CBitmapEx& bitmapEx); // void Load(LPTSTR lpszBitmapFile); // void Save(LPTSTR lpszBitmapFile); // void Scale(long horizontalPercent=100, long verticalPercent=100); // void Rotate(long degrees=0, _PIXEL bgColor=_RGB(0,0,0)); // void FlipHorizontal(); // void FlipVertical(); // void MirrorLeft(); // void MirrorRight(); // void MirrorTop(); // void MirrorBottom(); // void Clear(_PIXEL clearColor=_RGB(0,0,0)); // void Negative(); // void Grayscale(); // void Sepia(long depth=34); // void Emboss(); // void Engrave(); // void Pixelize(long size=4); // void Draw(HDC hDC); // void Draw(long dstX, long dstY, long width, long height, // CBitmapEx& bitmapEx, long srcX, long srcY); // void Draw(long dstX, long dstY, long width, long height, // CBitmapEx& bitmapEx, long srcX, long srcY, long alpha); // void Draw(long dstX, long dstY, long dstWidth, long dstHeight, // CBitmapEx& bitmapEx, long srcX, long srcY, long srcWidth, long srcHeight); // void Draw(long dstX, long dstY, long dstWidth, long dstHeight, CBitmapEx& bitmapEx, // long srcX, long srcY, long srcWidth, long srcHeight, long alpha); // void DrawTransparent(long dstX, long dstY, long width, long height, // CBitmapEx& bitmapEx, long srcX, long srcY, _PIXEL transparentColor=_RGB(0,0,0)); // void DrawTransparent(long dstX, long dstY, long width, long height, // CBitmapEx& bitmapEx, long srcX, long srcY, long alpha, // _PIXEL transparentColor=_RGB(0,0,0)); // void DrawTransparent(long dstX, long dstY, long dstWidth, long dstHeight, // CBitmapEx& bitmapEx, long srcX, long srcY, long srcWidth, long srcHeight, // _PIXEL transparentColor=_RGB(0,0,0)); // void DrawTransparent(long dstX, long dstY, long dstWidth, long dstHeight, // CBitmapEx& bitmapEx, long srcX, long srcY, long srcWidth, long srcHeight, // long alpha, _PIXEL transparentColor=_RGB(0,0,0)); // LPBITMAPFILEHEADER GetFileInfo() {return &m_bfh;} // LPBITMAPINFOHEADER GetInfo() {return &m_bih;} // long GetWidth() {return m_bih.biWidth;} // long GetHeight() {return m_bih.biHeight;} // long GetPitch() {return m_iPitch;} // long GetBpp() {return m_iBpp;} // long GetPaletteEntries() {return m_iPaletteEntries;} // LPRGBQUAD GetPalette() {return m_lpPalette;} // DWORD GetSize() {return m_dwSize;} // LPBYTE GetData() {return m_lpData;} // void SetResampleMode(RESAMPLE_MODE mode=RM_NEARESTNEIGHBOUR) {m_ResampleMode = mode;} // RESAMPLE_MODE GetResampleMode() {return m_ResampleMode;} // BOOL IsValid() {return (m_lpData != NULL);} // _PIXEL GetPixel(long x, long y); // void SetPixel(long x, long y, _PIXEL pixel); // 这篇文章介绍了一个叫CBitmapEx的简单的C++位图操作类。很多次我面对这样一个事实：MFC库只能提供一个只带有有限特征的C++位图操作类CBitmap。我需要诸如比例尺、旋转角度、应用不同滤波等等特征，但是CBitmap并不具有。另一个类CDC （设备上下文）提供了诸如拉伸度、透明性和透明混色等更多的选项，但它运行得太慢（被很多人很多次所证实）。 所以，我决定去写另一个（是的，另一个）不依赖MFC的位图操作类，并且提供一些目前在原来MFC没有实现的特性。这个类能加载任何8位、16位、24位和32位的位图，但在里面是和32位位图运行的。能够将结果图像保存24位位图到硬盘，或者它能够在设备上下文中画出位图。 背景 在Code Project有很多文章讨论过这个话题，所以你可以随意翻阅它们并将它们的最终结果和我的实现作比较。 代码用法 使用这个类非常简单，请看下面： #include "BitmapEx.h" // 装载位图 CBitmapEx bitmapEx; bitmapEx.Load(_T("Enter bitmap source file path here...")); // Do whatever you need to do here bitmapEx.Rotate(45); bitmapEx.Sepia(); bitmapEx.Scale(50, 50); // 在屏幕上绘制位图（首先在别的地方得到设备句柄） bitmapEx.Draw(hDC); // 保存位图 bitmapEx.Save(_T("Enter bitmap destination file path here...")); 这儿有很多的公共的方法。请看下面： 创建位图/加载位图/保存位图 你能使用这个类去加载磁盘或者内存字节流上任何8位到32位的位图。这个类将把它转化为内部的32位位图。之后进行保存操作，位图将被再次转化为24位位图并且被保存在磁盘或内存。你能通过提供的方法来创建空白位图。 使用如下方法，可以在磁盘或内存中创建、加载和保存位图： void Create(long width, long height); void Create(CBitmapEx& bitmapEx); void Load(LPTSTR lpszBitmapFile); void Load(LPBYTE lpBitmapData); void Save(LPTSTR lpszBitmapFile); void Save(LPBYTE lpBitmapData); 一般的变换方法 这个类提供了一些诸如缩放、旋转和镜像等一般的变换方法。在缩放和旋转操作中位图的细节信息将会掉失，所以实现了三种插值方法： 最近邻插值（插值速度最快，无修改信息，图像质量低） 双线性插值法（插值速度快，图像质量较好） 三次B样条（插值速度慢，图像质量最好） 你可以使用SetResampleMode()函数来确定使用哪种插值方法。下面是变换方法列表： void Scale(long horizontalPercent=100, long verticalPercent=100); void Rotate(long degrees=0, _PIXEL bgColor=_RGB(0,0,0)); void FlipHorizontal(); void FlipVertical(); void MirrorLeft(); void MirrorRight(); void MirrorTop(); void MirrorBottom(); 你可以围绕x轴或y轴进行缩放位图，从0度到360度进行旋转位图，或者对位图进行倒立和镜像。当你对位图进行倒立或镜像，不要求你指定插值方式因为你没有改变位图尺寸。 当你旋转位图时你可以设置背景颜色，默认背景颜色是黑色。 简单的位图过滤 这儿实现了6种简单的滤波方法（将来会实现更多）来做一个简单的位图卷积过滤。Clear()方法可以使用你指定的颜色来填充位图。 void Clear(_PIXEL clearColor=_RGB(0,0,0)); void Negative(); void Grayscale(); void Sepia(long depth=34); void Emboss(); void Engrave(); void Pixelize(long size=4); 对一些滤波，比如Sepia() 和 Pixelize()，你可以通过改变输入参数来得到不同的输出结果。 绘制位图 下面是CBitmapEx类的核心函数列表： void Draw(HDC hDC); void Draw(HDC hDC, long dstX, long dstY); void Draw(long dstX, long dstY, long width, long height, CBitmapEx& bitmapEx, long srcX, long srcY); void Draw(long dstX, long dstY, long width, long height, CBitmapEx& bitmapEx, long srcX, long srcY, long alpha); void Draw(long dstX, long dstY, long dstWidth, long dstHeight, CBitmapEx& bitmapEx, long srcX, long srcY, long srcWidth, long srcHeight); void Draw(long dstX, long dstY, long dstWidth, long dstHeight, CBitmapEx& bitmapEx, long srcX, long srcY, long srcWidth, long srcHeight, long alpha); void Draw(_QUAD dstQuad, CBitmapEx& bitmapEx); void Draw(_QUAD dstQuad, CBitmapEx& bitmapEx, long alpha); void Draw(_QUAD dstQuad, CBitmapEx& bitmapEx, long srcX, long srcY, long srcWidth, long srcHeight); void Draw(_QUAD dstQuad, CBitmapEx& bitmapEx, long srcX, long srcY, long srcWidth, long srcHeight, long alpha); void DrawTransparent(long dstX, long dstY, long width, long height, CBitmapEx& bitmapEx, long srcX, long srcY, _PIXEL transparentColor=_RGB(0,0,0)); void DrawTransparent(long dstX, long dstY, long width, long height, CBitmapEx& bitmapEx, long srcX, long srcY, long alpha, _PIXEL transparentColor=_RGB(0,0,0)); void DrawTransparent(long dstX, long dstY, long dstWidth, long dstHeight, CBitmapEx& bitmapEx, long srcX, long srcY, long srcWidth, long srcHeight, _PIXEL transparentColor=_RGB(0,0,0)); void DrawTransparent(long dstX, long dstY, long dstWidth, long dstHeight, CBitmapEx& bitmapEx, long srcX, long srcY, long srcWidth, long srcHeight, long alpha, _PIXEL transparentColor=_RGB(0,0,0)); void DrawTransparent(_QUAD dstQuad, CBitmapEx& bitmapEx, _PIXEL transparentColor=_RGB(0,0,0)); void DrawTransparent(_QUAD dstQuad, CBitmapEx& bitmapEx, long alpha, _PIXEL transparentColor=_RGB(0,0,0)); void DrawTransparent(_QUAD dstQuad, CBitmapEx& bitmapEx, long srcX, long srcY, long srcWidth, long srcHeight, _PIXEL transparentColor=_RGB(0,0,0)); void DrawTransparent(_QUAD dstQuad, CBitmapEx& bitmapEx, long srcX, long srcY, long srcWidth, long srcHeight, long alpha, _PIXEL transparentColor=_RGB(0,0,0)); void DrawBlended(long dstX, long dstY, long width, long height, CBitmapEx& bitmapEx, long srcX, long srcY, long startAlpha, long endAlpha, DWORD mode=GM_NONE); void DrawBlended(long dstX, long dstY, long dstWidth, long dstHeight, CBitmapEx& bitmapEx, long srcX, long srcY, long srcWidth, long srcHeight, long startAlpha, long endAlpha, DWORD mode=GM_NONE); 你可以看到这儿有很多不同的位图绘制方法。指定原尺寸和目标尺寸能够以不同的比例显示位图。最终的图像质量和显示速度取决你选择的插值方法。在大多数的情况下，双线性插值法是平衡显示速度和图像质量的一种比较好的方法。它类似于GDI的StretchBlt()函数。 除了一般的显示方法，这儿还有特别的显示方法。使用Draw()函数通过设置_QUAD参数你可以在你指定的四个角顶点的多边形绘制位图。它类似于GDI的PlgBlt()函数，只是它提供了更多的自由，那就是，它能做投影变化同时不仅仅是仿射位图变换。一些人将会发现这个非常有用。 另一组可用的位图绘制方法是DrawTransparent()函数组。它所能做就是：它能在原位图中指定一种透明颜色。另外，它能显示位图的投影变化。 所有的位图绘制函数能够提供一个不透明性参数只要它在绘制操作中能被应用。这个类似于使用GDI的AlphaBlend()函数。 通过结合不同的位图绘制方法，能够出现一些很酷的显示效果。 为了使用前面两种函数在屏幕上显示位图或者其它设备环境，需要一个设备句柄作为输入参数。 位图信息函数 下面是一些可用的获取位图信息的函数： LPBITMAPFILEHEADER GetFileInfo() {return &m_bfh;} LPBITMAPINFOHEADER GetInfo() {return &m_bih;} long GetWidth() {return m_bih.biWidth;} long GetHeight() {return m_bih.biHeight;} long GetPitch() {return m_iPitch;} long GetBpp() {return m_iBpp;} long GetPaletteEntries() {return m_iPaletteEntries;} LPRGBQUAD GetPalette() {return m_lpPalette;} DWORD GetSize() {return m_dwSize;} LPBYTE GetData() {return m_lpData;} void SetResampleMode(RESAMPLE_MODE mode=RM_NEARESTNEIGHBOUR) {m_ResampleMode = mode;} RESAMPLE_MODE GetResampleMode() {return m_ResampleMode;} BOOL IsValid() {return (m_lpData != NULL);} 直接的像素访问函数 这方面也提供了一些重要的函数，请看下面： _PIXEL GetPixel(long x, long y); void SetPixel(long x, long y, _PIXEL pixel); 这些方法然而比一般的直接内存访问要慢。你可以通过使用GetData()成员函数来得到位图内存缓冲。使用这个位图内存缓冲你能做任何你设想为位图实时处理。对有测试性质的意图这种方法比直接的像素访问要安全。 使用CBitmapEx类的注意事项： 使用所有这些方法你能做任何类型你需要的绘制和变换。对，几乎是所有。而且更多的滤波将被添加进来，更多的变换将得到应用。 还有，读者的评论对于源码更新非常有用。新的函数，比如从内存流中加载和保存已经添加，同时添加的函数还有通过插入点在客户设备绘制位图。 原来许多的绘制函数现在已改由内置的汇编函数实现来获取更高的速度。源码已经添加注释以助于更好的理解。所有关于汇编程序的优化都是欢迎的（因为我并非这方面的专家）。 关于示例工程 工程中的CEffectorBuilder类是一个特别的类，仅仅是作为一个示例去创建动画。这个类使用CBitmapEx类去加载位图文件并对它们作各种变换。上面的截图显示示例工程的屏幕输出。这儿有很多可用绘制和变换的效果你可以自由去体验。最终结果看起来很好！