DirectDraw6的初级编程应用
by Gamster H. S
目录：
1.VC的环境设置．
2.浅谈COM．
3.DirectDraw简述．
4.DirectDraw的初级编程应用．
第一篇：VC的环境设置．
在进行任何DirectX有关的编程之前，你得先设置VC的环境变量值．主要是方便以后的项目设计．
我使用的是VC5和DirectX6，这是我的设置：
1.选择Options．
2.选择Directories Tab．
3.在Show directories for框中选择include files
4.在Directories框中选择一项新项，键入C:\mssdk\include，此目录将含有所有有关的头文件，
如：ddraw.h, dsound.h, ...
5.在Show directories for框中选择Library files
6.在Directories框中选择一项新项，键入C:\mssdk\lib，此目录将含有所有有关的库文件，
如：ddraw.lib, dsound.lib, dxguid.lib, ...
7.选择OK
当你编译建立微软的程式时，以下是基本步骤是：
1.将整个ddex1（c:\mssdk\multimedia\ddraw\ddraw\src\ddex1）目录copy到你任为合适的目
录中（如d:\mydd\，全称为d:\mydd\ddex1）．
2.在VC5的菜单项Files中选择New.
3.选择Win32 Application.
4.键入合适的Location（如d:\mydd\）．
5.键入合适的Project Name（在此为ddex1）.
6.选择菜单项Project->Add to Project->Files，加入*.cpp文件，*.rc文件．在ddex1项目中，
你要加入ddex1.cpp和ddex1.rc文件．
7.选择菜单项Project->Settings，在Link中的Object/Library Modules中加入ddraw.lib
dxguid.lib．
8.Build and run.
9.Any prblems? You know where to find me!
第二篇：浅谈COM．
我不大清楚，但没几个人混得清楚的．他们要么知道点皮毛，要么还在OOP阶段锻练着．别人问
起，只说DirectX3，5，6运用许多COM技术．
第三篇：DirectDraw简述．
DirectX大大提高硬件在Win环境下的运用．DirectDraw提高各种显示硬件的工作．
第四篇：DirectDraw的初级编程应用．
本文将简述ddex1至ddex5中各种DirectDraw API的运用（in detail），至于更高的设计运用，望各位
自己慢慢从其他人手中学之．
1.DirectDraw例子中的全局变量．
file://-----------------------------------------------------------------------------
// Global data
file://-----------------------------------------------------------------------------
LPDIRECTDRAW4 g_pDD = NULL; // DirectDraw object
LPDIRECTDRAWSURFACE4 g_pDDSPrimary = NULL;// DirectDraw primary surface
LPDIRECTDRAWSURFACE4 g_pDDSBack = NULL; // DirectDraw back surface
LPDIRECTDRAWSURFACE4 g_pDDSOne = NULL; // Offscreen surface 1
LPDIRECTDRAWPALETTE g_pDDPal = NULL; // The primary surface palette
BOOL g_bActive = FALSE; // Is application active?
以上全局变量分别为：
1）IDirectDraw4的对象指针．用它建立其它几个全局变量.
2）IDirectDrawSurfce4的对象指针，在此是３个:
g_pDDSPrimary是显示缓冲块，用于显示；
g_pDDSBack是幕后显示缓冲块，从后屏缓冲区截图后拼在此缓冲块上，随后翻成显示缓冲
块，原有显示缓冲块翻成幕后显示缓冲块;
g_pDDSOne是后屏缓冲区，用于存储不同图形资料．
3）IDirectDrawPalette的对象指针，用于存储特定BITMAP的调色板．用在Color manipulation.
4）另一变量和DirectDraw无任何关系．只是确认程序是否处于运行状态．
以上的编码含有说明，所以对任何人都易理解．Any problems? You know where to find me!
2．初始化所有全程变量
这些原码我抄自ddex5.cpp中的static HRESULT InitApp(HINSTANCE hInstance, int nCmdShow)函数中:
1）定义几个局部变量：
DDSURFACEDESC2 ddsd; // the structure contain information about a particluar DirectDrawSurface.
DDSCAPS2 ddscaps; // this is important for further step
HRESULT hRet; // error output
LPDIRECTDRAW pDD; // IDirectDraw Object.
2）组建各项对象：
///////////////////////////////////////////////////////////////////////////
// Create the main DirectDraw object
///////////////////////////////////////////////////////////////////////////
hRet = DirectDrawCreate(NULL, &pDD, NULL);
if (hRet != DD_OK)
return InitFail(hWnd, hRet, "DirectDrawCreate FAILED");
先建立一个IDirectDraw Object，hRet装有DirectDrawCreate()的返回值，这一招非常有用，所有的DirectX
函数都返回一定的数值，DirectDraw的函数返回DD_OK表示函数调用成功．DDERR_***的返回值表示函数
调用失败（或其他原因）．检查函数返回值，以备以后布骤不会出错．我将推迟解释InitFail()函数．
// Fetch DirectDraw4 interface
hRet = pDD->QueryInterface(IID_IDirectDraw4, (LPVOID *) & g_pDD);
if (hRet != DD_OK)
return InitFail(hWnd, hRet, "QueryInterface FAILED");
我们用COM中的QueryInterface申请一个IDirectDraw4对象，不同于DIRECTX5，DirectDraw增加了IDirectDraw4
界面，同时新增了几个更有用的函数（METHODS）．你可以从DirectX的帮助文件中查到．虽是英文，
但好好啃一啃还是有收获的．
// Get exclusive mode
hRet = g_pDD->SetCooperativeLevel(hWnd, DDSCL_EXCLUSIVE | DDSCL_FULLSCREEN);
if (hRet != DD_OK)
return InitFail(hWnd, hRet, "SetCooperativeLevel FAILED");
我们接着设置显示方式，你可设置全屏，或视窗型，或MODEX，从DDEX1到DDEX5的程式中使用的显
示方式都是DDSCL_EXCLUSIVE | DDSCL_FULLSCREEN，全屏！你可以从DirectX的帮助文件中查到有关
SetCooperativeLevel()的注解．虽是英文，但好好啃一啃还是有收获的．
// Set the video mode to 640x480x8
hRet = g_pDD->SetDisplayMode(640, 480, 8, 0, 0);
if (hRet != DD_OK)
return InitFail(hWnd, hRet, "SetDisplayMode FAILED");
我们接着设置屏幕大小，色素和刷新速度．你可以从DirectX的帮助文件中查到有关SetDisplayMode()的
注解．虽是英文，但好好啃一啃还是有收获的．全屏下你所设显示可为320X200, 640X480, 800X600,
1024X768, 1280X1024, 1600X1280等等．色素从8, 16, 24, 32BITs.
// Create the primary surface with 1 back buffer
ZeroMemory(&ddsd, sizeof(ddsd));
ddsd.dwSize = sizeof(ddsd);
ddsd.dwFlags = DDSD_CAPS | DDSD_BACKBUFFERCOUNT;
ddsd.ddsCaps.dwCaps = DDSCAPS_PRIMARYSURFACE |
DDSCAPS_FLIP |
DDSCAPS_COMPLEX;
ddsd.dwBackBufferCount = 1;
hRet = g_pDD->CreateSurface(&ddsd, &g_pDDSPrimary, NULL);
if (hRet != DD_OK)
return InitFail(hWnd, hRet, "CreateSurface FAILED");
// Get a pointer to the back buffer
ddscaps.dwCaps = DDSCAPS_BACKBUFFER;
hRet = g_pDDSPrimary->GetAttachedSurface(&ddscaps, &g_pDDSBack);
if (hRet != DD_OK)
return InitFail(hWnd, hRet, "GetAttachedSurface FAILED");
建立一显示缓冲块附带一块幕后显示缓冲块．首先你初始化DDSURFACEDESC2的对象．如下：
ZeroMemory(&ddsd, sizeof(ddsd));
ddsd.dwSize = sizeof(ddsd);// you will fail without this!!
我观查到的现象是，每个DirectDraw结构含有dwSize成员，一定要初始化这个成员如下：
ddStructObj.dwSize = sizeof(DDSTRUCT);// you will fail without this!!
以下一段编码
ddsd.dwFlags = DDSD_CAPS | DDSD_BACKBUFFERCOUNT;
ddsd.ddsCaps.dwCaps = DDSCAPS_PRIMARYSURFACE |
DDSCAPS_FLIP |
DDSCAPS_COMPLEX;
表示所建DirectDrawSurface是Primary Surface（显示缓冲块），Flipable（前后翻转），有Back Buffer
（幕后显示缓冲块）连接到Primary Surface（attached to）.
ddsd.dwBackBufferCount = 1;
表示Back Buffer（幕后显示缓冲块）只有一块．
hRet = g_pDD->CreateSurface(&ddsd, &g_pDDSPrimary, NULL);
if (hRet != DD_OK)
return InitFail(hWnd, hRet, "CreateSurface FAILED");
// Get a pointer to the back buffer
ddscaps.dwCaps = DDSCAPS_BACKBUFFER;
hRet = g_pDDSPrimary->GetAttachedSurface(&ddscaps, &g_pDDSBack);
if (hRet != DD_OK)
return InitFail(hWnd, hRet, "GetAttachedSurface FAILED");
这一段编码建立Primary Surface，再建立Back Buffer．至此我们的初始工程基本结束！
3．出错处理．
现在介绍初始化过程中错误的处理．
return InitFail(hWnd, hRet, "...... FAILED");
这一语段的运用是，当某一步初始化过程出错，整个程序退出，并显示一个对话框．其定义如下：
file://-----------------------------------------------------------------------------
// Name: InitFail()
// Desc: This function is called if an initialization function fails
file://-----------------------------------------------------------------------------
HRESULT InitFail(HWND hWnd, HRESULT hRet, LPCTSTR szError,...)
{
char szBuff[128];
va_list vl;
va_start(vl, szError);
vsprintf(szBuff, szError, vl);
ReleaseAllObjects();
MessageBox(hWnd, szBuff, TITLE, MB_OK);
DestroyWindow(hWnd);
va_end(vl);
return hRet;
}
你要增写一个RelaeseAllObject()函数，此函数将释放所有的DDRAW对象．有一点值得申明．如果对
象早已被释放，程序不知，试图释放不存在的对象将有严重后果，小心！！！！
file://-----------------------------------------------------------------------------
// Name: ReleaseAllObjects()
// Desc: Finished with all objects we use; release them
file://-----------------------------------------------------------------------------
static void ReleaseAllObjects(void)
{
if (g_pDD != NULL)
{
if (g_pDDSPrimary != NULL)
{
g_pDDSPrimary->Release();
g_pDDSPrimary = NULL;
}
if (g_pDDSOne != NULL)
{
g_pDDSOne->Release();
g_pDDSOne = NULL;
}
if (g_pDDPal != NULL)
{
g_pDDPal->Release();
g_pDDPal = NULL;
}
g_pDD->Release();
g_pDD = NULL;
}
}
这里，程序先释放IDirectDraw4下属的对象，再释放IDirectDraw4的对象．释放前，程序先确认各对
象是否存在，如对象还驻留于内村中，释放对象，并赋值对象指针NULL．
4．如何恢复暂时丢失的对象值．
在你按ALT+TAB键后，应用程序相互切换，当你从其他应用程序转换到DirectDraw有关应用程序时，原
有的对象缓冲区将在切换过程中被I/O系统释放．称为丢失（LOST）．要重新建立．只有IDirectDraw4对
象属下的IDirectDrawSuface4对象有丢失的可能，所以IDirectDrawSurface4提供了Restore()程式．使用方式
如下：
file://-----------------------------------------------------------------------------
// Name: RestoreAll()
// Desc: Restore all lost objects
file://-----------------------------------------------------------------------------
HRESULT
RestoreAll(void)
{
HRESULT hRet;
hRet = g_pDDSPrimary->Restore();
if (hRet == DD_OK)
{
hRet = g_pDDSOne->Restore();
if (hRet == DD_OK)
{
//重新将Bitmap读入内存．DDReloadBitmap()
}
}
return hRet;
}
一般，DirectDrawSuface4对象的丢失将冲刷对象所含的Bitmap．故要使用DDReLoadBitmap()函数重新从
Bitmap文件中读入内存．此函数收藏於DDUTIL.CPP文件中．并不属于DirectX的一部分．下面，就让我
介绍如何使用DDUTIL.CPP中的函数．
5．使用DirectDraw Utilities!!
为了方便开发者，初学者对DirectX的困惑，MS DirectX设计组专门写了一个DDUTIL.CPP文件来帮助大
家．它提供了方便的函数来进行读取Bitmap并赋值于IDirectDrawSurface4对象，从Bitmap中读取调色板
信息，设置透明色等方程．定义如下：
/*==========================================================================
* File: ddutil.cpp
* Content: Routines for loading bitmap and palettes from resources
***************************************************************************/
#ifdef __cplusplus
extern "C" { /* Assume C declarations for C++ */
#endif /* __cplusplus */
extern IDirectDrawPalette *DDLoadPalette(IDirectDraw4 *pdd, LPCSTR szBitmap);
extern IDirectDrawSurface4 *DDLoadBitmap(IDirectDraw4 *pdd, LPCSTR szBitmap, int dx, int dy);
extern HRESULT DDReLoadBitmap(IDirectDrawSurface4 *pdds, LPCSTR szBitmap);
extern HRESULT DDCopyBitmap(IDirectDrawSurface4 *pdds, HBITMAP hbm, int x, int y, int dx, int dy);
extern DWORD DDColorMatch(IDirectDrawSurface4 *pdds, COLORREF rgb);
extern HRESULT DDSetColorKey(IDirectDrawSurface4 *pdds, COLORREF rgb);
#ifdef __cplusplus
}
#endif /* __cplusplus */
-> DDLoadPalette(IDirectDraw4 *pdd, LPCSTR szBitmap):
从Bitmap文件中读出调色板信息，并将此信息交送于IDirectDraw4的对象．
1）参数IDirectDraw4 *是IDirectDraw4的对象指针．
2）参数LPCSTR，是Bitmap文件全名．
3）使用实例：
g_pDDPal = DDLoadPalette(g_pDD, "C:\\han\\mybitmap1.bmp");
if (g_pDDPal)
g_pDDSPrimary->SetPalette(g_pDDPal);
4）详情请参阅DDEX3-5.CPP
->DDLoadBitmap(IDirectDraw4 *pdd, LPCSTR szBitmap, int dx, int dy):
创建一块含有指定Bitmap的IDirectDrawSurface4对象，先创建一块足以容纳指定Bitmap的IDirectDrawSurface4
对象．再将Bitmap读入内存．
1）参数IDirectDraw4 *是对象指针．
2）参数LPCSTR，是Bitmap文件全名．
3）dx, dy表示Bitmap大小．
4）使用实例：
g_pDDSOne = DDLoadBitmap(g_pDD, "C:\\han\\mybitmap.bmp", 640, 490);
if(g_pDDSOne == NULL)
{
// Abort the program.
}
5）没有实例，多试试．
->DDReLoadBitmap(IDirectDrawSurface4 *pdds, LPCSTR szBitmap)：
把一块Bitmap读入一个指定的IDirectDrawSurface4对象指针．
1）参数IDirectDrawSurface4 *是对象指针，将接收Bitmap．
2）参数LPCSTR，是Bitmap文件全名．
3）使用实例：
hRet = DDReLoadBitmap(g_pDDSOne, "C:\\han\\mybitmap.bmp");
if(FAILED(hret))
{
// Abort the program.
}
4）详情请参阅DDEX3-5.CPP
5）我用此函数最多．
->DDCopyBitmap(IDirectDrawSurface4 *pdds, HBITMAP hbm, int x, int y, int dx, int dy):
You don't need to know.
->DDColorMatch(IDirectDrawSurface4 *pdds, COLORREF rgb)：
You don't need to know.
->DDSetColorKey(IDirectDrawSurface4 *pdds, COLORREF rgb):
在指定的参数IDirectDrawSurface4的对象指针上设置一transparent Colorkey.
1）参数IDirectDrawSurface4 *是对象指针，将接收ColorKey.
2）COLORREF, Colorkey的数值．
3）使用实例：
hRet = DDReLoadBitmap(g_pDDSOne, "C:\\han\\mybitmap.bmp");
if(FAILED(hret))
{
// Abort the program.
}
4）详情请参阅DDEX3-5.CPP
5）我用此函数也很多．
For more information about those functions, you better observe the examples Microsoft provided (DDEX1 - DDEX5) for
details.It is the easy way. All the implementations about those functions is in DDUTIL.CPP file.
6．BLIT, FLIP, &Color fill.
这三个应用是DirectDraw的主要应用．其功能为在BackBuffer上画上Bitmap图块，或填上一定的颜色，
再翻到屏幕上.所用函数为：
1＞．Blt和BltFast在BackBuffer上画上Bitmap图块．
file://BltFast Example;
RECT rcRect;
rcRect.left = 0;
rcRect.top = 0;
rcRect.right = 640;
rcRect.bottom = 480;
while(1) {
ddrval = g_pDDSBack->BltFast(0, 0, g_pDDSOne, &rcRect, DDBLTFAST_WAIT);
if(ddrval == DD_OK)
{
break;
}
else if(ddrval == DDERR_SURFACELOST)
{
// use the restore all function!
RestoreAll();
}
}
我常用Blt function:
file://Blt Example;
RECT srcRect = {0, 0, 640, 480};
RECT dstRect = {0, 0, 640, 480};
DDBLTFX tempFX; // you will fail if you don't have this!
tempFX.dwsize = sizeof(DDBLTFX);// you will fail if you don't have this!
while(1) {
ddrval = g_pDDSBack->Blt(dstRect, g_pDDSOne, srcRect, DDBLT_WAIT, &tempFX);
if(ddrval == DD_OK)
{
break;
}
else if(ddrval == DDERR_SURFACELOST)
{
// use the restore all function!
RestoreAll();
}
else if(ddrval != DDERR_WASSTILLDRAWING)
{
break;
}
}
若想使用透明色(COLORKEY)，改DDBLTFAST_WAIT（BltFast的最后一个参数）为
DDBLTFAST_WAIT｜DDBLTFAST_SRCCOLORKEY.改DDBLT_WAIT（Blt的倒数第二个参数）为
DDBLT_WAIT | DDBLT_COLORSRC.
2．＞用Blt在BackBuffer上填充颜色，（我从未成功过）．
RECT dstRect = {0, 0, 640, 480};
DDBLTFX tempFX; // you will fail if you don't have this!
tempFX.dwsize = sizeof(DDBLTFX);// you will fail if you don't have this!
tempFX.dwFillColor = RGB(0, 255, 0); // green.
while(1) {
ddrval = g_pDDSBack->Blt(dstRect, NULL, NULL, DDBLT_WAIT | DDBLT_COLORFILL, &tempFX);
if(ddrval == DD_OK)
{
break;
}
else if(ddrval == DDERR_SURFACELOST)
{
// use the restore all function!
RestoreAll();
}
else if(ddrval != DDERR_WASSTILLDRAWING)
{
break;
}
}
这个例码将在dstRect(0, 0, 640, 480)的长方形中填充绿色．长方形的大小和位置以你定义
的RECT对象确定．用Blt和BltFast的几个弱点是：
１）当dstRect(目标长方块)不和srcRect(源长方块)大小一致，Blt和BltFast将十分慢．
２）当dstRect部分超出屏幕，如屏幕大小640X480，你想在长方块{500, 500, 800, 600}中显示
图块，此图块不将处显，因为你定义的图块在屏幕以外！解决方法将在续篇(Advanced Section)中提出.
3．＞使用Flip：
将准备好的BackBuffer翻到屏幕上，原来的Primar Surface变成BackBuffer.
while(1) {
ddrval = g_pDDSPrimary->Flip(NULL, DDFLIP_WAIT);
if(ddrval == DD_OK)
{
break;
}
else if(ddrval == DDERR_SURFACELOST)
{
// use the restore all function!
RestoreAll();
}
else if(ddrval != DDERR_WASSTILLDRAWING)
{
break;
}
}
4．总结：
1) 建立暂时的IDirectDraw对象．
2) 用COM中的QueryInterface来建立IDirectDraw4的对象．
3) SetCooperativeLevel (视窗或全屏)．
4) SetDisplayMode(屏幕大小，色度，刷新速度)．
5) 建立primary surface(屏幕显示内存)，back buffer(幕后显示内存)，和off-screen sufaces(备用显示内存，用于
存储图块)．
6) 使用ddutil文件中的函数来读入Bitmap，设置ColorKey(当你进行Blt操作,这种颜色将不被显示).
7) 用Blt和BltFast将图块打入back buffer，用Flip来将准备好的back buffer翻成primary surface．原有的
primary surface翻成back buffer，等待下一轮Blt和BltFast的调用．
这些是DirectDraw版本6中的基本操作！我将写一个续篇(Advanced Section)．Enjoy programming!
请大胆提出问题，写信给我或留言于留言板！感谢Doug Klopfenstein！他的Basic DirectDraw Programming
（谭翁编译了这一文章！）给我很大帮助．
