DrawDib 使用例子<转>

时间 2019-11-19

标签 drawdib 使用例子繁體版

原文原文链接

#include<vfw.h>
#pragma comment(lib,"Vfw32.lib")


BITMAPINFOHEADER biHeader;  
memset(&biHeader, 0, sizeof(BITMAPINFOHEADER));  
biHeader.biBitCount=24;  
biHeader.biCompression=BI_RGB;  
biHeader.biHeight=480;  
biHeader.biPlanes=1;  
biHeader.biSize=sizeof(BITMAPINFOHEADER);  
biHeader.biWidth=640;  
  
HDRAWDIB hdd = DrawDibOpen();  
  
//   显示真彩位图  
DrawDibRealize(hdd, pDC->m_hDC, TRUE);   
  
// 按1:2显示, pImgData不含信息头，为纯数据  
DrawDibDraw(hdd, pDC->m_hDC, rect.left+160, rect.top+120, rect.Width()/2,rect.Height()/2, &biHeader,   
    (LPVOID)pImgData, 0, 0, 640, 480, DDF_BACKGROUNDPAL);  
  
DrawDibClose(hdd);

原贴地址：http://blog.csdn.net/sp_daiyq/article/details/6560947算法

=====================================================编程

如下原贴地址：https://bbs.csdn.net/topics/10224748数组

BMP位图文件结构及平滑缩放

---- 用普通方法显示BMP位图，占内存大，速度慢，在图形缩小时，失真严重,在低颜色位数的设备上显示高颜色位数的图形图形时失真大。本文采用视频函数显示BMP位图，能够消除以上的缺点。

---- 1、BMP文件结构

---- 1. BMP文件组成

---- BMP文件由文件头、位图信息头、颜色信息和图形数据四部分组成。

---- 2. BMP文件头

---- BMP文件头数据结构含有BMP文件的类型、文件大小和位图起始位置等信息。

---- 其结构定义以下:

typedef struct tagBITMAPFILEHEADER
{
WORDbfType; // 位图文件的类型，必须为BM
DWORD bfSize; // 位图文件的大小，以字节为单位
WORDbfReserved1; // 位图文件保留字，必须为0
WORDbfReserved2; // 位图文件保留字，必须为0
DWORD bfOffBits; // 位图数据的起始位置，以相对于位图
// 文件头的偏移量表示，以字节为单位
} BITMAPFILEHEADER;

---- 3. 位图信息头
----

BMP位图信息头数据用于说明位图的尺寸等信息。
typedef struct tagBITMAPINFOHEADER{
DWORD biSize; // 本结构所占用字节数
LONGbiWidth; // 位图的宽度，以像素为单位
LONGbiHeight; // 位图的高度，以像素为单位
WORD biPlanes; // 目标设备的级别，必须为1
WORD biBitCount// 每一个像素所需的位数，必须是1(双色),
// 4(16色)，8(256色)或24(真彩色)之一
DWORD biCompression; // 位图压缩类型，必须是 0(不压缩),
// 1(BI_RLE8压缩类型)或2(BI_RLE4压缩类型)之一
DWORD biSizeImage; // 位图的大小，以字节为单位
LONGbiXPelsPerMeter; // 位图水平分辨率，每米像素数
LONGbiYPelsPerMeter; // 位图垂直分辨率，每米像素数
DWORD biClrUsed;// 位图实际使用的颜色表中的颜色数
DWORD biClrImportant;// 位图显示过程当中重要的颜色数
} BITMAPINFOHEADER;

---- 4. 颜色表
---- 颜色表用于说明位图中的颜色，它有若干个表项，每个表项是一个RGBQUAD类型的结构，定义一种颜色。RGBQUAD结构的定义以下:

typedef struct tagRGBQUAD {
BYTErgbBlue;// 蓝色的亮度(值范围为0-255)
BYTErgbGreen; // 绿色的亮度(值范围为0-255)
BYTErgbRed; // 红色的亮度(值范围为0-255)
BYTErgbReserved;// 保留，必须为0
} RGBQUAD;
颜色表中RGBQUAD结构数据的个数有biBitCount来肯定:
当biBitCount=1,4,8时，分别有2,16,256个表项;
当biBitCount=24时，没有颜色表项。
位图信息头和颜色表组成位图信息，BITMAPINFO结构定义以下:
typedef struct tagBITMAPINFO {
BITMAPINFOHEADER bmiHeader; // 位图信息头
RGBQUAD bmiColors[1]; // 颜色表
} BITMAPINFO;

---- 5. 位图数据
---- 位图数据记录了位图的每个像素值，记录顺序是在扫描行内是从左到右,扫描行之间是从下到上。位图的一个像素值所占的字节数:

当biBitCount=1时，8个像素占1个字节;
当biBitCount=4时，2个像素占1个字节;
当biBitCount=8时，1个像素占1个字节;
当biBitCount=24时,1个像素占3个字节;
Windows规定一个扫描行所占的字节数必须是
4的倍数(即以long为单位),不足的以0填充，
一个扫描行所占的字节数计算方法:
DataSizePerLine= (biWidth* biBitCount+31)/8;
// 一个扫描行所占的字节数
DataSizePerLine= DataSizePerLine/4*4; // 字节数必须是4的倍数
位图数据的大小(不压缩状况下):
DataSize= DataSizePerLine* biHeight;

---- 2、BMP位图通常显示方法
---- 1. 申请内存空间用于存放位图文件

---- GlobalAlloc(GHND，FileLength);

---- 2. 位图文件读入所申请内存空间中

---- LoadFileToMemory( mpBitsSrc，mFileName);

---- 3. 在OnPaint等函数中用建立显示用位图

---- 用CreateDIBitmap()建立显示用位图，用CreateCompatibleDC()建立兼容DC,

---- 用SelectBitmap()选择显示位图。

---- 4. 用BitBlt或StretchBlt等函数显示位图

---- 5. 用DeleteObject()删除所建立的位图

---- 以上方法的缺点是: 1)显示速度慢; 2) 内存占用大; 3) 位图在缩小显示时图形失真大,(可经过安装字体平滑软件来解决); 4) 在低颜色位数的设备上(如256显示模式)显示高颜色位数的图形(如真彩色)图形失真严重。

---- 3、BMP位图缩放显示

---- 用DrawDib视频函数来显示位图，内存占用少，速度快，并且还能够对图形进行淡化(Dithering)处理。淡化处理是一种图形算法，能够用来在一个支持比图像所用颜色要少的设备上显示彩色图像。BMP位图显示方法以下:

---- 1. 打开视频函数DrawDibOpen()，通常放在在构造函数中

---- 2. 申请内存空间用于存放位图文件

---- GlobalAlloc(GHND，FileLength);

---- 3. 位图文件读入所申请内存空间中

---- LoadFileToMemory( mpBitsSrc，mFileName);

---- 4. 在OnPaint等函数中用DrawDibRealize()，DrawDibDraw()显示位图

---- 5. 关闭视频函数DrawDibClose(),通常放在在析构函数中

---- 以上方法的优势是: 1)显示速度快; 2) 内存占用少; 3) 缩放显示时图形失真小,4) 在低颜色位数的设备上显示高颜色位数的图形图形时失真小; 5) 经过直接处理位图数据，能够制做简单动画。

---- 4、CViewBimap类编程要点

---- 1. 在CViewBimap类中添加视频函数等成员

HDRAWDIB m_hDrawDib; // 视频函数
HANDLEmhBitsSrc; // 位图文件句柄(内存)
LPSTR mpBitsSrc; // 位图文件地址(内存)
BITMAPINFOHEADER *mpBitmapInfo; // 位图信息头

---- 2. 在CViewBimap类构造函数中添加打开视频函数
---- m_hDrawDib= DrawDibOpen();

---- 3. 在CViewBimap类析构函数中添加关闭视频函数

if( m_hDrawDib != NULL)
{
DrawDibClose( m_hDrawDib);
m_hDrawDib = NULL;
}

---- 4. 在CViewBimap类图形显示函数OnPaint中添加GraphicDraw()
voidCViewBitmap::OnPaint()
{
CPaintDC dc(this); // device context for painting
GraphicDraw( );
}

voidCViewBitmap::GraphicDraw( void )
{
CClientDC dc(this); // device context for painting
BITMAPFILEHEADER *pBitmapFileHeader;
ULONG bfoffBits= 0;
CPoint Wid;

// 图形文件名有效 (=0 BMP)
if( mBitmapFileType < ID_BITMAP_BMP ) return;

// 图形文件名有效 (=0 BMP)
// 准备显示真彩位图
pBitmapFileHeader= (BITMAPFILEHEADER *) mpBitsSrc;
bfoffBits= pBitmapFileHeader->bfOffBits;

// 使用普通函数显示位图

if( m_hDrawDib == NULL || mDispMethod == 0)
{
HBITMAP hBitmap=::CreateDIBitmap(dc.m_hDC,
mpBitmapInfo, CBM_INIT, mpBitsSrc+bfoffBits,
(LPBITMAPINFO) mpBitmapInfo,DIB_RGB_COLORS);
// 创建位图
HDC hMemDC=::CreateCompatibleDC(dc.m_hDC);// 创建内存
HBITMAP hBitmapOld= SelectBitmap(hMemDC, hBitmap); // 选择对象
// 成员CRect mDispR用于指示图形显示区域的大小.
// 成员CPoint mPos用于指示图形显示起始位置坐标.
if( mPos.x > (mpBitmapInfo- >biWidth - mDispR.Width() ))
mPos.x= mpBitmapInfo->biWidth - mDispR.Width() ;
if( mPos.y > (mpBitmapInfo- >biHeight- mDispR.Height()))
mPos.y= mpBitmapInfo- >biHeight- mDispR.Height();
if( mPos.x < 0 ) mPos.x= 0;
if( mPos.y < 0 ) mPos.y= 0;

if( mFullViewTog == 0)
{
// 显示真彩位图
::BitBlt(dc.m_hDC,0,0, mDispR.Width(), mDispR.Height(),
hMemDC,mPos.x,mPos.y, SRCCOPY);
} else {
::StretchBlt(dc.m_hDC,0,0, mDispR.Width(), mDispR.Height(),
hMemDC,0,0, mpBitmapInfo- >biWidth, mpBitmapInfo-
>biHeight, SRCCOPY);
}
// 结束显示真彩位图
::DeleteObject(SelectObject(hMemDC,hBitmapOld));
// 删除位图
} else {

// 使用视频函数显示位图

if( mPos.x > (mpBitmapInfo- >biWidth - mDispR.Width() ))
mPos.x= mpBitmapInfo- >biWidth - mDispR.Width() ;
if( mPos.y > (mpBitmapInfo- >biHeight- mDispR.Height()))
mPos.y= mpBitmapInfo- >biHeight- mDispR.Height();
if( mPos.x < 0 ) mPos.x= 0;
if( mPos.y < 0 ) mPos.y= 0;

// 显示真彩位图
DrawDibRealize( m_hDrawDib, dc.GetSafeHdc(), TRUE);

if( mFullViewTog == 0)
{
Wid.x= mDispR.Width();
Wid.y= mDispR.Height();
// 1:1 显示时, 不能大于图形大小
if( Wid.x > mpBitmapInfo- >biWidth )
Wid.x = mpBitmapInfo- >biWidth;
if( Wid.y > mpBitmapInfo- >biHeight)
Wid.y = mpBitmapInfo- >biHeight;

DrawDibDraw( m_hDrawDib, dc.GetSafeHdc()
, 0, 0, Wid.x, Wid.y,
mpBitmapInfo, (LPVOID) (mpBitsSrc+bfoffBits),
mPos.x, mPos.y, Wid.x, Wid.y, DDF_BACKGROUNDPAL);
} else {
DrawDibDraw( m_hDrawDib, dc.GetSafeHdc(),
0, 0, mDispR.Width(), mDispR.Height(),
mpBitmapInfo, (LPVOID) (mpBitsSrc+bfoffBits),
0, 0, mpBitmapInfo- >biWidth, mpBitmapInfo- >biHeight,
DDF_BACKGROUNDPAL);
}
}
return;
}

---- 5、使用CViewBimap类显示BMP位图
---- 1. 在Visual C++5.0中新建一个名称为mymap工程文件，类型为MFC AppWizard[exe]。在编译运行经过后，在WorkSpace(如被关闭,用Alt_0打开)点击ResourceView，点击Menu左侧的+符号展开Menu条目,双击IDR_MAINFRAME条目,进入菜单资源编辑，在'“查看(V)”下拉式菜单(英文版为View下拉式菜单)的尾部添加“ViewBitmap”条目，其ID为ID_VIEW_BITMAP。

---- 2. 在Visual C++5.0中点击下拉式菜单Project- >Add To project- >Files...，将Bitmap0.h和Bitmap0.cpp添加到工程文件中。

---- 3. 在Visual C++5.0中按Ctrl_W进入MFC ClassWizard，选择类名称为CMainFrame,ObjectIDs: ID_VIEW_BITMAP，Messa缓存

-----------------------------------数据结构

Microsoft的针对与设备无关位图（DIB位图），在其WIN32 SDK的Multimedia中提供了一组绘制DIB位图的高性能函数组──DrawDib函数组。DrawDib函数组是一组不依赖于图形设备接口（GDI）函数，而直接操做显存的函数组。它们支持8位、16位、24位和32位图象深度的DIB。总的来讲，DrawDib函数组相似于StretchDIBits函数，它们都提供了将图象拉伸和抖动的功能，然而，DrawDib函数组还支持图象的解压、数据流以及更多的显示适配器。在某些状况下，DrawDib函数组还具备更大的优越性。可是，在某些场合下，DrawDib函数组却不能取代StretchDIBits函数。下面就DrawDib函数组和StretchDIBits函数使用的场合加以区别和说明：
颜色信息表格式。DrawDib函数组只支持颜色信息表格式为DIB_RGB_COLORS格式的图象，若是要显示以DIB_PAL_COLORS或DIB_PAL_INDICES格式的图象，则必须用StretchDIBits函数。
光栅操做模式。DrawDib函数组只能使用SRCCOPY光栅操做模式，若是要求不只仅使用SRCCOPY模式的话，只能用StretchDIBits函数。一样地，若是要使用其余光栅操做，例如XOR，只能用StretchDIBits函数。
视频及动画回放的质量。DrawDib函数组支持数据流应用，诸如视频片和动画序列，它比StretchDIBits函数提供了更高的图象质量以及对回放过程的改进。
显示适配器。DrawDib函数组比StretchDIBits函数支持更多的显示适配器。DrawDib函数组支持使用4位图象深度提供16色调色板的VGA适配器，使用8位图象深度提供256色调色板的SVGA适配器和使用16位、24位和32位图象深度提供成千上万种颜色的真彩色适配器。DrawDib函数组还使用了受限制的潜在能力提升了图象在显示适配器上的速度和质量。例如，当使用8位的显示适配器时，DrawDib函数组有效地将真彩色图象抖动为256色；一样的，使用4位的显示适配器时，它们也将8位深度的图象抖动成4位。
图象拉伸。正如StretchDIBits同样，DrawDib函数组用源矩形和目的矩形来控制一个图象显示的部分。能够经过改变源矩形和目的矩形的位置和大小来裁剪一幅图象不须要的部分和拉伸某部分。若是显示驱动不支持图象拉伸，那么DrawDib函数组提供了比StretchDIBits函数更有效的拉伸能力。
压缩图象。DrawDib函数组支持好几种压缩和解压方法，其中包括游程编码，JPEG,Cinepak,411YUV和Indeo?。
　

DrawDib的操做

经过使用DrawDibOpen函数初始化DrawDib函数组。DrawDibOpen负责装载动态链接库(DLL)，申请内存资源，DrawDib设备环境(DC)，而且维持初始化相关的设备环境计数。DrawDibOpen同时返回一个其它DrawDib函数所须要使用的新的DC句柄。

当使用完DrawDib DC后，能够用DrawDibClose函数释放它。DrawDibClose同时减小存取DLL的应用的计数。在应用程序中，DrawDibClose函数应是最后的DrawDib操做。

能够建立任意多的DrawDib DC，也能够同时使用多个DrawDib DC来绘制几幅位图。在应用程序中能够建立多个不一样性质的DrawDib DC，这样就能够选择最合适的DC设置。例如，在同一应用程序中，建立两个不一样的DrawDib DC，一个用来显示图象的正常分辨率，另外一个用来显示图象的放大部分。为了更有效地运行，DrawDib函数组须要知道显示适配器及其驱动的信息。显示配置信息是在第一次使用包含DrawDib函数组的DLL时，对显示适配器经过了一系列的测试以后获得的。DrawDib函数组的全部应用都要用到这个配置信息。能够经过调用DrawDibProfileDisplay函数来强制从新进行这些测试。

一般，取得和保存显示配置是一次性的事件。若是配置信息发如今这个系统中安装了另外一个显示驱动时，DrawDib则从新进行测试。

　

图象再现

建立了DrawDib DC后，就能够用DrawDibDraw函数将DIB绘至屏幕。当在8位深度的显示适配器上显示真彩色图象时，DrawDib将自动地抖动图象。

DrawDib也透明地支持视频压缩器。当显示压缩位图时，可经过DrawDibGetBuffer函数获得包含了解压图象数据的缓冲区。若是位图是未压缩的，则DrawDibGetBuffer返回NULL。在应用程序中应本身区分位图是否压缩。

可用DrawDibUpdate宏来刷新一幅图象的总体或一部分的显示。

　

图象序列

当DrawDibDraw函数同DrawDibBegin函数一块儿运用时，能够显示相同尺寸和格式的位图序列。DrawDib经过DrawDibBegin准备绘图的DrawDib DC来提升DrawDibDraw的效率。若是，应用程序没有调用DrawDibBegin，那么DrawDibDraw会在绘图前隐含地执行DrawDibBegin。

DrawDibBegin给DrawDibDraw提供了DrawDib的DC，DC的句柄，BITMAPINFOHEADER结构的地址和源矩形及目的矩形的尺寸。当要显示一个位图序列时，DrawDibDraw要检查序列中的每幅图象的这些值。若是DrawDibDraw检测到这些值有任何变化，它将隐含地再次调用DrawDibBegin来调整DrawDib DC的设置。

当调用完DrawDibBegin后，就能够指定一个或多个适当的标志来调用DrawDibDraw绘制图象序列。只要DC句柄未改变，就可指定DDF_SAME_HDC标志；下列参数未改变，就可指定DDF_SAME_DRAW标志：BITMAPINFOHEADER结构的地址和源矩形及目的矩形的尺寸。

能够经过在DrawDibEnd后跟另外一个DrawDibBegin调用来更新前一个DrawDibBegin设置的标志。DrawDibEnd清除了当前的DrawDib DC的标志和设置。后续的调用DrawDibBegin将从新初始化DrawDib DC，并从新设置适当的标志和设置。然而，只要至少改变了如下任一个当前的标志设置：BITMAPINFOHEADER结构的地址或是源矩形或目的矩形的尺寸，也可不使用DrawDibEnd而直接调用DrawDibBegin来更新一个DrawDib DC。

经过使用DrawDibStart和DrawDibStop函数，能够提升使用压缩图象的数据流操做（如回放一个视频片）的DrawDibDraw的效率。DrawDibStart经过发送一个消息告诉视频管理器（VCM）准备DrawDib DC来接受一个图象流。当流结束时，DrawDibStop发送一个消息给VCM来指示它释放申请的资源。

须要注意的是，在应用程序中必须肯定源矩形和目的矩形的宽度和高度；然而却并不须要肯定这些矩形的起点。应用程序能够从新DrawDibDraw中的起点坐标来使用图象的不一样部分或更新显示的不一样部分。

　

调色板

DrawDib函数组须要响应两条调色板消息：WM_QUERYNEWPALETTE和WM_PALETTECHANGED。若是应用程序未注意到调色板，就须要对这些消息都增长一个各自的消息处理。经过使用DrawDibRealize函数可在当前DC中实现当前DrawDib的调色板。应当在响应WM_QUERYNEWPALETTE和WM_PALETTECHANGED消息时，或在用DrawDibDraw函数显示一个图象序列的准备过程当中实现调色板。

能够用DrawDibSetPallette函数用另外一个调色板的映射来绘一幅图象。DrawDibSetPallette强迫DrawDib DC使用指定的调色板，而这会影响到图象的质量。例如，一个注意调色板的应用程序，可能已经实现了一个调色板并须要阻止DrawDib实现它本身的调色板。应用程序能够经过DrawDibSetPalette来通知DrawDib调色板的使用。

经过使用DrawDibGetPallette函数能够得到当前前景调色板的一个句柄。若是应用程序使用了当前前景调色板，它并无对调色板的彻底使用权，另外一个应用程序可以使这个调色板句柄无效。当使用完毕后，应用程序不该该释放调色板，那样会使另外一个应用程序不能使用调色板。

经过使用DrawDibChangPallete函数能够为它的调色板DrawDib来接收新的颜色值。在紧跟DrawDibChangPallete的后面的代码里，能够为调色板颜色表指定新的值。当调用DrawDibChangPalette时，在DrawDib DC中未设置DDF_ANIMATE标志的话，能够经过使用DrawDibRealize来实现调色板和DrawDibDraw重绘图象来实现调色板的改变。若是DDF_ANIMATE标志在DrawDib DC中设置了，就能够经过DrawDibDraw或DrawDibRealize来实现调色板和显示着的位图颜色的动画。经过DrawDibEnd和DrawDibBegin能够DDF_ANIMATE标志。

若是释放了被选入DC的DrawDib调色板，DC使用调色板时会报告一个GDI错误。相反，应该使用DrawDibSetPalette改变DrawDib DC来使用省缺调色板后另外一调色板。

因为如下函数会释放DrawDib调色板，因此，除非调色板不被DC选中不该使用：DrawDibEnd,DrawDibClose和DrawDibBegin。一样的，当使用了相同的DrawDib DC，但指定了不一样的绘制参数（lpbi,dxDst,dyDst,dxSrc或dySrc）或不一样格式时，DrawDibDraw也会释放调色板。

　

时间计算

做为调试应用程序的一部分，调用DrawDibTime函数能够获得一些关于彻底重复特定次数DrawDib操做所需时间。DrawDibTime返回如下操做的时间：

绘制一幅位图
解压一幅位图
抖动一幅位图
拉伸一幅位图
使用BitBlt函数变换一幅位图
使用StrecthDIBits函数变换一幅位图
获得返回值后，DrawDibTime从新设置每项操做的计数和值。

注意，DrawDibTime只在DrawDib函数的调试版中可用。

　

DrawDib的使用

增长调色板消息处理

下面的例子说明了WM_PALETTECHANGED和WM_QUERYNEWPALETTE消息的处理。这个例子用了DrawDibRealize函数来进行WM_QUERYNEWPALETTE消息的处理。

应用程序应经过使目标窗口无效来让DrawDibDraw函数重绘图象来响应WM_QUERYNEWPALETTE消息。应用DrawDibRealize函数实现调色板来响应WM_PALETTECHANGED消息。

case WM_PALETTECHANGED:
if ((HWND) wParam == hwnd)
break;
case WM_QUERYNEWPALETTE:
hdc = GetDC(hwnd);
f = DrawDibRealize (hdd,hdc,FALSE) > 0;
ReleaseDC (hwnd,hdc);
if (f)
InvalidateRect ( hwnd,NULL,TRUE);
break;

显示设备绘制

下面例子用DrawDibrealize函数在显示一个位图序列以前准备DrawDib DC.

hdc = GetDC(hwnd);
DrawDibBegin(hdd,hdc,dxDest,dyDest,lpbi,dxSrc,dySrc,NULL);
DrawDibRealize(hdd,hdc,fBackground);
DrawDibDraw(hdd,hdc,xDst,yDst,dxDst,dyDst,lpbi,lpBits,
xSrc,ySrc,dxSrc,dySrc,DDF_SAME_DRAW|DDF_SAME_HDC);
DrawDibDraw(hdd,hdc,xDst,yDst,dxDst,dyDst,lpbi,lpBits,
xSrc,ySrc,dxSrc,dySrc,DDF_SAME_DRAW|DDF_SAME_HDC);
DrawDibDraw(hdd,hdc,xDst,yDst,dxDst函数

--------------------------------------------------性能

附：函数参考:

DrawDibBegin

这个DrawDib函数改变一个DrawDib DC的参数或初始化一个新的DrawDib DC.

BOOL DrawDibBegin(

HDRAWDIB hdd,

HDC hdc,

int dxDest,

int dyDest,

LPBITMAPINFOHEADER lpbi,

int dxSrc,

int dySrc,

UINT wFlags

);

参数

hdd DrawDib DC的句柄

hdc 绘图DC的句柄。此参数为可选。

dxDst和dyDst 在MM_TEXT方式下目的矩形的宽度和高度。

lpbi 包含图象格式的BITMAPINFOHEADER结构的地址。DIB颜色表紧跟图象格式，而且biHeight成员必须为一正值。 dxSrc和dySrc 源矩形的宽度和高度（以象素为单位）。

wFlags 函数调用的可用标志。定义了如下的值：

DDF_ANIMATE 容许调色板动画。若是这个值被设置，经过在LOGPALETTE结构中设置palPalEntry成员PC_RESERVED标志，则DrawDib保存了尽量多的入口，调用drawDibChangePalette函数就可实现调色板动画。若是应用程序用了DrawDibBegin函数协同DrawDibDraw函数，最好在DrawDibBegin中设置这个值而不在DrawDibDraw中。

DDF_BACKGROUNDPAL 实现做为背景的调色板，保留当前显示所使用的调色板不变。（这个值与DDF_SAME_HDC互斥。）

DDF_BUFFER 使DrawDib使用屏幕缓冲，这样DDF_UPDATE才可以使用。这关闭了解压和直接绘屏。若是DrawDib不能建立一个脱屏缓冲，就解压或直接绘屏。

DDF_DONTDRAW 当前图象未绘，但已解压。DDF_UPDATE可以之后被用来绘图象。这个标志取代了DDF_PREROLL标志。

DDF_FULLSCREEN 不被支持。

DDF_HALFTONE 无论DIB的调色板如何而把DIB抖动成标准调色板。若是应用程序用DrawDibBegin协同DrawDibDraw，在DrawDibBegin中设置这个值而不在DrawDibDraw中。

DDF_JUSTDRAWIT 用GDI绘这图象。禁止DrawDib函数解压，拉伸或抖动图象。这实际上剥夺了DrawDib区别于StrechDIBits函数的能力。

DDF_SAME_DRAW 让DrawDibDraw使用当前的绘制参数。只有当从使用DrawDibDraw或DrawDibBegin起，lpbi、dxDext、dyDest、dxSrc和dySrc就未改变才用这个值。这个标志取代了DDF_SAME_DIB和DDF_SAME_SIZE标志。

DDF_SAME_HDC 使用当前DC句柄以及与当前句柄相关联的调色板。

DDF_UPDATE 最后缓存的图象须要绘制。若是用这个值绘制失败，则缓冲的图象不在有效，而且在显示被更新前，须要指定一幅新的图象。

返回值

成功返回TRUE，不然FALSE。

注这个函数准备由lpbi指定要绘往DC的DIB。图象已经拉伸成由dxDest和dyDest所指定的大小。若是dxDest和dyDest被设置成-1，DIB则被按原比例绘制。

可经过从新使用DrawDibBegin，指定新的标志和改变至少一个如下的设置：dxDest、dyDest、lpbi、dxSrc或dySrc来更新DrawDib DC的标志。

若是DrawDibBegin的参数未被改变，再次调用这个函数将不起做用。

DrawDibChangePalette

这个函数设置绘DIB所用的调色板。

BOOL DrawDibChangePalette(

HDRAWDIB hdd,

int iStart,

int iLen,

LPPALETTEENTRY lppe

);

参数：

hdd DrawDib DC的句柄。

iStart 调色板开始数。

iLen 调色板的数目。

lppe 调色板阵列的地址。

返回值

成功返回TRUE，不然FALSE。

注只有当当前DrawDib调色板是调用DrawDibRealize函数实现时，这个函数改变物理调色板。

若是颜色表没有改变，下次没有指定DDF_SAME_DRAW的DrawDibDraw函数将隐含地调用DrawDibBegin函数。

DrawDibClose

这个函数关闭一个DrawDib DC并释放DrawDib申请的资源。

BOOL DrawDibClose(

HDRAWDIB hdd

);

参数

hdd DrawDib DC的句柄。

返回值

成功返回TRUE，不然FALSE。

DrawDibDraw

这个函数将DIB绘至屏幕。

BOOL DrawDibDraw(

HDRAWDIB hdd,

HDC hdc,

int xDst,

int yDst,

int dxDst,

int dyDst,

LPBITMAPINFOHEADER lpbi,

LPVOID lpBits,

int xSrc,

int ySrc,

int dxSrc,

int dySrc,

UINT wFlags

);

参数

hdd DrawDib DC的句柄。

hdc DC的句柄。

xDst和yDst 在MM_TEXT坐标系，目标矩形左上角的x和y坐标。

dxDst和dyDst 在MM_TEXT坐标系下，目标矩形的宽度和高度。若是dxDst为-1，则使用位图的宽度；若是dyDst为-1，则使用位图的高度。

lpbi 包含图象格式的BITMAPINFOHEADER结构的地址。DIB的颜色表紧跟着格式后，而且biHeight成员必须为正值；DrawDibDraw不能绘制倒置的DIB。

lpbits 包含位图位的缓冲的地址。

xSrc和ySrc 以象素为单位，源矩形左上角的x和y坐标。坐标（0，0）是位图的左上角。

dxSrc和dySrc 以象素为单位，源矩形的宽度和高度。

wFlags 可用的绘图标志。以下值被定义：

DDF_BACKGROUNDPAL 实现做为背景的调色板，保留当前显示所使用的调色板不变。这个值只有当DDF_SAME_HDC未被设置时才有效。

DDF_DONTDRAW 当前图象已解压但未绘。这个标志取代了DDF_PREROLL标志。

DDF_FULLSCREEN 不被支持。

DDF_HALFTONE 无论DIB的调色板如何而把DIB抖动成标准调色板。若是应用程序使用了DrawDibBegin，在DrawDibBegin中设置而不在DrawDibDraw中。

DDF_HURRYUP 数据并不须要被绘（它能够被绘）而且DDF_UPDATE不用理会这个信息。DrawDib只有当须要去构建另外一帧时才检查这个值；不然，这个值被忽略。

这个值一般用来同步视频和音频。当同步数据时，应用程序应当用这个值发送图象以防止驱动器须要缓冲帧来解压后续帧。

DDF_NOTKEYFRAME DIB数据不是关键帧。

DDF_SAME_HDC 使用当前DC句柄以及与当前句柄相关联的调色板。

DDF_SAME_DRAW 让DrawDibDraw使用当前的绘制参数。只有当从使用DrawDibDraw或DrawDibBegin起，lpbi、dxDext、dyDest、dxSrc和dySrc就未改变才用这个值。DrawDibDraw常常检查这些参数，若是它们改变了，DrawDibBegin则准备绘图的DrawDib DC。这个标志取代了DDF_SAME_DIB和DDF_SAME_SIZE标志。

DDF_UPDATE 最后缓存的图象须要绘制。若是用这个值绘制失败，则缓冲的图象不在有效，而且在显示被更新前，须要指定一幅新的图象。返回值

成功返回TRUE，不然FALSE。

注 DDF_DONTDRAW使DrawDibDraw解压但不显示一幅图象。一个调用DrawDibDraw的序列是指定DDF_UPDATE来显示图象。

若是DrawDib DC没有指定一个屏幕缓冲，指定DDF_DONTDRAW会形成这帧被当即绘到屏幕。序列调用DrawDibDraw指定DDF_UPDATE会失败。

尽管DDF_UPDAT和DDF_DONTDRAW能够在不一样时间设置，它们能够一块儿用来建立脱屏图象。当脱屏图象完成后，能够调用DrawDibDraw来显示图象。

DrawDibEnd

这个函数清除由DrawDibBegin或DrawDibDraw函数设置的标志和DrawDib DC的其它设置。

BOOL DrawDibEnd(

HDRAWDIB hdd

);

参数

hdd 要释放的DrawDib DC的句柄。

返回值

成功返回TRUE，不然FALSE。

DrawDibGetBuffer

这个函数清除由DrawDib用来解压的缓冲的地址。

LPVOID DrawDibGetBuffer(

HDRAWDIB hdd,

LPBITMAPINFOHEADER lpbi,

DWORD dwSize,

DWORD dwFlags

);

参数

hdd 要释放的DrawDib DC的句柄。

lpbi BITMAPINFO结构的地址。这个结构由BITMAPINFOHEADER结构和位图使用的256色调色板所定义的颜色表。 dwSize 经过lpbi的BITMAPINFO结构所指的字节大小。

dwFlags 保留，必须为0。

返回值

返回缓冲的地址或者若是没有用到缓冲返回NULL。若是lpbi不为NULL，它填充了一个描绘缓冲的BITMAPINFO的结构。

DrawDibGetPalette

这个函数清除由DrawDib DC所使用的调色板。

HPALETTE DrawDibGetPalette(

HDRAWDIB hdd

);

参数

hdd 要释放的DrawDib DC的句柄。

返回值

成功返回一个调色板句柄，不然返回NULL。

注这个函数假设DrawDib DC包含了一个有效的调色板，隐含着这样的一个条件：对这个函数的调用必须在DrawDibDraw或DrawDibBegin函数以后。

DrawDibOpen

这个函数打开DrawDib库为使用和建立一个绘图的DrawDib DC做准备。

HDRAWDIB DrawDibOpen(VOID);

参数

这个函数不须要参数。

返回值

成功返回一个DrawDib DC的句柄，不然为NULL。

注当同时绘多个DIB时，为同时在屏的每一个图象建立一个DrawDib DC。

DrawDibProfileDisplay

这个函数决定了当用DrawDib函数时显示系统的设置。

BOOL DrawDibProfileDisplay(

LPBITMAPINFOHEADER lpbi

);

参数

lpbi 包含位图信息的BITMAPINFOHEADER结构。能够经过指定NULL来确认配置信息是当前的。若是配置信息不是当前的，DrawDib会从新运行配置测试来获得当前设置信息。若是把这个参数设为NULL来调用DrawDibProfileDisplay返回值是没有意义的。

返回值

返回值指出了这个显示系统的最快绘制和拉伸能力。若是位图格式不被支持，这个值为0或一个或更多的下列值：

PD_CAN_DRAW_DIB DrawDib能用这种格式绘图象。拉伸可能被支持或不被支持。

PD_CAN_STRETCHDIB DrawDib能用这种格式拉伸或绘制图象。

PD_STRETCHDIB _1_1_OK StretchDIBits用这种格式绘未拉伸的图象快于另外一种方式。

PD_STRETCHDIB _1_2_OK StretchDIBits用这种格式绘以1：2拉伸的图象快于另外一种方式。

PD_STRETCHDIB _1_N_OK StretchDIBits用这种格式绘以1：N拉伸的图象快于另外一种方式。

DrawDibRealize

这个函数为用指定DC实现DrawDib DC 的调色板。

UINT DrawDibRealize (

HDRAWDIB hdd ,

HDC hdc ,

BOOL fBackground

) ;

参数

hdd DrawDib DC　hdd DrawDib DC的句柄。

hdc 包含调色板的DC的句柄。

fBackground 背景调色板标志。若是此值非零，此调色板为背景调色板。若是此值为零而且DC与另外一个窗口相连，当窗口拥有输入焦点时逻辑调色板变为背景调色板。（当窗口风格是CS_OWNDC或当DC是用GetDC函数获得的时，一个DC就与一个窗口相连）。测试

===============================================================字体

以上原贴地址：https://bbs.csdn.net/topics/10224748动画