初次接触：DirectDraw

第六章 初次接触：DirectDraw

　　本章，你将初次接触DirectX中最重要的组件：DirectDraw。DirectDraw可能是DirectX中最强大的技术，因为其贯穿着2D图形绘制同时其帧缓存层也是DirectX3D的基础。当然，DirectX8.0中DirectDraw已经完全集成到了DirectX3D里面。此外，如果你对DirectDraw深有了解，那将拥有创建任何DOS16/32类型的图形化程序的能力。DirectDraw是理解众多DirectX自身概念的钥匙。所以，听仔细了。

　　下面是本章你要解决掉的知识点：

　　·DirectDraw接口

　　·创建一个DirectDraw对象

　　·与windows合作

　　·深入研究模式

　　·奇妙的颜色

　　·构建显示表面

　　DirectDraw的众接口

　　DirectDraw由一系列的接口组成。如果你复习一下我们在第五章“DirectX基础与恐怖的COM”对组件对象模型（COM）的讨论，那你便会明白，接口不过是你用来与组件通信的函数或/和方法之集合。看下图6.1关于DirectDraw众接口的图示。记住，我不打算把版本好加在每个接口上，因为到目前为止我们的讨论都是抽象了。比如，IDirectDraw确实已经升级到7.0了，所以当我们用到DirectDraw时我们指的是IDirectDraw7，但现在，我只想展示一下DirectDraw的一些基础和关系。

　　                   图 6.1 DirectDraw的众接口

　　接口特性

　　如你所见，组成DirectDraw的接口只有五个：

　　IUnknown：所有的COM对象都必须从这个基接口派生，DirectDraw当然也不例外。IUnknown除了包含将被其他所有接口重载的Addref(), Release(),和 QueryInterface()函数之外什么也没有。

　　IDirectDraw：用使用DirectDraw工作就必须创建这个主接口。从IDirectDraw的字面意思便暗示了显卡以及相关硬件支持。十分有趣的是，由于win98/ME/XP/NT2000均支持MMS（多显示器支持），现在你可以在你的系统中装不止一个显卡于是便有了不止一个DirectDraw对象。但是，本书只假设电脑中只有一块显卡，而且即使系统中有多块显卡也总是选择默认的显卡来表示DirectDraw对象。

　　IDirectDrawSurface：其代表你使用DirectDraw创建、操作和显示的真实显示表面。一个DirectDraw表面可以存在于显卡自身的VRAM（显存）也可以存在于系统内存中。有两种基本的表面类型：主表面和副表面。

　　主表面用来表示显卡当前正被光栅化并显示的真实视频缓存。而副表面则常常是不显示的。大多数情况下，你将创建单个主表面以表示真实的视频播放，然后用一个或更多的副表面来表示位图对象和/或用后备缓存来代表用来画下一帧动画的非屏幕做图区（offscreen drawing areas）。在下一章我们将讨论关于表面的细节。但现在，还是看看图6.2的详细图示。

　　                图6.2 DirectDraw表面

　　IDirectDrawPalette：DirectDraw可以用来处理任何色深，从1位单色到32位真彩色。故而，DirectDraw支持IDirectDrawPalette接口从而支持了256色或更少颜色数的视频模式。在制作一系列demo时256色模式得到广泛使用，因为用软件光栅化是256色是最快的视频模式。在第二卷对DirectX3D立即模式的讨论中你将转向24位色，因为那是D3D工作的基本视频模式。无论那种情况，IDirectDrawPalette接口用来创建、加载、操作调色板，以及把调色板附着到那些你为DirectDraw程序创建的表面上比如主表面或副表面。图6.3展示了绘图表面与调色板之间的关系。

　　          图6.3 绘图表面与调色板间的关系

　　IDirectDrawClipper:这个接口用来帮助在可视显示表面的子集中进行DirectDraw光栅和位图的剪切操作。大多数情况下，你只需在窗口化的DirectX程序中和/或在剪切位图超出显示表面（无论是主表面还是副表面）的部分时使用DirectDraw剪切器。IDirectDrawClipper接口的酷表现在其将尽可能地利用硬件加速功能，以及替你完成在剪切位图以适应屏幕尺寸时那个麻烦的逐像素（pixel－by－pixel）或微潜像过程。

　　现在，在你开始创建一个DirectDraw对象前，让我们重新回顾一下上一章学到的关于如何使用COM对象的知识。DirectDraw和所有DirectX组件不断的发展着，所以其接口也不断地更新着。唉，尽管到本章为止我提到DirectDraw接口时都用IDirectDraw, IDirectDrawSurface, IDirectDrawPalette,和 IDirectDrawClipper来指代，但大多数情况下这些接口已经被更新过了。必要像前面提到过的，在DirectX7.0时IDirectDraw 已经更新到
IDirectDraw7。

　　这一切意味着，如果你要使用最新的软硬件功能，你必须总是用IUnknown::QueryInterface()查询到最新的接口修订版。但是要想确定最新版的接口，你还不得不查一下DirectX SDK文档。当然，在本书中你使用的是DirectX8.0，所以你已经知道这最新已经最新到哪了，但记住，当你升级到DirectX9.0是你将有一下更新的接口可供使用了。不过，本书的两卷都是关于写你自己的光栅化与3D化软件，所以我将尽可能简短些。大多数情况下，你用不到新版本DirectX的大多数新增功能。

　　综合使用各接口

　　下面，我将简单地综合使用各接口以创建一个DirectDraw程序。

　　1。创建一个主DirectDraw对象并通过QueryInterface()获得一个IDirectDraw7接口。或者使用DirectDrawCreateEx()直接获得一个IDirectDraw7接口。使用接口设置合作级别以及视频模式。

　　2。使用IDirectDrawSurface7接口创建至少一个用以绘图的主表面。针对表面的色深和视频模式，可能需要一个调色板。如果视频模式的色深小于8位每像素，则要用调色板。

　　3。用IDirectDrawPalette接口创建一个调色板，用RGB格式的信息初始化调色板，并把调色板与相关表面关联起来。

　　4。如果DirectDraw程序是窗口程序，或者如果你渲染的位图有可能超出可视DirectDraw表面的边界时，你至少要创建一个剪切器并将其调整到可视窗口的大小。见图6.4。

　　                   图6.4 DirectDraw剪切器

　　5。在主表面上绘图。

　　当然，我省略了大量技术性的细节，但是以上五点是使用不同接口共同的要点。记住这五点之后，让我们了解些细节并真正地使用下这些接口……

　　创建一个DirectDraw对象

　　用C++创建一个DirectDraw1.0对象时，你所要做的便是调用DirectDrawCreate()，如下所示：

　　HRESULT WINAPI DirectDrawCreate(GUID FAR *lpGUID,   // guid of object

　　                LPDIRECTDRAW FAR *lplpDD, // receives interface

　　                IUnknown     FAR *pUnkOuter ); // com stuff

　　lpGUID：这是你要使用的那个显示驱动的GUID。大多数情况下只需简单设为NULL以使用默认的硬件。

　　lplpDD：如果调用成功这将是个IDirectDraw接口的指针的指针。注意，这个函数返回一个IDirectDraw接口而非IDirectDraw7接口。

　　pUnkOuter：高级特性，总是设为NULL。

　　下面是你可能要用到的：创建一个基于IDirectDraw接口的默认DirectDraw对象。

　　LPDIRECTDRAW lpdd = NULL； // storage for IDirectDraw

　　// create the DirectDraw object

　　DirectDrawCreate(NULL, &lpdd, NULL)；

　　如果函数调用成功，lpdd将是一个可用的IDirectDraw 1.0对象接口。但是，你可能喜欢最新版本的接口，IDirectDraw7。不过在你学习如何做到这之前让我们来谈谈错误处理问题吧。

　　DirectDraw的错误处理

　　DirectX的错误处理非常简洁。有许多的宏可以用来检测各种函数调用的成功与失败。Microsoft推荐在测试DirectX函数错误时使用两个宏：

　　FAILED()：检测调用成功。

　　SUCCEEDED()：检测调用失败。

　　知道了这些，你可以通过加入错误处理代码来使你的程序更正规。

　　if (FAILED(DirectDrawCreate(NULL, &lpdd, NULL)))

　　  {

　　  // error

　　  } // end if

　　或者类似的，你可以对成功进行检测：

　　if (SUCCEEDED(DirectDrawCreate(NULL, &lpdd, NULL)))

　　  {

　　  // move onto next step

　　  } // end if

　　else

　　  {

　　  // error

　　  } // end else

　　我经常使用FAILED（）宏，因为我不喜欢同时从两个逻辑方向考虑问题，不过你使用什么宏那可就随你了。使用宏的唯一问题是，宏告诉你的信息太少，其只能检查一些常规错误。如果你想要知道确切的错误，你可以察看函数的返回码。表6.1列出DirectX6.0 DirectDrawCreate()的可能的返回码。

　　表 6.1. DirectDrawCreate() 的返回码

　　返回码     描述

　　DD_OK                              完全成功 

　　DDERR_DIRECTDRAWALREADYCREATED     DirectDraw对象以及创建过了 

　　DDERR_GENERIC                      未知错误 

　　DDERR_INVALIDDIRECTDRAWGUID        GUID设备未知 

　　DDERR_INVALIDPARAMS                非法的参数 

　　DDERR_NODIRECTDRAWHW               没有任何硬件

　　DDERR_OUTOFMEMORY                  大胆猜测一些？

　　使用这些常量的唯一问题是Microsoft不保证他们不会完全改变所有的错误代码。但是，我想按下面的方式编码是绝对安全的。

　　if (DirectDrawCreate(...)!=DD_OK)

　　  {

　　  // error

　　  } // end if

　　在任何时候，DirectDraw的所有函数都会定义DD_OK，所以你尽可放心使用。

　　对接口进行改进

　　如我所说，你可以用从调用DirectDrawCreate()返回的lpdd存储基本的IDirectDraw接口。或者，你可以通过任何DirectDraw接口都实现了的IUnknown接口的QueryInterface()方法查询一个新的接口从而达到使用最新版本接口的目的（不该这个接口是什么）。最新的DirectDraw接口，在DirectX7.0中，叫IDirectDraw7。所以你以下面方式获得这个接口的指针。

　　LPDIRECTDRAW lpdd  = NULL; // standard DirectDraw 1.0

　　LPDIRECTDRAW lpdd7 = NULL; // DirectDraw 7.0 interface 7

　　// first create base IDirectDraw interface

　　if (FAILED(DirectDrawCreate(NULL, &lpdd, NULL)))

　　  {

　　  // error

　　  } // end if

　　// now query for IDirectDraw7

　　if (FAILED(lpdd->QueryInterface(IID_IDirectDraw7,

　　                              (LPVOID *)&lpdd7)))

　　  {

　　  // error

　　  } // end if

　　现在，这里有些重要的东西需要引起注意：

　　·调用QueryInterface()的方式。

　　·在访问IDirectDraw7接口时常量的使用，即IID_IDirectDraw7.

　　通常，从一个接口的所有函数调用都有如下的形式：

　　interface_pointer->method(parms...);

　　所有接口都以如下形式被标识：

　　IID_IDirectCD

　　这里，

　　C代表组件，其他的诸如Draw代表DirectDraw，Sound代表DirectSound，Input代表DirectInput，等等。

　　D代表一个从2到n的数，表示你想要的那个接口。你可以从DDRAW.H文件中找到所有这些常量。

　　继续这个例子。你现在可能对既有IDirectDraw接口又有IDirectDraw7接口感到困惑吧。干麻要这么做？既然你不需要旧版本的接口，简单的像下面这样扔掉它就是了：

　　lpdd->Release();

　　lpdd = NULL; // set to NULL for safety

　　从现在起，从新的接口IDirectDraw7进行所有的函数调用。

　　警告：由于有了IDirectDraw7的新功能，编码变的自由了而且所要做的琐碎的事也少了。之所以能这样，除了IDirectDraw7接口更加成熟和先进了之外，还因为大多数情况下其需要并且返回新的数据类型，而不是为DirectX1.0定义的数据类型。唯一确定这种不规则变化的途径便是去查看DirectX SDK文档，核实任何具体函数需要和（或）返回的数据类型的版本。但是这只是一般的警告，我将告诉你本书中你遇到的所有例子中的正确数据类型。我就是那么好。顺便说一句，我的生日是6.14。

　　除了使用QueryInterface()从一个初始化了的IDirectDraw 接口指针（lpdd），还有一个更直接的“COM 途径”去获得IDirectDraw7 接口。在COM中，只要你有接口ID或称IID，你便可以得到任何接口的接口指针，也即你想要的那个接口。大多数情况下，我个人不推崇使用低级COM函数，因为对此我已经深恶痛绝了。尽管如此，当你使用DirectMusic时你仍然不得不使用低级COM方法，所以此时至少也该介绍给你这种低级调用的过程。下面的代码直接获得IDirectDraw7 接口：

　　// first initialize COM, this will load the COM libraries

　　// if they aren't already loaded

　　if (FAILED(CoInitialize(NULL)))

　　  {

　　  // error

　　  } // end if

　　// Create the DirectDraw object by using the

　　// CoCreateInstance() function

　　if (FAILED(CoCreateInstance(&CLSID_DirectDraw,

　　                            NULL,

　　                            CLSCTX_ALL,

　　                            &IID_IDirectDraw7,

　　                            &lpdd7)))

　　  {

　　  // error

　　  } // end if

　　// now before using the DirectDraw object, it must

　　// be initialized using the initialize method

　　if (FAILED(IDirectDraw7_Initialize(lpdd7, NULL)))

　　  {

　　  // error

　　  } // end if

　　// now that we're done with COM, uninitialize it

　　CoUninitialize();

　　上面这段代码是Microsoft推荐的创建DirectDraw对象的方法。但是这里它耍了一点小花样，它用了一个宏：

　　IDirectDraw7_Initialize(lpdd7, NULL);

　　你可以不这样，而完全用COM的方法取而代之：

　　lpdd7->Initialize(NULL);

　　不管上面两个调用的哪一个，NULL所在位置的参数表示显卡，而NULL代表使用默认的显卡驱动。总之，不难明白上面的宏是如何在代码中扩展开的吧。我想大概是这样做是想使事情变得简单点吧。现在，好消息是，Microsoft已经创建了一个无须中间步骤一下子就建出IDirectDraw7的函数。通常，通常这是不可能的，但在DirectX7.0中，他们创建了一个叫DirectDrawCreateEx()的新函数。关于这个函数，我在上一章提到过。他的原型声明如下：

　　HRESULT WINAPI DirectDrawCreateEx(

　　 GUID FAR *lpGUID,  // the GUID of the driver, NULL for active display

　　 LPVOID *lplpDD,    // receiver of the interface

　　 REFIID iid,       // the interface ID of the interface you are requesting

　　 IUnknown FAR *pUnkOuter  // advanced COM, NULL

　　);

　　这与DirectDrawCreate()很相似，但其多了一个参数，以使你能够创建任何版本的DirectDraw接口。于是，创建IDirectDraw7接口的函数调用如下：

　　LPDIRECTDRAW7 lpdd;  // version 7.0

　　// create version 7.0 DirectDraw object interface

　　DirectDrawCreateEx(NULL, (void **)&lpdd, IID_IDirectDraw7, NULL);

　　唯一诡异的地方是接口指针的类型转换--注意那个（void **），此外你必须在参数idd中传一个接口。除此之外，它还是蛮简单高效的。

　　让我们花几分钟重复一些所有东西。如果我们想要用最新版本的DirectDraw，即7.0版（因为在DirectX8.0中Microsoft去除了DirectDraw），我们需要一个IDirectDraw7接口。我们可以使用基本的DirectDrawCreate() 创建一个IDirectDraw1.0版接口，然后使用QueryInterface()以获得IDirectDraw7接口。另一方面，我们可以使用低级COM技术直接获得IDirectDraw7。再或者，我们可以使用函数DirectDrawCreateEx()（从DirectX7.0才开始有这个函数）直接创建之。不错吧？DirectX有点像X
Windows了，做同一件可以有5000种途径。

　　现在你知道了如何创建一个DirectDraw对象以及如何获得最新版本的方法。让我们在使DirectDraw工作起来的征程中再向前走一步，即设置合作级别。

　　与windows合作

　　如你所知，Windows是一个合作、共享的环境。尽管作为一个程序员，我一直不知道如何让系统与我的代码合作，但至少这是个理想状态。总之，DirectX与其他任何Win32应用程序一样，最起码的，它必须通知Windows它所要使用的各种资源，以便让让其他程序不在DirectX使用这些资源时申请（以及得到）这些资源。基本上，只要DirectX告诉Windows它在做什么，它便能得到它想要的资源。这看上去对我很公平。

　　在DirectDraw方面，你唯一感兴趣的是视频显示硬件。有两样东西你要关心的：

　　·全屏模式

　　·窗口模式

　　在全屏模式中，DirectDraw像老式的DOS程序那般行事。就是说，整个荧屏表面都分配给你的游戏，你直接写到视频硬件上。别的程序不会接触到视频硬件。窗口模式有点小不同。在窗口模式中，DirectDraw必须更多的与Windows合作，因为其他的程序可能需要更新他们各自的对用户可见的客户区窗口。因此，在窗口模式中，你对视频硬件的控制和独占是收限制的。

　　第七章“高级DirectDraw和位图绘图”将进一步讨论窗口DirectDraw应用程序，但他们可能有点复杂。本章的大部分将与全屏模式打交道，因为他们更容易操作，要记住这点。

　　现在，你知道一些关于为什么需要在Windows和DirectX之间建立合作的重要性了。让我们来看一下如何告诉Windows你需要的合作方式。要设置DirectDraw的合作级别，使用函数IDirectDraw7:: SetCooperativeLevel()，其是IDirectDraw7中的一个方法。

　　C++：如果你是C程序员，语法IDirectDraw7:: SetCooperativeLevel()可能有点神秘。：：操作符叫做域操作符。该语法简单地表示SetCooperativeLevel()是IDirectDraw7接口的一个方法（或成员函数）。接口是个类，该类不过是一个具有虚函数的结构体罢了。有时我会省略掉前缀而直接写成SetCooperativeLevel()。但是，记住，所有DirectX函数都是接口的一部分，且必须使用函数指针类型的调用，入lpdd->function(...)

　　这里是IDirectDraw7:: SetCooperativeLevel()的原型声明：

　　HRESULT SetCooperativeLevel(HWND hWnd,     // window handle

　　                           DWORD dwFlags);// control flags

　　如果成功返回DD_OK，否则返回错误代码。

　　有趣的是，这是第一次在DirectX函数中需要窗口句柄。DirectX（具体说是DirectDraw）需要hWnd参数以确定关联的窗口。你只需简单地使用你程序的主窗口句柄即可。

　　SetCoopertiveLevel()的第二个参数是dwFlags，其是影响DirectDraw与Windows协同方式的控制标志。表6.2列出了经常使用的一些标志，这些标志可以通过或运算联合在一起使用，以获得一个所要的合作级别。

　　                   表 6.2. SetCooperativeLevel()的控制标志

　　       值                                    说明 

　　DDSCL_ALLOWMODEX        允许使用Mode X (320x200,240,400)显示模式。只当使用DDSCL_EXCLUSIVE 和 DDSCL_FULLSCREEN 标志时方可使用。 


　　DDSCL_ALLOWREBOOT       允许在独占模式（全屏模式）下检测 Ctrl+Alt+Del组合键。

　　DDSCL_EXCLUSIVE         请求使用独占级别。该标志必要与DDSCL_FULLSCREEN 标志同时使用。 

　　DDSCL_FPUSETUP          表明调用函数希望使用优化了的DirectX3D浮点运算单元（FPU）(单精度且禁用异常处理）(single precision and exceptions disabled

　　                       DirectX3D就不需要每次都显式地设置FPU了。要了解更多信息，请查阅DirectX SDK文档“DirectDraw合作级别与FPU精度”。 


　　DDSCL_FULLSCREEN        表明使用全屏模式。其他程序对GDI函数的调用将无法在屏幕上画图。本标志必须与DDSCL_EXCLUSIVE 标志同时使用。 


　　DDSCL_MULTITHREADED     要求DirectDraw的行为满足多线程安全这一要求。就目前你的学习阶段而言还无需对此过于深究。 

　　DDSCL_NORMAL            表明程序是一个普通的窗口程序。本标志不能和 DDSCL_ALLOWMODEX, DDSCL_EXCLUSIVE, 或 DDSCL_FULLSCREEN 同时使用 


　　DDSCL_NOWINDOWCHANGES   表明不允许DirectDraw最小化或还原激活状态下的程序窗口。

　　如果你对上面的诸多标志都看的很仔细的话，你可能会发现好些标志好像有点多余。基本上，DDSCL_FULLSCREEN 和 DDSCL_EXCLUSIVE 必须同时使用。如果你想用 Mode X 模式，那必须同时使用DDSCL_FULLSCREEN, DDSCL_EXCLUSIVE, 和 DDSCL_ALLOWMODEX 。除此之外，标志的名字和其做的事情还是比较贴切的。大多数情况下，你将像下面这样设置全屏模式的程序：

　　lpdd7->SetCooperativeLevel(hwnd,

　　                          DDSCL_FULLSCREEN |

　　                          DDSCL_ALLOWMODEX |

　　                          DDSCL_EXCLUSIVE |

　　                          DDSCL_ALLOWREBOOT);

　　而普通窗口程序则如下般设置：

　　lpdd7->SetCooperativeLevel(hwnd, DDSCL_NORMAL);

　　当然，当你在本书后面学习多线程编程技术时，你可能就要加上标志DDSCL_MULTITHREADED 以使程序运行得更安全。总之，现在让我们看看创建DirectDraw对象和设置合作级别的完整过程：

　　LPDIRECTDRAW lpdd  = NULL; // standard DirectDraw 1.0

　　LPDIRECTDRAW7 lpdd7 = NULL; // DirectDraw 7.0 interface 7

　　// first create base IDirectDraw interface

　　if (FAILED(DirectDrawCreateEx(NULL, (void **)&lpdd7, IID_IDirectDraw7, NULL)))

　　  {

　　  // error

　　  } // end if

　　// now set the cooperation level for windowed DirectDraw

　　// since we aren't going to do any drawing yet

　　if (FAILED(lpdd7->SetCooperativeLevel(hwnd, DDSCL_NORMAL)))

　　  {

　　  // error

　　  } // end if

　　注意：为了节省笔墨，我将省去诸如FAILED() 和（或） SUCCEEDED() 这些错误处理。但是你在编程时可要对错误处理时刻挂在心上哦。

　　此刻，你已经学会了创建一个生成窗口的完整DirectX程序的所有知识--先从DirectDraw开始，然后设置合作级别。尽管你还不知道如何绘图，但毕竟已经开始上路子了。作为一个例子，请看CD上的对应着DEMO6_1.EXE的DEMO6_1.CPP。当你运行程序时，你将看到如图6.5所示的画面。这个程序是基于前面我们写的T3D游戏控制台模板的，我试试在Game_Init() 和 Game_Shutdown() 中做了些修改以创建DirectDraw和设置合作级别。

　　                 图6.5 运行DEMO6_1.EXE

　　下面是在DEMO6_1.CPP中增加了DirectDraw代码的这两个函数，你会看到，创建DirectDraw是多么简单的一件事。

　　int Game_Init(void *parms = NULL, int num_parms = 0)

　　{

　　// this is called once after the initial window is created and

　　// before the main event loop is entered, do all your initialization

　　// here

　　// first create base IDirectDraw interface

　　if (FAILED(DirectDrawCreateEx(NULL, (void **)&lpdd, IID_IDirectDraw7, NULL)))

　　  {

　　  // error

　　  return(0);

　　  } // end if

　　// set cooperation to normal since this will be a windowed app

　　lpdd->SetCooperativeLevel(main_window_handle, DDSCL_NORMAL);

　　// return success or failure or your own return code here

　　return(1);

　　} // end Game_Init

　　/////////////////////////////////////////////////////////////

　　int Game_Shutdown(void *parms = NULL, int num_parms = 0)

　　{

　　// this is called after the game is exited and the main event

　　// loop while is exited, do all you cleanup and shutdown here

　　// simply blow away the IDirectDraw interface

　　if (lpdd)

　　  {

　　  lpdd->Release();

　　  lpdd = NULL;

　　  } // end if

　　// return success or failure or your own return code here

　　return(1);

　　} // end Game_Shutdown

　　技巧：如果你打算自己从头写DEMO6_1.CPP并试图编译它，请记得从DirectX8.0 SDK的LIB\目录中手动include DDRAW.LIB。同时把DirectX头文件所在文件夹增加到你的编译器的编译搜索路径中，并使给文件夹为编译器搜索头文件时最先搜索的文件夹。此外，你当然应当创建一个Win32应用程序，我每天至少从使用编译器的新手那里收到10封email，忘了include .lib文件的。你可别成下一个发此类email的人……

　　学习有关模式的一些知识

　　有关设置DirectDraw的下一步可能是所有设置步骤中最酷的一部分。一般的地，在DOS中把视频模式设置为ROM BIOS模式是十分自然的。但由于模式转换的弊端使得在Windows下想像DOS这般设置视频模式几乎是不可能的。不过，由于有DirectX，那就小菜一碟了。DirectDraw的一个主要设计目标便是使视频模式转换对于程序员而言简便且透明。无需进行更多的VGA/CRT控制注册编码，只需做一个简单的调用即可。任何类型的Presto模式｛？Presto mode｝，只要你想--你可以。（当然，显卡得支持）

　　设置视频模式的函数叫 SetDisplayMode()，其为IDirectDraw7接口的成员函数，或用C++的话说：IDirectDraw7::SetDisplayMode()。下面是它的原型声明。

　　HRESULT SetDisplayMode(DWORD dwWidth,  // width of mode in pixels

　　              DWORD dwHeight, // height if mode in pixels

　　              DWORD dwBPP,    // bits per pixel, 8,16,24, etc.

　　              DWORD dwRefreshRate, // desired refresh, 0 for default

　　              DWORD dwFlags); // extra flags (advanced) 0 for default

　　与往常一样，函数的如果调用成功则返回DD_OK。

　　你现在可能想说：“天哪，棒极了！”。你曾经试图设置一个Mode X模式，比如320×400或800×600模式吗？即使你成功了，呵呵，渲染视频缓存是可要祝你好运了。不过，现在有了DirectDraw函数，你只要把宽、高、色深、发给函数，呵呵，搞定！DirectDraw处理所有具体显卡的细节特性，如果你要求的模式可以建立，那它就建立之。并且，视频模式建立后保证有一段线性的内存缓存……当然它还保证其他一些东西，晚些时候再说。

　　看看表6.3，对常用的视频模式和对应色深来次简要的复习。

　　     Table 6.3. 常用视频模式

　　宽     高     色深     Mode X 

　　320   200   8    * 

　　320   240   8    * 

　　320   400   8    * 

　　512   512   8,16,24,32   

　　640   480   8,16,24,32   

　　800   600   8,16,24,32   

　　1024   768   8,16,24,32   

　　1280   1024   8,16,24,32   

　　有趣的是，你可以要求任何你想要的模式。比如你可以选择400×400，而且如果显卡支持这种模式那这种模式就能工作。但，最好还是建成选择表6.3列出的模式，因为透明是最常用的。

　　技巧：事实上，有一个Win32 API函数可以用来设置视频模式，而且我过去也用过。但是这个函数对系统容易危害到系统，而且总把事情搞的一团糟。

　　回到SetDisplayMode（）函数，前三个参数意如所表，自不多言。但是最后两个就需要一点解释了。dwRefreshRate用来对你要求的模式设定刷新率。因此，如果你要求一个320×200模式，默认的系统会把刷新率设为70Hz，不过通过这个函数，如果你想，你可以强制的设为60Hz。而且说实在的，我将不深入讨论刷新率，其实简单设为0就行了（这样将使用驱动默认的值）

　　最后一个参数dwFlags是一个额外的标志，用来表示一些琐碎的东西，而且用处也不大。目前，通过给这个参数传DDSDM_STANDARDVGAMODE标志，你可以为320×200使用VGA模式13h｛？｝从而代替Mode X 320×200。再次的，我不会深究这个问题，如果你写一个使用320×200的游戏，那你可以用这个标志做下试验，看看到底是VGA模式13h快还是Mode X 320×200快。不过说真的，差别不大。所以现在，就设成0吧。

　　预备知识到此结束，让我们了转换模式吧。要转换模式，你必须首先创建DirectDraw对象，设置合作级别，然后设置显式模式如下：

　　lpdd->SetDisplayMode(width,height,bpp,0,0);

　　比如，创建一个640×480 256色（8位色深），你将这样做：

　　lpdd->SetDisplayMode(640,480,8,0,0);

　　设置 800x600 16位色深, 你该这么做:

　　lpdd->SetDisplayMode(800,600,16,0,0);

　　现在，两种模式的区别要比设置它们时的区别大得多了。8位色深模式的工作方式与16位、24位模式完全不同。如果你还记得，前几章关于win32 GDI编程时提到调色板（第三章 高级Windows编程，和第四章 Windows GDI，控件，和杂感），同样的道理在DirectDraw中也适用。即当你创建一个8位模式时，你其实是在创建堆模式｛？palletized mode｝，此刻你必须创建一个调试板并用RGB的8.8.8格式填充调色板。

　　另一方面，如果你创建一个色深为16、247、32色深的完全RGB模式，你便不需要想调色板了。你可以把数据编码直接写到视频缓存中。不过至少，你应当学会如何与DirectDraw调色板协同工作（这上下一个话题所要讨论的）。但在进一步学习前，让我们看看用640×480×8的模式创建一个全屏DirectX程序的完整例子。

　　CD上的DEMO6_2.CPP及其对应的可执行文件就是这个例子。我只是给你一个程序的轮廓，你所看到的不过是一个空白荧屏，因为这个demo是全屏程序麻。但是我确实向你展示了达到全屏功能的代码。与往常一样，这个demo是基于以前我们写的游戏控制台程序，不过做了些小修改，在Game_Init() 和 Game_Shutdown() 部分添加了一些与DirectX有关的改动。这些改动在下面从DEMO6_2.CPP节选的代码中可看出。仔细研究下哦，你会惊奇于它的简洁的……

　　int Game_Init(void *parms = NULL, int num_parms = 0)

　　{

　　// this is called once after the initial window is created and

　　// before the main event loop is entered, do all your initialization

　　// here

　　// first create base IDirectDraw interface

　　if (FAILED(DirectDrawCreateEx(NULL, (void **)&lpdd, IID_IDirectDraw7, NULL)))

　　  {

　　  // error

　　  return(0);

　　  } // end if

　　// set cooperation to full screen

　　if (FAILED(lpdd->SetCooperativeLevel(main_window_handle,

　　                  DDSCL_FULLSCREEN | DDSCL_ALLOWMODEX |

　　                  DDSCL_EXCLUSIVE | DDSCL_ALLOWREBOOT)))

　　  {

　　  // error

　　  return(0);

　　  } // end if

　　// set display mode to 640x480x8

　　if (FAILED(lpdd->SetDisplayMode(SCREEN_WIDTH,

　　                 SCREEN_HEIGHT, SCREEN_BPP,0,0)))

　　  {

　　  // error

　　  return(0);

　　  } // end if

　　// return success or failure or your own return code here

　　return(1);

　　} // end Game_Init

　　/////////////////////////////////////////////////////////////

　　int Game_Shutdown(void *parms = NULL, int num_parms = 0)

　　{

　　// this is called after the game is exited and the main event

　　// loop while is exited, do all your cleanup and shutdown here

　　// simply blow away the IDirectDraw7 interface

　　if (lpdd)

　　  {

　　  lpdd->Release();

　　  lpdd = NULL;

　　  } // end if

　　// return success or failure or your own return code here

　　return(1);

　　} // end Game_Shutdown

　　此刻，有两件事你没做：控制调色板以及访问显式缓存。让我们先关照下颜色问题。

　　奇妙的颜色

　　DirectDraw支持许多不同的色深，包括1、2、4、8、16、24、以及32位。显然，1、2和4位色深有点过时了，所以你就别对这些色深过多的研究了。另一方面，8、16、24、和32位模式非常流行。你写的许多游戏可能因为速度上的原因要在8位调色板模式（也是一个不错的用于学习的模式）下运行。或在16或在24以利用全RGB颜色。RGB模式通过向缓存中写入相同字节的数据来工作，如图6.6所示。调色板模式则通过使用一个对缓存中每个像素都索引化了的查找表来工作。你应该很熟悉这种工作方式不是吗，前文有所涉及的。

　　                   图 6.6. 不同色深的比较

　　你要学的是，创建一个256色调色板，并通知DirectDraw你要用它。下面让我们来看看所需步骤：

　　1 创建一个或多个调色板数据结构，比如一个有256个PALETTENTRY结构的数组。

　　2 从DirectDraw对象创建一个DirectDraw调色板接口对象IDirectDrawPalette。大多数情况下，这个调色板对象将直接映射到已注册的VGA硬件调色板上。

　　3 把调色板与绘图表面关联起来，比如与主表面关联。这样所有渲染到表面的数据均将以合适的颜色显式。

　　4 （可选）如果你想，你可以更改部分或全部调色板项。如果你跳过步骤1，在步骤2中创建的是一个空的调色板，那你就得在这步中做点什么了。基本上，我所要说的是：当你创建了一个调色板接口是，你需要同时设置调色板颜色。如果你不同时做，那你稍后也的做。所以，只要你记得在后面初始化调色板，那步骤2可以变成步骤1。

　　让我们开始创建调色板数据结构吧。它无非是是一个有256个调色板项的数组。调色板项是一个叫PALETTENTRY Win32结构，如下所示：

　　typedef struct tagPALETTEENTRY

　　       {

　　       BYTE peRed;     // red component 8-bits

　　       BYTE peGreen;   // green component 8-bits

　　       BYTE peBlue;    // blue component 8-bits

　　       BYTE peFlags;   // control flags: set to PC_NOCOLLAPSE

　　       } PALETTEENTRY;

　　看上去很眼熟吗？很好。

　　总之，建个调色板，你只需简单的创建一个该结构的数组，如下：

　　PALETTEENTRY palette[256];

　　然后，你用你喜欢的方式填充这个数组。但是，这里有条规矩：你必需把peFlags 域填为PC_NOCOLLAPSE.。这是必需的，因为你并不需要Win32或DirectX替你优化调色板。记得这些后，下面是一个创建随机调色板的例子。在第一个数组元素是黑色，最后一个元素是白色：

　　PALETTEENTRY palette[256]; // palette storage

　　// fill em up with color!

　　for (int color=1; color < 255; color++)

　　   {

　　   // fill with random RGB values

　　   palette[color].peRed   = rand()%256;

　　   palette[color].peGreen = rand()%256;

　　   palette[color].peBlue  = rand()%256;

　　   // set flags field to PC_NOCOLLAPSE

　　   palette[color].peFlags = PC_NOCOLLAPSE;

　　   } // end for color

　　// now fill in entry 0 and 255 with black and white

　　palette[0].peRed   = 0;

　　palette[0].peGreen = 0;

　　palette[0].peBlue  = 0;

　　palette[0].peFlags = PC_NOCOLLAPSE;

　　palette[255].peRed   = 255;

　　palette[255].peGreen = 255;

　　palette[255].peBlue  = 255;

　　palette[255].peFlags = PC_NOCOLLAPSE;

　　这就是全部的工作拉。当然，你可以创建多个调色板并分别对它们任意填充，这完全取决于你。

　　继续，下一步是创建实际的IDirectDrawPalette接口。幸运的是，这个接口自DirectX6.0以来就没怎么变过，所以你无需使用 QueryInterface() 或其他任何方法来查询最新版本的接口。下面是IDirectDraw7:: CreatePalette()的原型声明，其创建一个调色板对象。

　　HRESULT CreatePalette(DWORD dwFlags,   // control flags

　　       LPPALETTEENTRY lpColorTable,  // palette data or NULL

　　       LPDIRECTDRAWPALETTE FAR *lplpDDPalette,  // received palette interface

　　       IUnknown FAR *pUnkOuter);   // advanced, make NULL

　　如果函数调用成功则返回DD_OK

　　让我们看看各参数吧。第一个参数dwFlags，其用来控制各种调色板的各种属性。下一个参数是一个指向用来初始化调色板的数据的指针，如果你不想指定则设为NULL即可。如果函数调用成功，则传给第三个参数的指针将存储真实的IDirectDrawPalette接口。最后，pUnkOuter是高级COM参数，一般简单的设为NULL即可。

　　唯一让人感兴趣的参数，当然，便是dwFlags。让我们更深入地看看你能对这个参数做些什么。表6.4列出了可能的值，你可以用或运算综合使用它们。

　　                  表 6.4. CreatePalette()的控制标志

　　     值                                      描述 

　　DDPCAPS_1BIT    1位色深，在调色板中有2项。 

　　DDPCAPS_2BIT    2位色深，在调色板中有4项。

　　DDPCAPS_4BIT    4位色深，在调色板中有16项。 

　　DDPCAPS_8BIT    5位色深，最常用的，在调色板中有256项。 

　　DDPCAPS_8BITENTRIES   这是一个索引化调色板的高级属性，其用在1、2、4位色深的调色板上。记得别用它就是了。 

　　DDPCAPS_ALPHA    表明，PALETTEENTRY结构的 peFlags 域被解释为在一个8位值中用于控制透明度的alpha值。一个用该标志创建的调色板只能与由     DDSCAPS_TEXTURE标志创建的D3D素材表面关联。再次的，这是个给高手准备的高级标志。 


　　DDPCAPS_ALLOW256    表明，这个调色板的256项均可被定义。通常，0和255项分别留给黑色和白色，在某些系统上，比如NT系统，在任何情况下你都是不可以    向这两项写入值的。但是，大多数情况下，你并不需要这个标志，因为0项一般总是黑色，而大多数调色板把第255项定义成白色。当然用    不用，怎么用，随你。 


　　DDPCAPS_INITIALIZE    由lpDDColorArray传递过来的数组初始化调色板的颜色。这个标志被用来是调色板数据能被下载到硬件调色板上。 


　　DDPCAPS_PRIMARYSURFACE   这个调色板将被关联到主表面上。在这个调色板上改变颜色将立即反应在显式上，除非使用DDPSETPAL_VSYNC标志并且DDPSETPAL_VSYNC    是被支持的功能。 


　　DDPCAPS_VSYNC    强迫调色板只在垂直空白间隙期间才更新颜色。这可以减小颜色异常和屏幕闪烁。目前还不是完全支持。 

　　   ｛译者注：显示器显式图形的过程是这样的，先从屏幕左上角开始自左向右水平移动电子枪；到达右端时电子枪移到下一行左端再水平移    动，如此往复。电子枪从上一行右端到下一行左端这个空隙是不发电子的，但时间也很短，故也无法利用。但当电子枪移到右下角时，此时    下一步它将移动到第一行的左端，即要行走右下角到左上角这个对角线，这时这个时间就长一些了，这个时间就是“垂直空白间隙”简记    为VBI。随便说说，不对的还请指正。yew98。｝

　　如果你问我，你一定会说：好多费解的控制字啊。其实，你只需用8位调色板工作，所以你只要对几个控制字使用或运算即可。

　　DDPCAPS_8BIT | DDPCAPS_ALLOW256 | DDPCAPS_INITIALIZE

　　然后，如果你不在乎让0项和255项，你可以忽略DDPCAPS_ALLOW256。进一步的，如果你不想在调用CreatePalette()期间初始化调色板，则你可忽略DDPCAPS_INITIALIZE。

　　把这些知识都吸进脑子里吧。下面便是你如何用刚才的随机调色数据创建一个调色板对象。

　　LPDIRECTDRAWPALETTE lpddpal = NULL; // palette interface

　　if (FAILED(lpdd->CreatePalette(DDPCAPS_8BIT |

　　                               DDPCAPS_ALLOW256 |

　　                               DDPCAPS_INITIALIZE,

　　                               palette,

　　                               &lpddpal,

　　                               NULL)))

　　  {

　　  // error

　　  } // end if

　　如果函数调用成功，lpddpal将指向一个有效的IDirectDrawPalette接口。同时，硬件调试板也会用发送给它的调色数据更新自己。在这里，便是256个随机颜色。

　　通常，在一节的末尾我都会给你一个demo。不过很不幸，这次我们遇到了个所谓“鸡与蛋”的难题。也即，你必需先会在屏幕上花东西然后才能看看画的颜色是什么，而画图你还没学呢。下面就学吧。

　　创建一个显式表面

　　如你所知，在屏幕上显式的图形无非是一系列着了色的像素，而这些像素的颜色又是由内存中的一些格式化数据所描述，要么是调色板，要么是RGB。换句话说，要让任何事情在屏幕上发生，你就需要知道如何在内存中绘画。不过，DirectDraw是设计者决定对显存进行一点抽象，这样不管你系统中（别人系统中）使用什么样的显卡，访问视频表面的方法对于你（程序员观点）而言是不变的。这样，DirectDraw便支持了我们所谓的“表面”概念。

　　看图6.7，表面是可以含有位图数据的矩形内存区域。进一步的，有两种不同的表面：主表面和副表面。

　　   图 6.7. 表面可以是任何尺寸

　　主表面直接与显卡上真实的显存对应，并且始终可见。因此，在DirectDraw程序中你只能有一个主表面，并且它直接反应屏幕图形而且存储于VRAM（显存）中。当你操作主表面时，你会立刻看到结果显示在屏幕上。比如，如果你设置视频模式为640×480×256，则你必需创建一个同样是640×480×256的主表面，并且把它于显示设备，即IDirectDraw7对象，关联起来。

　　副表面，则相当灵活。它们可以是任何尺寸，可以或保存在VRAM中或保存在系统内存中，而且你爱可以创建任意多个，只要内存够用。大多数情况下，你需要一个到两个副表面（缓冲区）用以平滑动画。和主表面一样，副表面也有色深和绘图的工作要做。你在离屏（offscreen）表面为下一帧动画绘图，然后快速的把离屏表面拷贝或翻页（page flip）到主表面，这样便平滑了动画。这就是所谓的双或三缓存。下一章你会学到更多相关知识。

　　副表面的第二个用途是存储游戏中的位图或动画。这是DirectDraw的一个非常重要的特性，因为只有使用DirectDraw表面你才能在位图数据上调用硬件加速功能。如果你你自己去写位块传输程序以绘位图，那你将失去所有的加速功能带来的好处。

　　现在我有点超前了，所以我得放慢点脚步。我超前的原因只是想让你有机会思考思考。现在，让我们来看看如何创建一个与你的显示模式相同大小的主表面，然后你将学习如何在主表面上写数据以及在屏幕上绘像素。

　　创建一个主表面

　　好拉，要创建任何表面你必需安如下步骤进行：

　　1 填充DDSURFACEDESC2 数据结构，其是用来描述你创建的表面的。

　　2 调用IDirectDraw7::CreateSurface()以创建表面

　　下面是CreateSurface()的原型声明：

　　HRESULT CreateSurface(

　　       LPDDSURFACEDESC2 lpDDSurfaceDesc2,

　　       LPDIRECTDRAWSURFACE4 FAR *lplpDDSurface,

　　       IUnknown FAR *pUnkOuter);

　　基本上，函数需要一个对你想创建的DirectDraw表面的描述、一个接收接口的指针，以及最后把表征高级COM属性的pUnkOuter设为NULL。呵呵，填写对表面进行描述的数据结构是件烦人的事情，但我会帮助你一步一步来的。首先，让我们看看 DDSURFACEDESC2：

　　typedef struct _DDSURFACEDESC2

　　       {

　　       DWORD dwSize;   // size of this structure

　　      DWORD dwFlags;  // control flags

　　      DWORD dwHeight; // height of surface in pixels

　　      DWORD dwWidth;  // width of surface in pixels

　　       union

　　       {

　　       LONG  lPitch;        // memory pitch per row

　　       DWORD dwLinearSize;  // size of the buffer in bytes

　　       } DUMMYUNIONNAMEN(1);

　　       DWORD dwBackBufferCount;  // number of back buffers chained

　　       union

　　       {

　　       DWORD dwMipMapCount;           // number of mip-map levels

　　       DWORD dwRefreshRate;           // refresh rate

　　       } DUMMYUNIONNAMEN(2);

　　       DWORD  dwAlphaBitDepth;        // number of alpha bits

　　       DWORD  dwReserved;             // reserved

　　       LPVOID lpSurface;              // pointer to surface memory

　　       DDCOLORKEY ddckCKDestOverlay;  // dest overlay color key

　　       DDCOLORKEY ddckCKDestBlt;      // destination color key

　　       DDCOLORKEY ddckCKSrcOverlay;   // source overlay color key

　　       DDCOLORKEY ddckCKSrcBlt;       // source color key

　　       DDPIXELFORMAT ddpfPixelFormat; // pixel format of surface

　　       DDSCAPS2   ddsCaps;            // surface capabilities

　　       DWORD      dwTextureStage;     // used to bind a texture

　　                                      // to specific stage of D3D

　　       } DDSURFACEDESC2, FAR* LPDDSURFACEDESC2;

　　如你所见，很复杂的一个结构。更有甚者，70％的域都相当诡异。不过幸运的是你只需知道我加粗的那几项，让我们一个一个看：

　　dwSize：在任何DirectX数据结构中这个域都很重要。许多DirectX数据结构都是用地址来传递的，所以获得数据结构的函数或方法是不知道数据结构的大小的。但是如果这个32位域的值总是数据结构的大小，那么获得数据结构的函数将总能通过访问这第一个域来获知数据结构的大小。所以，DirectDraw以及DirectX数据结构在第一个域中标识数据结构自身尺寸。这乍看上去好像有点多余，但相信我，这确实是个很好的设计。填充这个域你只需像如下这么做：

　　DDSURFACEDESC2 ddsd;

　　ddsd.dwSize = sizeof(DDSURFACEDESC2);

　　dwFlags：这个域用来告诉DirectDraw，你给的数据是用来填充DDSURFACEDESC2的哪个域的。或者，如果你在一个查询操作中用这个结构，告诉DirectDraw你要获得DDSURFACEDESC2的哪个域的信息。看看表6.5，其列出了这个标志字可取的值。比如，你如果你要在 dwWidth 和 dwHeight 两个域中填入有效数据则应该像下面这样设置dwFlags域：

　　ddsd.dwFlags = DDSD_WIDTH | DDSD_HEIGHT;

　　这样，DirectDraw便知道去查找 dwWidth 和 dwHeight 域，然后放入有效值。就把单位dwFlags看成是引导数据的指示器吧。

　　表 6.5. DDSURFACEDESC2的dwFlags域的各种可能的标志

　　       值                          描述 

　　DDSD_ALPHABITDEPTH    表明 dwAlphaBitDepth 有效 

　　DDSD_BACKBUFFERCOUNT   表明 dwBackBufferCount 有效 

　　DDSD_CAPS     表明 ddsCaps 有效

　　DDSD_CKDESTBLT    表明 ddckCKDestBlt 有效 

　　DDSD_CKDESTOVERLAY    表明 ddckCKDestOverlay 有效 

　　DDSD_CKSRCBLT    表明 ddckCKSrcBlt 有效 

　　DDSD_CKSRCOVERLAY    表明 ddckCKSrcOverlay 有效 

　　DDSD_HEIGHT     表明 dwHeight 有效

　　DDSD_LINEARSIZE    表明 dwLinearSize 有效 

　　DDSD_LPSURFACE    表明 lpSurface 有效 

　　DDSD_MIPMAPCOUNT    表明 dwMipMapCount 有效 

　　DDSD_PITCH     表明 lPitch 有效 

　　DDSD_PIXELFORMAT    表明 ddpfPixelFormat 有效 

　　DDSD_REFRESHRATE    表明 dwRefreshRate 有效 

　　DDSD_TEXTURESTAGE    表明 dwTextureStage 有效

　　DDSD_WIDTH     表明 dwWidth 有效 

　　dwWidth：表明表面的像素宽度。当你创建一个表面是，这里便是你设定宽度的地方。320，640等等。此外，如果你要查询表面的属性，这个域将返回表面的宽度（如果你这么要求的话）。

　　dwHeight：表面表面的像素高度。与dwWidth类似，这里是你在创建表面时设定其高度的地方。300，240，480等等。

　　lPitch：这是个有趣的域。基本上它是你所选择模式的水平内存间距。看图6.8。lPitch，也被称为步幅或内存宽度，是在给定视频模式下每行的的字节数。基于如下原因，这是个非常重要的数据域：当你要求一个640×480×8的显示模式，你知道每行有640个像素，每个像素占8位内存（即1个字节）。所以，每行有640个字节，于是lPitch似乎便该设为640。对吗？不一定哦。

　　                       图 6.8. 访问一个表面

　　技巧：lPitch将根据VRAM的不同设计而不同。故而，当你在DirectDraw表面上从一行访问另一行的内存时，你必需使用lPitch来移动到下一行，而不是用宽度乘上每像素的字节数。这一点非常之重要。

　　大多数新显卡支持我们所谓的“线性内存模式”而且有硬件寻址功能，这些属性已经是现实了，但并不保证每块显卡都实现之。所以，你不能假设一个640×480×8视频模式在内存中每行占640个字节。而这便是lPitch域存在的理由。你必需在你计算内存地址时应用它以保证计算正确，这样你便可以从一行移动到另一行了。比如，要访问640×480×8（256色）视频模式下的任何一个像素，你可以使用下面的代码。假设你已经从DirectDraw得到lPitch值，并且lpSurface已经指向表面内存（我会在下面解释这个参数的）

　　ddsd.lpSurface[x + y*ddsd.lPitch] = color;

　　是不是很简单啊？大多数情况下，ddsd.lPitch 设为640以代表640x480x8模式。而对于640×480×16模式，ddsd.lPitch 将设为1280（两字节每像素＝640×2）。但是，对于某些显卡，出于显存的布局原因，比如内在缓存的设立或其他什么东西，就使得事情不像上述这样了。所以最正规的方式是：在计算内存时总是使用lPitch，你便总是安全的。

　　技巧：尽管lPitch值并不总是等于你设置的视频模式的水平值，但使用其来测试水平值可以使你能够调用到其他优化函数。比如，在你完成初始化部分功能的代码中，你可以去获得lPitch值并与你选择的视频模式水平值比较。如果它们相等，则你可以切换到你为优化程序而硬编码每行字节数的函数上。

　　lpSurface：这个域获得指向你随创建表面的真实内存地址的指针。这些内存可能是VRAM也可能是系统内存，但是你无需为次担心。一旦你获得了指向该内存的指针，你便可以像操作其他内存一样操作它了，比如向它写数据或读数据，等等，这完全取决于你想如何填充像素。呵呵，让这个指针有效多容易啊！但是我们还是要在这里多停留一会。一般，你必需“锁定”表面内存，并且告诉DirectX你要在该内存上面工作了而其他的进程不许试图在该内存上读或写。进一步的，当你获得了这个指针时，根据不同的色深（8，16，24，32）你要经常对其进行类型转换并将其复值给一个工作指针。

　　dwBackBufferCount：这个域被用来设置和读取后备缓存（或与主表面关联的副离屏翻页缓存）的数目。如果你能回忆起来，通过创建一个或更多的虚主表面（与表面拥有同样的图样和色深的缓存），后备缓存可用来实现动画的平滑化，这也便是离屏缓存。然后你在后备缓存上绘图，这个后备缓存对于用户而言是不可见的。接着快速的翻页或拷贝后备缓存到主表面以供显示。如果你只有一个后备缓存，这个技术便成为“双缓存技术”。使用两个缓存便叫“三缓存技术”，当然后者比前者拥有更好的效果但也占用更多的内存。为了是事情简单点，大多数情况下，你将创建一个包括一个主表面和一个后备缓存的翻页链。

　　ddckCKDestBlt：这个域被用来控制目标颜色键。当进行块传输操作时，这个域控制写入颜色的方式。更多信息将在后面第七章“高级DirectDraw和位图图形”上介绍。

　　ddckCKSrcBlt：这个域表明源颜色键。即当你进行bitmapping操作时｛？后面好像有这个术语，一时想不起来了，但翻到后面再该过来吧。yew98｝你不想被块传递的颜色。这是一个你如何设置你位图透明色的的方法。详见第七章。

　　ddpfPixelFormat：这个域用来获得表明像素的格式。当你去查询表明的属性是这就非常重要了。下面的是其结构。你可能要去查询DirectX SDK以获得更多的细节信息。因为这些信息实在太多了，而且和现在的讨论关心也不大。

　　typedef struct _DDPIXELFORMAT

　　       {

　　       DWORD dwSize;

　　      DWORD dwFlags;

　　       DWORD dwFourCC;

　　       union

　　       {

　　       DWORD dwRGBBitCount;

　　       DWORD dwYUVBitCount;

　　       DWORD dwZBufferBitDepth;

　　       DWORD dwAlphaBitDepth;

　　       DWORD dwLuminanceBitCount; // new for DirectX 6.0

　　       DWORD dwBumpBitCount;      // new for DirectX 6.0

　　       } DUMMYUNIONNAMEN(1);

　　       union

　　       {

　　       DWORD dwRBitMask;

　　       DWORD dwYBitMask;

　　       DWORD dwStencilBitDepth;   // new for DirectX 6.0

　　       DWORD dwLuminanceBitMask;  // new for DirectX 6.0

　　       DWORD dwBumpDuBitMask;     // new for DirectX 6.0

　　       } DUMMYUNIONNAMEN(2);

　　       union

　　       {

　　       DWORD dwGBitMask;

　　       DWORD dwUBitMask;

　　       DWORD dwZBitMask;          // new for DirectX 6.0

　　       DWORD dwBumpDvBitMask;     // new for DirectX 6.0

　　       } DUMMYUNIONNAMEN(3);

　　       union

　　       {

　　       DWORD dwBBitMask;

　　       DWORD dwVBitMask;

　　       DWORD dwStencilBitMask;    // new for DirectX 6.0

　　       DWORD dwBumpLuminanceBitMask;  // new for DirectX 6.0

　　       } DUMMYUNIONNAMEN(4);

　　       union

　　       {

　　       DWORD dwRGBAlphaBitMask;

　　       DWORD dwYUVAlphaBitMask;

　　       DWORD dwLuminanceAlphaBitMask; // new for DirectX 6.0

　　       DWORD dwRGBZBitMask;

　　       DWORD dwYUVZBitMask;

　　       } DUMMYUNIONNAMEN(5);

　　       } DDPIXELFORMAT, FAR* LPDDPIXELFORMAT;

　　注意：我加粗的域是常用域

　　ddsCaps：这个域用来使那些被要求的但尚未在表面属性中定义的项有效。事实上，这个域又是另一个数据结构。下面显示了DDSCAPS2：

　　typedef struct _DDSCAPS2

　　       {

　　       DWORD    dwCaps;   // Surface capabilities

　　       DWORD    dwCaps2;  // More surface capabilities

　　       DWORD    dwCaps3;  // future expansion

　　       DWORD    dwCaps4;  // future expansion

　　       } DDSCAPS2, FAR* LPDDSCAPS2;

　　在99.9％的情况下，你只需设置该结构的第一个域。dwCaps.dwCaps2 是为3D准备的，而其他域dwCaps3 和 dwCaps4是为未来扩展之用，尚未使用。总之，表6.6列出了dwCaps可能设置的标志值。要看完整的列表，到DirectX SDK里去。

　　比如当要创建一个主表面是，你可以像下面这样设置ddsd.ddsCaps

　　ddsd.ddsCaps.dwCaps = DDSCAPS_PRIMARYSURFACE;

　　我知道上面这种表达方式很复杂，在某种程度上确实如此。双重嵌套的控制标志确实有点痛苦。但是，忍受吧……

　　  表 6.6. DirectDraw表面的属性控制设置

　　       值                                         描述

　　DDSCAPS_BACKBUFFER     表明这个表面是表面翻页结构中的后备缓存。 

　　DDSCAPS_COMPLEX     表明是一个复习表面。一个复杂表面是一个与一或多个串成翻页链的后备缓存关联的主表面。 

　　DDSCAPS_FLIP     表明这个表面是一个表面翻页结构中的一部分。但这个属性被传递给 CreateSurface() 方法时, 一个前端缓存和一个或多个后备     缓存将被创建。 


　　DDSCAPS_LOCALVIDMEM    表明这个表面优先存在于显存中。如果这个标志选中则 DDSCAPS_VIDEOMEMORY 也必需选中。 

　　DDSCAPS_MODEX     表明这个表面是一个320x200 或 320x240 的Mode X 表面。 

　　DDSCAPS_NONLOCALVIDMEM    表明这个表面优先存在于非本地显存中。如果这个标志选中则 DDSCAPS_VIDEOMEMORY 也必需选中。

　　DDSCAPS_OFFSCREENPLAIN    表明这个表面是个离屏表面。这样该表面便不能是某种特殊表面了，比如不是一个覆盖层，素材，z序，前端缓存，后备缓存，或者     alpha 表面。（Usually used for sprites。） 


　　DDSCAPS_OWNDC     表明这个表面将长期与一个设备上下文关联。 

　　DDSCAPS_PRIMARYSURFACE    表明这个表面是主表面。其描述了此刻为用户所见的东西。

　　DDSCAPS_STANDARDVGAMODE    表明该表面是一个标准的VGA模式的表面，而非 Mode X 模式。这个标志不能与 DDSCAPS_MODEX 标志同时使用。 


　　DDSCAPS_SYSTEMMEMORY    表明这个表面创建在系统内存中。 

　　DDSCAPS_VIDEOMEMORY    表明这个表面创建在显存中。

　　现在你对当你在创建表面时DirectDraw赋予你的强大而复杂的功能有个概念了吧。让我们把知识付诸实践，创建一个简单的与显示模式同样尺寸和色深（默认操作即如此）的主表面吧。下面是创建主表面的代码：

　　// interface pointer to hold primary surface, note that

　　// it's the 7th revision of the interface

　　LPDIRECTDRAWSURFACE7  lpddsprimary = NULL;

　　DDSURFACEDESC2 ddsd; // the DirectDraw surface description

　　// MS recommends clearing out the structure

　　memset(&ddsd,0,sizeof(ddsd)); // could use ZeroMemory()

　　// now fill in size of structure

　　ddsd.dwSize = sizeof(ddsd);

　　// enable data fields with values from table 6.5 that we

　　// will send valid data in

　　// in this case only the ddsCaps field is enabled, we

　　// could have enabled the width, height etc., but they

　　// aren't needed since primary surfaces take on the

　　// dimensions of the display mode by default

　　ddsd.dwFlags = DDSD_CAPS;

　　// now set the capabilities that we want from table 6.6

　　ddsd.ddsCaps.dwCaps = DDSCAPS_PRIMARYSURFACE;

　　// now create the primary surface

　　if (FAILED(lpdd->CreateSurface(&ddsd, &lpddsprimary, NULL)))

　　  {

　　  // error

　　  } // end if

　　如果函数调用成功，则lpddsprdimary将指向新的表面接口，而你便可以从它上面调用函数了（有很多函数可用它上面调用的，比如在256色模式下关联调色板）。让我们来再通过重复调色板的例子来看看吧。

　　关联调色板

　　在前面关于调色板的章节中你已经做了所以的工作，除了把调色板与一个表面关联起来。你创建了一个调色板并填充了各个颜色项，但你并没有把调色板与某个表面关联起来，因为当时你还没有表面呢。现在，你有一个表面了（主表面），你终于可以完成整个步骤了。

　　要不调色板关联到任何一个表面上，你所要做的便是使用IDirectDrawSurface7::SetPalette()函数，如下所示：

　　HRESULT SetPalette(LPDIRECTDRAWPALETTE lpDDPalette);

　　这个函数只需要一个你想要被关联的调色板指针即可。就用你在前面调色板章节中创建的调色板吧。下面是你如何把调色板与主表面关联的代码：

　　if (FAILED(lpddsprimary->SetPalette(lpddpal)))

　　  {

　　  // error

　　  } // end if

　　还不坏，对吧。此时，你已经具备了任何使你能效仿DOS32游戏的条件。你可以转换视频模式，设置调色板，已经创建主绘图表面以描绘生动的视频图像。但是，仍然有一些细节你需要学习，例如锁定主表面内存并且获得访问VRAM的能力以及绘一个像素。让我们现在就来学下这些东西。

　　绘制像素

　　想要在全屏DirectDraw模式下绘制一个（或一些）像素，你必需首先创建DirectDraw，设置合作级别，设置显式模式，创建只是一个主表面。然后，你要取得访问主表面和向视频内存写数据的许可。但是，在你去学如何做到这些之前，让我们来从另一个角度看看视频表面是如何工作的。

　　如果你还记得的话，所以DirectDraw视频模式和表面都是线性的，如图6.9所示。这意味着，当你一行一行，从左向右，从上到下移动时，内存不断增加。

　　             图 6.9. DirectDraw 表面是线性的

　　提示：你可能会觉得奇怪：DirectDraw是如何在显卡不支持的情况下把一个非线性视频模式转换为线性模式。比如 Mode X便是个完全非线性模式难转换（bank-switched）的模式。事实是这样的，当DirectDraw发现模式在硬件中为非线性，一个叫VFLATD.VXD的驱动便被调用了。这个驱动将在你和VRAM间创建一个软件层以使得VRAM看上去是线性的。不过记住，这个过程的运行速度较慢。

　　此外，在视频缓存中定位到任何位置，你只需两块信息：内存每行间距（也即，每行占多少字节内存）以及每个像素占多大尺寸（8位，16位，24位，32位）。你可以使用下面的等式：

　　// assume this points to VRAM or the surface memory

　　UCHAR *video_buffer8;

　　video_buffer8[x + y*memory_pitchB] = pixel_color_8;

　　当然，这个等式不完全对，因为其仅对8位模式，换句话说，1字节每像素的模式来说是对的。对于16位模式或者换句话说2字节每像素模式，你需要像下面这样做：

　　// assume this points to VRAM or the surface memory

　　USHORT *video_buffer16;

　　video_buffer16[x + y*(memory_pitchB >> 1)] = pixel_color_16;

　　这里有不少东西要讲，所以让我们仔细研究下代码。我把指向VRAM的指针类型设为USHORT.这样当我们使用数组时指针指向的是16位的值。当我说：

　　video_buffer16[1]

　　真正访问的是数组的第2个整型元素，或字节对。此外，由于memory_pitchB 是以字节计的，所以你必需将其除2，我们用将其右移1位来达到除2的目的，这样，便有了基于整型或说16位的内存间隔。最后，关于pixel_color16的赋值也是常常为人误解的。因为此时是将一个完全的16位无符合整型写入视频缓存，而非前面例子的8位值。进一步的，8位值只是调色板上颜色的索引值，而16为值则必需是个RGB值。通常RGB值被编码为R5G6B5 格式，也即5位红色，6位绿色，5位蓝色。如图6.10所示。

　　                   图6.10 16位RGB的不同编码，包括5.6.5格式

　　下面的宏把16位RGB字整理为5.5.5和5.6.5格式：

　　// this builds a 16 bit color value in 5.5.5 format (1-bit alpha mode)

　　#define _RGB16BIT555(r,g,b) ((b & 31) + ((g & 31) << 5) + ((r & 31) << 10))

　　// this builds a 16 bit color value in 5.6.5 format (green dominate mode)

　　#define _RGB16BIT565(r,g,b) ((b & 31) + ((g & 63) << 5) + ((r & 31) << 11))

　　如你所见，16位模式和RGB模式的寻址和操作都要比256色模式复杂。所以让我们从256色模式开始吧。

　　要得到任何包括主表面、副表面等等表面的访问权，你必需锁定以及解锁内存。这种锁定和解锁之所以必要有两个原因：首先，告诉了DirectDraw你要控制内存了（这样，其他进程就不能控制该块内存），其次，表明当你操作锁定内存时，视频硬件不能一定任何高速缓存或虚内存缓存。记住，没有谁能向你保证一块VRAM内容总是在它同一块存储区域里不被移动。可以是虚内存，但当你锁定它时，在整个锁定期间内这块内存将保持原来的地址空间，这样你就可以操作内存了。锁定内存的函数叫IDirectDrawSurface7::Lock() ，如下所示：

　　HRESULT Lock(LPRECT   lpDestRect,      // destination RECT to lock

　　    LPDDSURFACEDESC2 lpDDSurfaceDesc, // address of struct to receive info

　　    DWORD            dwFlags,         // request flags

　　    HANDLE           hEvent);         // advanced, make NULL

　　参数不是那么可怕，不过里面有点新意哦。让我们进入参数看看。第一个参数是你要锁定的表面内存的矩形区域。看看图6.11。DirectDraw允许你只锁定表面内存的一部分。知道你可以只更新表面的某部分而无需全部锁定整个表面是件很棒的事。但大多数情况下，为了图省事，你大可就把整个表面锁定了。这时只需给第一个参数传NULL即可。

　　     图6.11 IDirectDrawSurface 7->Lock(…)

　　第二个参数是一个DDSURFACEDESC2结构地址，该结构填充了你所要求的那个表面的相关信息。一般，传个空DDSURFACEDESC2即可。下一个参数，dwFlags, 告诉 Lock()


　　你要做什么。表6.7包括了一些常用值。

　　                            表 6.7.  Lock() 的控制标志 

　　     值                                    描述

　　DDLOCK_READONLY    表明这个被锁定的表面将为只读的。 

　　DDLOCK_SURFACEMEMORYPTR 表明将返回一个指向具体矩形顶端的有效内存指针将被返回。如果没指定矩形则返回表面的顶端（这是默认操作）。

　　DDLOCK_WAIT    如果由于一个正在进行的块传输操作而一时无非锁定表面，则函数将不断从事知道锁定或有错误发生，比如 DDERR_SURFACEBUSY。

　　DDLOCK_WRITEONLY    表明这个锁定的表面将是可写的。 

　　注意：我加粗的是常用的标志。

　　最后一个参数是为了一个高级Win32特性，叫事件。设它为NULL吧。

　　锁定一个主表面真是容易。你所要做的便是要求一个指向表面的指针，此时让DirectDraw等待直到表面可用了。下面是代码：

　　DDSURFACEDESC2 ddsd; // this will hold the results of the lock

　　// clear the surface description out always

　　memset(&ddsd, 0, sizeof(ddsd));

　　// set the size field always

　　ddsd.dwSize = sizeof(ddsd);

　　// lock the surface

　　if (FAILED(lpddsprimary->Lock(NULL,

　　          &ddsd,

　　          DDLOCK_SURFACEMEMORYPTR | DDLOCK_WAIT,NULL)))

　　{

　　// error

　　} // end if

　　// ****** 此刻我们讨论中有两个域： ddsd.lPitch 其含有每行

　　// 内存间隔和ddsd.lpSurface其是一个指向被锁表面左上角的指针

　　一旦你锁定了表面，你就可以自由操作表面内存了。每行内存间隔储存在ddsd.lPitch中，而指向真实表面的指针是lpSurface. 所以，如果你在8位模式下e (每像素1字节1)，下面的函数可在主表面的任何地方绘制像素。

　　inline void Plot8(int x, int y,  // position of pixel

　　             UCHAR color,   // color index of pixel

　　             UCHAR *buffer, // pointer to surface memory

　　             int mempitch)  // memory pitch per line

　　{

　　// this function plots a single pixel

　　buffer[x+y*mempitch] = color;

　　} // end Plot8

　　下面是你如何使用上面那个函数在（100，20）上画一个像素，颜色是颜色索引号26对应的颜色：

　　Plot8(100,20,26, (UCHAR *)ddsd.lpSurface,(int)ddsd.lPitch);

　　类似的，这里是一个16位 5.6.5 RGB 模式的绘图函数:

　　inline void Plot16(int x, int y,  // position of pixel

　　             UCHAR red,

　　             UCHAR green,

　　             UCHAR, blue  // RGB color of pixel

　　             USHORT *buffer, // pointer to surface memory

　　             int mempitch)   // memory pitch bytes per line

　　{

　　// this function plots a single pixel

　　buffer[x+y*(mempitch>>1)] = __RGB16BIT565(red,green,blue);

　　} // end Plot16

　　而下面，是你如何在(300,100) 用 RGB值(10,14,30)画一个像素:

　　Plot16(300,100,10,14,30,(USHORT *)ddsd.lpSurface,(int)ddsd.lPitch);

　　现在，一旦你对当前动画帧的所有视频表面的访问都结束时，你需要解锁表面。这用IDirectDrawSurface7::Unlock() 来完成，如下所示：

　　HRESULT Unlock(LPRECT lpRect);

　　你发给Unlock() 你在锁定时的那个矩形，或者如果你锁定整个表面则设参数为NULL。这种情况下你所做的便是解锁整个表面。

　　if (FAILED(lpddsprimary->Unlock(NULL)))

　　  {

　　  // error

　　  } // end if

　　打完收功。现在让我们把所有步骤放在一起来做一个在屏幕上画随机像素的程序（没做错误处理）：

　　LPDIRECTDRAW7 lpdd = NULL; // DirectDraw 7.0 interface 7

　　LPDIRECTDRAWSURFACE7 lpddsprimary = NULL; // surface ptr

　　DDSURFACEDESC2      ddsd;    // surface description

　　LPDIRECTDRAWPALETTE lpddpal = NULL; // palette interface

　　PALETTEENTRY palette[256]; // palette storage

　　// first create base IDirectDraw 7.0 interface

　　DirectDrawCreateEx(NULL, (void **)&lpdd, IID_IDirectDraw7, NULL);

　　// set the cooperative level for full-screen mode

　　lpdd->SetCooperativeLevel(hwnd,

　　                          DDSCL_FULLSCREEN |

　　                          DDSCL_ALLOWMODEX |

　　                          DDSCL_EXCLUSIVE |

　　                          DDSCL_ALLOWREBOOT);

　　// set the display mode to 640x480x256

　　lpdd->SetDisplayMode(640,480,8,0,0);

　　// clear ddsd and set size

　　memset(&ddsd,0,sizeof(ddsd));

　　ddsd.dwSize = sizeof(ddsd);

　　// enable valid fields

　　ddsd.dwFlags = DDSD_CAPS;

　　// request primary surface

　　ddsd.ddsCaps.dwCaps = DDSCAPS_PRIMARYSURFACE;

　　// create the primary surface

　　lpdd->CreateSurface(&ddsd, &lpddsprimary, NULL);

　　// build up the palette data array

　　for (int color=1; color < 255; color++)

　　   {

　　   // fill with random RGB values

　　   palette[color].peRed   = rand()%256;

　　   palette[color].peGreen = rand()%256;

　　   palette[color].peBlue  = rand()%256;

　　   // set flags field to PC_NOCOLLAPSE

　　   palette[color].peFlags = PC_NOCOLLAPSE;

　　   } // end for color

　　// now fill in entry 0 and 255 with black and white

　　palette[0].peRed   = 0;

　　palette[0].peGreen = 0;

　　palette[0].peBlue  = 0;

　　palette[0].peFlags = PC_NOCOLLAPSE;

　　palette[255].peRed   = 255;

　　palette[255].peGreen = 255;

　　palette[255].peBlue  = 255;

　　palette[255].peFlags = PC_NOCOLLAPSE;

　　// create the palette object

　　lpdd->CreatePalette(DDPCAPS_8BIT |DDPCAPS_ALLOW256 |

　　                    DDPCAPS_INITIALIZE,

　　                    palette,&lpddpal, NULL);

　　// finally attach the palette to the primary surface

　　lpddsprimary->SetPalette(lpddpal);

　　// and you're ready to rock n roll!

　　// lock the surface first and retrieve memory pointer

　　// and memory pitch

　　// clear ddsd and set size, never assume it's clean

　　memset(&ddsd,0,sizeof(ddsd));

　　ddsd.dwSize = sizeof(ddsd);

　　lpddsprimary->Lock(NULL, &ddsd,

　　             DDLOCK_SURFACEMEMORYPTR | DDLOCK_WAIT, NULL);

　　// 此时ddsd.lPitch 和 ddsd.lpSurface的值都有效了。

　　// make a couple aliases to make code cleaner, so we don't

　　// have to cast

　　int mempitch        = ddsd.lPitch;

　　UCHAR *video_buffer = ddsd.lpSurface;

　　// plot 1000 random pixels with random colors on the

　　// primary surface, they will be instantly visible

　　for (int index=0; index<1000; index++)

　　   {

　　   // select random position and color for 640x480x8

　　   UCHAR color = rand()%256;

　　   int x = rand()%640;

　　   int y = rand()%480;

　　   // plot the pixel

　　   video_buffer[x+y*mempitch] = color;

　　   } // end for index

　　// now unlock the primary surface

　　lpddsprimary->Unlock(NULL);

　　当然，我跳过了所有的诸如窗口初始化和事件循环之类的但是这种跳过没改变我所要讲的东西。然而为了完整性，看看CD上的DEMO6_3.CPP 和与之关联的DEMO6_3.EXE。它们包含前述应当插入到你游戏控制台程序的Main()函数的代码。下面的代码列出了对Game_Init()函数的更新。图6.12是该程序的一个截图。

　　               图6.12 DEMO6_3.EXE 在运行

　　int Game_Main(void *parms = NULL, int num_parms = 0)

　　{

　　// this is the main loop of the game, do all your processing

　　// here

　　// for now test if user is hitting ESC and send WM_CLOSE

　　if (KEYDOWN(VK_ESCAPE))

　　  SendMessage(main_window_handle,WM_CLOSE,0,0);

　　// plot 1000 random pixels to the primary surface and return

　　// clear ddsd and set size, never assume it's clean

　　memset(&ddsd,0,sizeof(ddsd));

　　ddsd.dwSize = sizeof(ddsd);

　　if (FAILED(lpddsprimary->Lock(NULL, &ddsd,

　　                  DDLOCK_SURFACEMEMORYPTR | DDLOCK_WAIT,

　　                  NULL)))

　　  {

　　  // error

　　  return(0);

　　  } // end if

　　// now ddsd.lPitch is valid and so is ddsd.lpSurface

　　// make a couple aliases to make code cleaner, so we don't

　　// have to cast

　　int mempitch        = (int)ddsd.lPitch;

　　UCHAR *video_buffer = (UCHAR *)ddsd.lpSurface;

　　// plot 1000 random pixels with random colors on the

　　// primary surface, they will be instantly visible

　　for (int index=0; index < 1000; index++)

　　   {

　　   // select random position and color for 640x480x8

　　   UCHAR color = rand()%256;

　　   int x = rand()%640;

　　   int y = rand()%480;

　　   // plot the pixel

　　   video_buffer[x+y*mempitch] = color;

　　   } // end for index

　　// now unlock the primary surface

　　if (FAILED(lpddsprimary->Unlock(NULL)))

　　  return(0);

　　// sleep a bit

　　Sleep(30);

　　// return success or failure or your own return code here

　　return(1);

　　} // end Game_Main

　　////////////////////////////////////////////////////////////

　　int Game_Init(void *parms = NULL, int num_parms = 0)

　　{

　　// this is called once after the initial window is created and

　　// before the main event loop is entered, do all your initialization

　　// here

　　// first create base IDirectDraw interface

　　if (FAILED(DirectDrawCreateEx(NULL, (void **)&lpdd, IID_IDirectDraw7, NULL)))

　　  {

　　  // error

　　  return(0);

　　  } // end if

　　// set cooperation to full screen

　　if (FAILED(lpdd->SetCooperativeLevel(main_window_handle,

　　                   DDSCL_FULLSCREEN | DDSCL_ALLOWMODEX |

　　                   DDSCL_EXCLUSIVE | DDSCL_ALLOWREBOOT)))

　　  {

　　  // error

　　  return(0);

　　  } // end if

　　// set display mode to 640x480x8

　　if (FAILED(lpdd->SetDisplayMode(SCREEN_WIDTH,

　　                 SCREEN_HEIGHT, SCREEN_BPP,0,0)))

　　  {

　　  // error

　　  return(0);

　　  } // end if

　　// clear ddsd and set size

　　memset(&ddsd,0,sizeof(ddsd));

　　ddsd.dwSize = sizeof(ddsd);

　　// enable valid fields

　　ddsd.dwFlags = DDSD_CAPS;

　　// request primary surface

　　ddsd.ddsCaps.dwCaps = DDSCAPS_PRIMARYSURFACE;

　　// create the primary surface

　　if (FAILED(lpdd->CreateSurface(&ddsd, &lpddsprimary, NULL)))

　　  {

　　  // error

　　  return(0);

　　  } // end if

　　// build up the palette data array

　　for (int color=1; color < 255; color++)

　　   {

　　   // fill with random RGB values

　　   palette[color].peRed   = rand()%256;

　　   palette[color].peGreen = rand()%256;

　　   palette[color].peBlue  = rand()%256;

　　   // set flags field to PC_NOCOLLAPSE

　　   palette[color].peFlags = PC_NOCOLLAPSE;

　　   } // end for color

　　// now fill in entry 0 and 255 with black and white

　　palette[0].peRed   = 0;

　　palette[0].peGreen = 0;

　　palette[0].peBlue  = 0;

　　palette[0].peFlags = PC_NOCOLLAPSE;

　　palette[255].peRed   = 255;

　　palette[255].peGreen = 255;

　　palette[255].peBlue  = 255;

　　palette[255].peFlags = PC_NOCOLLAPSE;

　　// create the palette object

　　if (FAILED(lpdd->CreatePalette(DDPCAPS_8BIT | DDPCAPS_ALLOW256 |

　　                               DDPCAPS_INITIALIZE,

　　                               palette,&lpddpal, NULL)))

　　{

　　// error

　　return(0);

　　} // end if

　　// finally attach the palette to the primary surface

　　if (FAILED(lpddsprimary->SetPalette(lpddpal)))

　　   {

　　   // error

　　   return(0);

　　   } // end if

　　// return success or failure or your own return code here

　　return(1);

　　} // end Game_Init

　　关于这个demo程序代码，唯一我要提醒你注意的细节是主窗口的建立。如下所示：

　　// create the window

　　if (!(hwnd = CreateWindowEx(NULL,                   // extended style

　　                          WINDOW_CLASS_NAME,       // class

　　                          "T3D DirectX Pixel Demo", // title

　　                                                    WS_POPUP | WS_VISIBLE,

　　                         0,0,    // initial x,y

　　                         640,480,  // initial width, height

　　                         NULL,    // handle to parent

　　                         NULL,    // handle to menu

　　                         hinstance, // instance of this application

　　                         NULL)))    // extra creation parms

　　return(0);

　　注意，使用 WS_POPUP而非WS_OVERLAPPEDWINDOW 窗口样式。如果你还记得，这个WS_POPUP样式是所有控件和窗口GUI的默认样式。而你在全屏DirectX程序中也要用它。

　　清理

　　在到本章最后之前，我要讨论一些我目前一直搁置的话题--资源管理。这个话题够讨厌的吧!总之，这个看上去无趣的概念简单地意味着；确信你但你用万DirectDraw或DirectX对象时一般都要Release() 它们。比如如果你看看源代码 DEMO6_3.CPP, 在函数 Game_Shutdown() 你将看到一系列对函数Release() 的调用，以释放所有DirectDraw对象给操作系统，以及DirectDraw自己。如下所示：

　　int Game_Shutdown(void *parms = NULL, int num_parms = 0)

　　{

　　// this is called after the game is exited and the main event

　　// loop while is exited, do all you cleanup and shutdown here

　　// first the palette

　　if (lpddpal)

　　  {

　　  lpddpal->Release();

　　  lpddpal = NULL;

　　  } // end if

　　// now the primary surface

　　if (lpddsprimary)

　　  {

　　  lpddsprimary->Release();

　　  lpddsprimary = NULL;

　　  } // end if

　　// now blow away the IDirectDraw7 interface

　　if (lpdd)

　　  {

　　  lpdd->Release();

　　  lpdd = NULL;

　　  } // end if

　　// return success or failure or your own return code here

　　return(1);

　　} // end Game_Shutdown

　　一般，一旦你用完了对象你就该释放它们，而且你应当以创建它们相反的顺序释放它们。比如，你先后创建了DirectDraw对象，主表面，和调色板，则较好的释放顺序是调色板，表面，最后是DirectDraw，像下面这样：

　　// first kill the palette

　　if (lpddpal)

　　  {

　　  lpddpal->Release();

　　  lpddpal = NULL;

　　  } // end if

　　// now the primary surface

　　if (lpddsprimary)

　　   lpddsprimary->Release();

　　// and finally the directdraw object itself

　　if (lpdd)

　　  {

　　  lpdd->Release();

　　  lpdd = NULL;

　　  } // end if

　　警告：

　　在你调用Release（）之前，注意测试接口指针是否非NULL。这样做是完全必要的，因为接口指针可能为NULL的，而如果接口的实现没考虑到释放一个已是NULL的指针这种情况的话，这种释放是会导致一些问题的。

　　总结：

　　本章，你学会了基本的DirectDraw知识，我们花了很大篇幅讲了如何让DirectDraw工作，以及如何使其在全屏模式下工作。同样，我们也触及了调色板，显示表面，和全屏与窗口应用程序的不同。下一章，我将加大油门，我们将学习很多东西，所以宝贝，系好安全带哦