CBitmapEx—免费的C++位图操作类

转载

mb5fdb1021b5992 2008-09-21 20:48:00

简介：

这篇文章介绍了一个叫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);}