C++ Builder是一个可视化的C++编程环境，它为编程人员提供了一种方便高效、简便的C++语言开发工具，因此已为广大C++程序员所青睐，DirectX开发工具包是微软公司提供的一套Windows9X下开发高性能图形、声音、输入输出和网络游戏的接口，其高效的直接硬件访问、程序与硬件设备之间的相对独立等特性，几乎使得DirectX成为唯一可以在Windows操作系统下开发游戏程序的基本工具软件。
虽然C++ Builder中直接包含了一套DirectX3的开发包，也提供了一些例程，但是这些例程没有系统化的说明，同时也不适合DirectX5以上的程序开发。另一方面，几乎所有关于DirectX开发的书籍和文献均使用Visual C++语言描述，所以作者将自己在C++ Builder中的一些开发经验介绍给读者。
本文适合具备C++ Builder面向对象编程经验的读者，实例开发环境为中文Windows98、C++ Builder4、DirectX6或以上的开发工具包。
一.DirectX简介
1_1.DirectX的特性
1_2.DirectX是一种Windows环境下标准的高性能游戏、多媒体开发工具包，使用DirectX开发的程序能够与操作系统默契地配合成为“真正”的桌面应用程序；可以利用硬件厂商提供的驱动程序接口，充分最佳的设备性能；通过直接底层硬件操作，实现最快速、短延时、设备无关的底层接口。
1_3.DirectX采用了组件对象模型（COM）标准，因此对于不同对象的版本可以有不同的接口，这使得用DirectX开发的程序在未来将得到完全兼容和支持的保证。
1_4.DirectX的结构
DirectX需要以设备无关的方法提供设备相关的性能，所以DirectX的结构是由两个驱动程序构成：硬件抽象层（HAL）和硬件模拟层（HEL），当Direct对象创建时，会同时建立一张“兼容表”，其中记录了当前硬件系统支持的功能，当DirectX需要实现某个功能时就查询该表，得到硬件对功能的支持信息，假如功能能够得到硬件支持，则向HAL发出求，以得到硬件的支持，否则向HEL发出请求，以模拟方式实现功能。
1_5.DirectX的主要组成
(1)DirectDraw：直接访问图形硬件，治理用于显示的内存(显示内存和系统内存)，提供高速图形和页面切换动画；
(2)Direct3D：提供3D硬件接口；
(3)DirectInput：主要支持输入服务，同时支持输出设备；
(4)DirectSound：提供3D声音效果，治理声卡内存；
(5)DirectPlay：提供网络多人游戏的通讯、组织功能；
(6)DirectSetup：自动安装DirectX驱动程序。
本文将按照DirectX的上述组成，分别以实例介绍其在C++ Builder中的实现方法。
二.DirectDraw程序设计
2.1 DirectDraw实现的基础—显示方式的设置
设计图形程序首先碰到的问题是将屏幕设置成一种合适的图形显示方式，然后把图形绘画到屏幕页面上。假如您在DOS下开发图形应用程序，这将是很简单的事，只要调用DOS的中断服务程序即可实现，但是使用用DirectDraw就比较复杂。由于DirectDraw的设计目标是提供设备无关的编程接口和高效、多功能的硬件访问支持，所以DirectDraw需要考虑更多的问题。
DirectDraw在Windows环境下支持两种图形方式：全屏幕独占方式和窗口方式。这里我先以全屏幕独占方式，介绍DirectDraw设置屏幕显示方式步骤，函数具体使用格式和编程方法将在2.2中介绍：
2.1.1 选择硬件设备
计算机系统不一定只有一个DirectDraw硬件抽象设备，例如，一台计算机可能有两台或更多的显示器，那么DirectDraw对象与哪个HAL对应呢？我们可以使用DirectDrawEnumerate函数来枚举系统所有已安装的设备，以供选择，并返回设备的唯一标识GUID。DirectDraw默认主显示设备的GUID为NULL；
2.1.2 创建DirectDraw对象
由于DirectX是使用面向对象的程序设计技术，因此，使用DirectDraw编程就首先要创建DirectDraw对象。使用DirectDrawCreate函数及将第一步获得的设备GUID作为参数可以创建基于所选设备的DirectDraw对象；
2.1.3 获取DirectDraw更高版本的COM接口
假如您不打算使用DirectX5以上版本提供的功能则可以跳过本步骤，否则必须使用新创建DirectDraw对象的QueryIntrface方法来获得IDirectDraw2或更高的COM接口。在2.2例中将介绍如何获得DirectX5以上版本提供的IDirectDraw2接口；
2.1.4 设置协作级别
协作方式可以控制程序与系统其他应用程序之间的交互关系，典型的例子是：设置为全屏独占方式还是窗口普通方式。设置协作级别可以用DirectDraw对象的SetCooperativeLevel方法；
2.1.5 枚举设备支持的各种显示方式，选择并设置合适的显示分辩率、色彩深度和刷新频率等。
使用DirectDraw的EnumDisplayModes方法可以枚举设备支持的所有图形方式供用户选择，在某些已确定图形显示方式的应用程序中可以通过此枚举功能来检查系统设备是否支持指定的图形显示方式。
使用DirectDraw的SetDisplayMode方法可以设置所需要的图形显示方式。
2.2 用DirectDraw设置屏幕图形显示方式的实例
现在我们开始编写第一个示例程序“设置全屏幕独占图形显示方式的程序”dx1，首先我们将在这里讨论C++ Builder中进行DirectX编程的有关问题，然后再具体介绍实现程序每一步骤的相关技术。
2.2.1 dx1程序运行过程介绍
dx1是根据DirectDraw设置屏幕图形方式的过程设计的，运行界面如图2.1所示。在窗口右边有六个功能按钮，它们按照屏幕图形显示方式设置实现的步骤自上而下排列，程序开始运行时，除第一个按钮“显示设备的枚举”是可用的，其它按钮均不可用。由于用户必需按照固定的步骤操作，所以，当一个按钮任务完成后，dx1程序会将下一步任务的
图2.1 dx1 屏幕显示方式设置程序运行界面
按钮设为可用。
按下“显示设备枚举”按钮后，窗口左上方“运行状态”对应的文本框中将显示任务完成情况，若成功则显示“Enumerate devices OK!”,否则显示“Enumerate devices failed!” ，同时在状态组中的设备枚举下拉框中可以看到枚举的设备（一般系统只有一个”主显示设备—Display）；确定设备枚举选择为“主显示设备”后，可以进行“创建DirectDraw对象”、“获得COM的IDIRECT2接口”、“设置协作级别”，每个步骤的运行状态都会显示在“运行状态”右边的文本框中；在执行了“DDraw2显示模式的枚举”后，状态组下方“显示模式DDraw2”下拉框中将列出所有显示设备支持的显示方式，选择需要的图形显示方式，再按“设置DDraw2”的显示方式，屏幕就会马上切换为指定的显示方式。
2.2.2 dx1编程实现
启动C++ Builder后在窗口Form1中设计如图2.1的操作界面，各对象相关属性设置如表2.1：
控件对象类型 控件对象名称 相关属性 属性值
TForm Form1 Caption DirectX 练习程序1
TLabel Label1 Caption 运行状态：
TLabel Label2 Caption 设备的枚举
Tlabel Label3 Caption 显示模式DDraw2
TEdit Edit1 Text (空)
ReadOnly true
TGroupBox GroupBox1 Caption 状态
TCombBox ComboBox1 Text (空)
TCombBox ComboBox2 Text (空)
TGroupBox GroupBox2 Caption 协作级别
TCheckBox CheckBox1 Caption DDSCL_ALLOWMODEX
TCheckBox CheckBox2 Caption DDSCL_ALLOWREBOOT
TCheckBox CheckBox3 Caption DDSCL_EXCLUSIVE
Checked true
TCheckBox CheckBox4 Caption DDSCL_FULLSCREEN
Checked true
TCheckBox CheckBox5 Caption DDSCL_NORMAL
TCheckBox CheckBox6 Caption DDSCL_NOWINDOWCHANGES
Checked true
TButton Button1 Caption 设备的枚举
TButton Button2 Caption 创建DirectDraw对象
Enabled false
TButton Button3 Caption 获得COM的IDIRECT2接口
Enabled false
TButton Button4 Caption 设置协作级别
Enabled false
TButton Button5 Caption DDraw2显示模式的枚举
Enabled false
TButton Button6 Caption 设置DDraw2的显示方式
Enabled false
表2.1 dx1控件对象属性设置一览表
确定已安装了DirectX5以上的SDK，且在C++Builder中已经将Project/Options/中标签页“Directories/Conditionals”上的“Include Path”和“Library Path”添加了DirectX5或以上SDK的路径。
在窗口模块中包含 #include "ddraw.h" 头文件。
现在可以开始编写代码了，我们按照按钮的顺序逐个实现每个步骤的任务。
2.2.2.1 设备的枚举
DirectDraw提供了一个函数DirectDrawEnumerate 来实现设备枚举功能，此函数的调用格式为：
HRESULT DirectDrawEnumerate (LPDDENUMCALLBACK lpcallback LPVOID lpContext)
(1)参数lpcallback是一个回调函数的地址指针。所谓回调函数是程序员自己编写的函数，当枚举函数每枚举一个设备时就调用这个回调函数一次，并把当前枚举的设备有关信息通过参数传递给回调函数处理。
在dx1程序中，回调函数命名为EnumDeviceCallBack，负责将每次枚举出的设备的描述和名称加入到ComboBox1的列表中去，并把设备标识地址指针保存到一个lpDevices数组中以便创建DirectDraw对象时使用。
(2)参数lpContext是一用户定义的上下文变量，我们仅取值NULL就可以了。
(3)DirectDrawEnumerate为回调函数指针，该函数的格式为：
BOOL WINAPI EnumDeviceCallBack (GUID FAR *lpGUID,
LPSTR lpDevice,
LPSTR lpDeviceName,
LPVOID lpContex)
其中：参数lpGUID 为当前枚举设备标识地址指针；参数lpDevice 为设备描述的地址指针；参数lpDeviceName 为设备名称的地址指针；参数 lpContext 为上下文变量地址指针，这里我们不使用它。在dx1程序中，此回调函数负责将所枚举设备的名称和描述显示在ComboBox1中，并将设备标识地址保存到lpDevices数组中。为了简化程序，这里的lpDevices数组只采用了静态数组，最多答应保存10个元素。后面在保存显示模式枚举信息时使用的DisplayModes数组也是为了简化程序，在实际编程时可以考虑动态分配。 需要说明的是，回调函数应该是一个独立的函数，不要把它们声明为窗口类的成员函数（否则回调不能进行），而只要声明为普通函数就可以了。
2.2.2.2 创建DirectDraw对象
在进行DirectDraw编程之前，必需首先用DirectDrawCreate函数创建DirectDraw对象，并获得该对象的入口指针。该函数格式如下：
HRESULT DirectDrawCreate(GUID FAR *lpDD,
LPDIRECTDRAW FAR &lplpDD,
Iunknown FAR *p)
(1)参数lpDD为指定的设备标识指针(为NULL时是主设备)，在dx示例程序中的第一个按钮“设备的枚举”采用静态数组保存枚举设备的标识指针，在第二个按钮创建DirectDraw对象时，可根据用户在ComboBox1中的选择，提供一个设备标识指针，以便对该设备创建DirectDraw对象。
(2)参数 lplpDD 为对象创建成功后的获得IditrctDraw接口指针。
(3)参数p未使用，直接为NULL。
2.2.2.3 获得COM的IDIRECT2接口
由于DirectX采用了对象组件模型COM技术（这里不再介绍），因此假如我们需要使用DirectX5或以上版本提供的功能，就需要获得更高的IDirectDraw接口，例如：假如我们使用DirectX5开发包，就需要获得IDirectDraw2接口。
可以利用HRESULT IdirectDraw::QueryInterface方法获得高版本接口：
lpDD->QueryInterface(IID_IDirectDraw2,
(LPVOID *)LPDIRECTDRAW2 &lpDD2)
参数IID_IDirectDraw2是一个常量。
lpDD2是为获得的IdDrectDraw2接口指针。
假如您需要使用更高版本的开发包，也可以用此方法获得IDirectDraw3或更高的接口。高版本接口获得后，就可以释放低版本的接口了，方法是：lpDD->Release();
2.2.2.4 设置协作级别
玩过DirectX游戏的朋友可能都领略过“全屏独占”和“窗口”两种图形模式，这就可以称为不同的协作级别，它控制应用程序与系统及其它应用程序的交互程度，因此我们必需用HRESULT IDIRECTDRAW2::SetCooperateLevel方法设置应用程序的协作级别。
LpDD2->SetCooperateLevel(HWND handle,DWord dwFlag)
(1)参数handle是当前应用程序窗口的句柄，在C++Builder中，TForm类的Handle属性就是当前应用程序窗口的句柄。
(2)参数dwFlag是协作标志，可以为表2.2中定义之一或多个之和。
序号 标志 说明
（1） DDSCL_ALLOWMODEX 答应使用Mode X模式。必须与（3）、（4）组合使用
（2） DDSCL_ALLOWREBOOT 当使用(3)、(4)时答应用户进行热启动
（3） DDSCL_EXCLUSIVE 使用独占方式，与(4)一起使用
（4） DDSCL_FULLSCREEN 全屏方式，与(3)一起使用
（5） DDSCL_NORMAL 以普通应用程序窗口方式运行
（6） DDSCL_NOWINDOWCHANGES DirectDraw不能自动最小化或恢复窗口
表2.2 dwFlag标志定义
在我们的dx1示例程序中，默认设置为：
DDSCL_EXCLUSIVEDDSCL_FULLSCREENDDSCL_NOWINDOWCHANGES
2.2.2.5 DDraw2显示模式的枚举
利用HRESULT IDIRECTDRAW2::EnumDisplayModes方法及其相应的回调函数可以列出系统显示设备所支持的显示方式。您开发的应用程序可以判定当前运行的计算机是否支持所需的显示方式，也可以提供用户选择显示方式的功能。
lpDD2->EnumDisplayModes(DWORD dwFlag,
LPDDSURFACEDESC lpDDSurfaceDesc,
LPVOID lpContext,
LPDDENUMMODESCALLBACK EnumDisplayModesCallBack
(1)参数dwFlag是标志参数，可以为DDEDM_REFRESHRATES（枚举不同刷新频率的刷新模式）和DDEDM_STANDARDVGAMODES（枚举模式中包含Mode13）两者之一或之和，在dx1程序中采用了后者。
(2)参数lpDDSurfaceDesc是一个过滤显示模式的结构，只要设置为NULL就可以获得全部显示模式的枚举，否则只获得满足指定模式的枚举。
LPDDSURFACEDESC是一个结构，其中包含了显示模式有关信息，主要有:
屏幕点阵 DWORD dwWidth、DWORD dwHeight;
色彩深度 DWORD ddpfPixelFormat.dwRGBBitCount
屏幕刷新频率 DWORD dwRefreshRate
(3)参数lpContex为用户上下文变量，设为NULL就可以了。
(4)参数EnumDisplayModesCallBack为回调函数指针，该回调函数规定有如下参数格式：
BOOL WINAPI EnumDisplayModesCallBack(LPDDSURFACEDESC lpDDSurfaceDesc
LPVOID lpContext)
其中：lpDDSurfaceDesc为当前所枚举显示模式的信息，lpContext为用户上下文变量。
在dx1程序中，此回调函数负责将每次回调的显示模式信息显示到ComboBox2中，并记录到一个结构数组DisplayModes中。
2.2.2.6 设置DDraw2的显示方式
每当用户选择了一个显示模式并点击“设置DDraw2的显示方式”按钮后，dx1将使用RESULT IdirectDraw2::SetDisplayMode方法改变显示方式。
lpDD2->SetDisplayModes(DWORD dwWidth,
DWORD dwHeight,
DWORD dwRGBCount,
DWORD dwRefreshRate,
DWORD dwFlags)
(1)参数dwWidth和dwHeght为显示指定方式的点阵。
(2)参数dwRGBCount为颜色深度，如：8（256色）、16（16位色）、24（真彩色）。
(3)参数dwRefreshRate为刷新频率，不关心时可以设置为0。
(4)参数dwFlags为使用DDSDM_STANDARDVGAMODE来设置Mode13。在dx1程序中始终设为0。
需要注重的是在IdirectDraw接口中，设置显示模式方法不支持dwRefreshRate和dwFlags这两个参数，所以，在有些资料中（包括C++Builder4的示例）均只介绍了DirectX3支持的IDirectDraw::SetDisplayMode(dwWidth,dwHeight,dwRGBCount)方法，请读者注重它们的区别。
2.2.2.7 退出dx1程序需要做的事
不要忘记释放lpDD2接口。LpDD2->Release();
2.2.3 dx1源程序
2.2.3.1 dx1主要文件的组成为：工程文件(dx1.bpr)、窗口文件(main.cpp)、头文件(main.h)。
2.2.3.2 头文件main.h
#ifndef mainH
#define mainH
//---------------------------------------------------------------------------
#include <Classes.hpp>
#include <Controls.hpp>
#include <StdCtrls.hpp>
#include <Forms.hpp>
//---------------------------------------------------------------------------
class TForm1 : public TForm
{
__published: // IDE-managed Components
（略）
private: // User declarations
LPDIRECTDRAW FAR lplpDD; /* 获得的 DirectDraw 接口指针 */
LPDIRECTDRAW2 FAR lplpDD2; /* 获得的 DirectDraw2 接口指针 */
public: // User declarations
__fastcall TForm1(TComponent* Owner);
};
//---------------------------------------------------------------------------
extern PACKAGE TForm1 *Form1;
//---------------------------------------------------------------------------
#endif
2.2.3.3 程序文件main.cpp
#include <vcl.h>
#include "d:\tools\dx5sdk\sdk\inc\ddraw.h"
#pragma hdrstop
#include "main.h"
//---------------------------------------------------------------------------
#pragma package(smart_init)
#pragma resource "*.dfm"
TForm1 *Form1;
LPGUID FAR lpDevices[10]; /* 保存枚举设备的标识指针 */
strUCt DisplayModes { DWORD Width,Height,Depth,Rate; } DisplayMode[100];
/* 保存显示设备支持的显示方式 */
//---------------------------------------------------------------------------
__fastcall TForm1::TForm1(TComponent* Owner)
: TForm(Owner)
{
}
//设备枚举回调函数---------------------------------------------------------------------------
BOOL WINAPI EnumDeviceCallBack(GUID FAR *lpGUID,LPSTR lpDevice,
LPSTR lpDeviceName,
LPVOID lpContext)
{ static char i=0;
lpDevices[i]=lpGUID;
i++;
Form1->ComboBox1->Items->Add((AnsiString)lpDevice+"--"+(AnsiString)lpDeviceName);
if(i<10)
return(DDENUMRET_OK);
else
return(DDENUMRET_CANCEL);
}
//枚举设备---------------------------------------------------------------------------
void __fastcall TForm1::Button1Click(TObject *Sender)
{
ComboBox1->Clear();
if(FAILED(DirectDrawEnumerate(EnumDeviceCallBack,NULL)))
Edit1->Text="Enumerate Devices failed!";
else
Edit1->Text="Enumerate Devices OK!";
ComboBox1->ItemIndex=0;
Button1->Enabled=false;
Button2->Enabled=true;
}
//创建DirectDraw对象---------------------------------------------------------------------------
void __fastcall TForm1::Button2Click(TObject *Sender)
{
LPGUID FAR lpD=lpDevices[ComboBox1->ItemIndex];
if(FAILED(DirectDrawCreate(lpD,&lplpDD,NULL)))
Edit1->Text="DirectDraw Create failed!";
else
{
Edit1->Text="DirectDraw Create OK!";
ComboBox1->Enabled=false;
Button2->Enabled=false;
Button3->Enabled=true;
}
}
//获得IDirectDraw2接口---------------------------------------------------------------------------
void __fastcall TForm1::Button3Click(TObject *Sender)
{
if(FAILED(lplpDD->QueryInterface(IID_IDirectDraw2,(LPVOID *)&lplpDD2)))
Edit1->Text="Get IDriectDraw2 Interface Failed!";
else
{
Edit1->Text="Get IDriectDraw2 Interface OK!";
lplpDD->Release(); /* 释放IdirectDraw接口 */
Button3->Enabled=false;
Button4->Enabled=true;
}
}
//设置协作级别---------------------------------------------------------------------------
void __fastcall TForm1::Button4Click(TObject *Sender)
{
DWORD dwFlags=0;
if(CheckBox1->Checked) dwFlags=dwFlagsDDSCL_ALLOWMODEX;
if(CheckBox2->Checked) dwFlags=dwFlagsDDSCL_ALLOWREBOOT;
if(CheckBox3->Checked) dwFlags=dwFlagsDDSCL_EXCLUSIVE;
if(CheckBox4->Checked) dwFlags=dwFlagsDDSCL_FULLSCREEN;
if(CheckBox5->Checked) dwFlags=dwFlagsDDSCL_NORMAL;
if(CheckBox6->Checked) dwFlags=dwFlagsDDSCL_NOWINDOWCHANGES;
if(FAILED(lplpDD2->SetCooperativeLevel(Handle,dwFlags)))
Edit1->Text="Set set cooperative level Failed!";
else
{
Edit1->Text="Set cooperative level OK!";
GroupBox2->Enabled=false;
Button4->Enabled=false;
Button5->Enabled=true;
}
}
//枚举显示模式的回调函数---------------------------------------------------------------------------
BOOL WINAPI EnumDisplayModesCallBack(LPDDSURFACEDESC lpDesc,
LPVOID lpContext)
{
static int i=0;
char buff[256];
wsprintf(buff,"%dx%dx%dx%d",
lpDesc->dwWidth,
lpDesc->dwHeight,
lpDesc->ddpfPixelFormat.dwRGBBitCount,
lpDesc->dwRefreshRate);
Form1->ComboBox2->Items->Add(buff);
DisplayMode[i].Width=lpDesc->dwWidth;
DisplayMode[i].Height=lpDesc->dwHeight;
DisplayMode[i].Depth=lpDesc->ddpfPixelFormat.dwRGBBitCount;
DisplayMode[i].Rate=lpDesc->dwRefreshRate;
i++;
if(i<100)
return(DDENUMRET_OK);
else
return(DDENUMRET_CANCEL);
}
//枚举显示模式---------------------------------------------------------------------------
void __fastcall TForm1::Button5Click(TObject *Sender)
{
ComboBox2->Clear();
if(FAILED(lplpDD2->EnumDisplayModes(DDEDM_STANDARDVGAMODES,
NULL,
NULL,
(LPDDENUMMODESCALLBACK)EnumDisplayModesCallBack)))
Edit1->Text="Enumerate Display Modes failed!";
else
{
Edit1->Text="Enumerate Display Modes OK!";
ComboBox2->ItemIndex=0;
Button5->Enabled=false;
Button6->Enabled=true;
}
}
//设置显示模式---------------------------------------------------------------------------
void __fastcall TForm1::Button6Click(TObject *Sender)
{
if(ComboBox2->ItemIndex<0)
{
ShowMessage("请先在DDraw2下拉框中选择一种显示方式");
return;
}
if(FAILED(lplpDD2->SetDisplayMode(
DisplayMode[ComboBox2->ItemIndex].Width,
DisplayMode[ComboBox2->ItemIndex].Height,
DisplayMode[ComboBox2->ItemIndex].Depth,
DisplayMode[ComboBox2->ItemIndex].Rate,
0)))
Edit1->Text="Set DisplayMode failed!";
}
//退出dx1---------------------------------------------------------------------------
void __fastcall TForm1::FormClose(TObject *Sender, TCloseAction &Action)
{
if(lplpDD2) lplpDD2->Release();
}
QQ病毒
腾讯QQ空间代码专题
PPT教程专题
ADSL应用面面俱到
Fireworks教程专题
计算机和网络技术基础知识
校园网专题
网吧技术专题
