第11章 三维内功心法——Direct3D编程基础
11.1 典型Direct3D 程序流程分析
我们其实不用把3D 编程想象得多么神秘,说白了, 3D 编程就像一只纸老虎。
正所谓万剑归宗,首先介绍一下Direct3D 应用程序的一般框架思路。我们来看一张典型的Direct3D 程序框架图。
从上面这幅框架图中我们可以发现, Direct3D 程序的基本结构是非常简单清晰的,主要可以分为下面5 个部分:
- 创建一个Windows 窗口。
- Direct3D 的初始化。
- 消息循环。
- 渲染图形。
- 结束应用程序,清除在初始化阶段所创建的COM 对象,并退出程序。
我们知道, DirectX 的程序开发就是一个基于SDK 开发包的过程。Direct3D 程序创建过程大体上与普通Win32 窗口程序的创建过程没有太大的的区别,首先需要创建一个具有主窗口的应用程序,并且在显示和更新窗口之前初始化Direct3D ,然后在消息循环中不断对3D 场景进行绘制,机制也都是消息循环的那一套机制。
其中消息循环和Direct3D 的绘制过程是不断在进行的,如果程序中有消息需要处理的话,先处理消息,再进行Direct3D 绘制过程。如果没有消息要处理的话,我们的程序就会不停地渲染图形,直到退出Direct3D 程序。
我们可以简单地这样理解, Direct3D 程序就是在普通Win32 应用程序的基础上,加上了Direct3D 的初始化过程和Direct3D 的绘制过程。作者在配图过程中,专门把Direct3D 独有的部分用虚线和不同的配色与Win32 部分区分开来, 这样更便于理解。然后我们可以这样理解这幅Direct3D 程序流程图,虚线以外的部分为普通Win32 窗口所拥有的常规步骤,而虚线以内的部分为Direct3D 应用程序特有的步骤。
上面已经提到过, Direct3D 特有的部分分为Direct3D 初始化与Direct3D 的绘制,这一节我们着重介绍Direct3D 初始化,Direct3D 的绘制过程将在下文详细介绍。当然,还有光照、矩阵与视角变换等等额外的初始化过程,我们可以把它们都理解为在Direct3D
初始化阶段完成,在这里先不涉及,后文我们会各个击破。
11.2 对COM 接口对象的一些介绍
在第10 章中我们己经提到了COM 接口,我们知道C++与COM 接口配DirectX,是目前Windows 平台下99%的大型游戏采用的开发方案。在这里希望通过这一小节的介绍,我们能对COM接口有一个更深刻的印象。
COM ( Component Object Model ,组件对象模型)是一项能够使DirectX 独立于编程语言并具备向下兼容的技术。我们常称COM 对象为接口,可将其视为一个C++类来使用。在以C++编程语言和COM 接口方式开发的DirectX 应用程序中,可以直接访问COM 接口和对象。
COM 接口对象是一组特定功能的抽象集合,应用程序不能直接访问COM 接口对象,而是必须通过COM 接口对象的接口( interface )的指针来执行COM 接口对象的功能。
COM 接口对象为我们定义了可供程序调用的一组函数(或者说是方法),而接口是包含了函数指针数组的内存结构,其中每一个数组元素包含的是一个由组件所实现的函数地址, 使用方法方面, 类似于C++类的指针。
COM接口都具有前缀大写字母“I”,例如一个管理X文件的COM接口叫ID3DXFile。
另外,使用COM 接口的时候千万要遗忘C++中使用指针的new 和delete 这一套,他们和COM接口是八竿子打不着边的, 因为COM 接口对象与C++类的生命周期有着很大的区别。C++类由new 和delete 运算符控制类对象的生命周期, 而COM 接口对象则通过控制对某对象的引用计数个数来决定其生命周期的。COM 接口对象的引用计数器会记录某对象当前被引用的个数。这样说大家也许会有点不太好理解,举个例子吧, 我们现在创建了一个COM 接口对象,比如就是这篇文章后面会介绍到的Direct3D 初始化四步曲的第一步里初始化IDirect3D9 接口对象的一段代码。
LPDIRECT3D9 pD3D = NULL; //Direct3D接口对象的创建
if( NULL == ( pD3D = Direct3DCreate9( D3D_SDK_VERSION ) ) ) //初始化Direct3D接口对象,并进行DirectX版本协商return E_FAIL;
当一个COM 接口对象被创建时,其引用计数将为1,以后每当程序又创建了这个COM 接口的新对象时,其引用计数就会加1。当程序对该对象引用结束时,我们就需要调用该对象的Release方法释放这个接口,而引用计数将减1。我们需要注意的是,即使引用计数减了1,但是还是不为0 的话,这个对象所占用的内存还是没有被释放的(释放的只是这个COM 接口的对象的引用,而不是这个COM 接口本身。只有当该对象的引用计数减为0 的时候,也就是说所有该对象的引用都已经得到释放后,才会去释放接口的COM 接口对象所占用的内存。且这个内存的释放是COM接口对象自行经营的, COM 接口自有它自己的一套内存管理理念,比较智能,我们只需要自行释放COM 接口对象的引用,让其引用计数为0 即可(也就是养成好习惯用Release 就行了) , COM接口对象的内存释放细节并不要我们去插手。
所以,每当程序中创建或者获得某个COM 接口对象后,我们先开开心心地使用这个接口对象,不过在使用完成之后,我们需要在适当的位置调用它们的Release 方法来释放这个接口, 让引用计数器减1 直到为0,以便在程序退出时能够释放它们所占的内存。
下面这段代码就是与上面的代码段搭配使用的,用于释放COM 接口的一段代码。
#define SAFE_RELEASE(p) { if(p) { (p)->Release(); (p)=NULL; } } //定义一个安全释放宏,便于后面COM接口指针的释放
理解上面介绍的这些COM 接口相关的知识,对付正确使用DirectX 已经完全足够了。
11.3 写一个DirectX 程序通用框架
大家应该记得, 在学习GDI 游戏编程的时候,我们就做过类似的工作。在4.4 节中,我们在3.10 节编写的GameCore 的基础上,新自定义3 个函数。它们分别为封装了资源初始化代码的Game_lnit()函数,封装了所有绘制代码的Game_Paint() 函数,以及用于清理资源的Game_CleanUp()函数。我们这次的做法也差不多,无论是GDI 还是Direct3D ,既然同是基于Win32 窗口程序框架,
肯定是差不多的。
本节将在3. 10 节编写的GameCore 的基础上,新自定义4 个函数。分别是用于Direct3D 初始化的Direct3D_lnit 函数,用于要绘制的物体的初始化的Objects_Init 函数,用于Direct3D 渲染代码的书写的Direct3D_Render 函数,以及清理COM 资源以及其他资源的Direct3D_CleanUp 函数,即如下这4 个函数:
HRESULT Direct3D_Init(HWND hwnd); //在这个函数中进行Direct3D的初始化
HRESULT Objects_Init(HWND hwnd); //在这个函数中进行要绘制的物体的资源初始化
VOID Direct3D_Render(HWND hwnd); //在这个函数中进行Direct3D渲染代码的书写
VOID Direct3D_CleanUp( ); //在这个函数中清理COM资源以及其他资源
因为是一个程序框架而己,目前并没有什么实际上的Direct3D 的代码,所以除了这四个自定义函数的添加, 以及消息循环为之前我们讲解的“游戏循环”体系, 其他基本上与3.10 节我们写的GameCore 一样。这个框架我们取名为D3DdernoCore.为了大家在学习Direct3D 时对示例程序理解更加透彻,下面贴出这个框架的全部代码,这是我们在学习Direct3D 的过程中,唯一一次贴出完整的程序源代码:
//-----------------------------------【程序说明】----------------------------------------------
// 程序名称::D3DdemoCore
// 2013年4月 Create by 浅墨
// 描述:Direct3D程序的核心框架
//------------------------------------------------------------------------------------------------//-----------------------------------【头文件包含部分】---------------------------------------
// 描述:包含程序所依赖的头文件
//------------------------------------------------------------------------------------------------
#include <d3d9.h>//-----------------------------------【库文件包含部分】---------------------------------------
// 描述:包含程序所依赖的库文件
//------------------------------------------------------------------------------------------------
#pragma comment(lib,"winmm.lib") //调用PlaySound函数所需库文件//-----------------------------------【宏定义部分】--------------------------------------------
// 描述:定义一些辅助宏
//------------------------------------------------------------------------------------------------
#define WINDOW_WIDTH 800 //为窗口宽度定义的宏,以方便在此处修改窗口宽度
#define WINDOW_HEIGHT 600 //为窗口高度定义的宏,以方便在此处修改窗口高度
#define WINDOW_TITLE L"【致我们永不熄灭的游戏开发梦想】Direct3D程序的核心框架" //为窗口标题定义的宏
#define SAFE_RELEASE(p) { if(p) { (p)->Release(); (p)=NULL; } } //定义一个安全释放宏,便于后面COM接口指针的释放//-----------------------------------【全局变量声明部分】-------------------------------------
// 描述:全局变量的声明
//------------------------------------------------------------------------------------------------//-----------------------------------【全局函数声明部分】-------------------------------------
// 描述:全局函数声明,防止“未声明的标识”系列错误
//------------------------------------------------------------------------------------------------
LRESULT CALLBACK WndProc( HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam );//窗口过程函数
HRESULT Direct3D_Init(HWND hwnd); //在这个函数中进行Direct3D的初始化
HRESULT Objects_Init(HWND hwnd); //在这个函数中进行要绘制的物体的资源初始化
VOID Direct3D_Render(HWND hwnd); //在这个函数中进行Direct3D渲染代码的书写
VOID Direct3D_CleanUp( ); //在这个函数中清理COM资源以及其他资源//-----------------------------------【WinMain( )函数】--------------------------------------
// 描述:Windows应用程序的入口函数,我们的程序从这里开始
//------------------------------------------------------------------------------------------------
int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance,LPSTR lpCmdLine, int nShowCmd)
{//【1】窗口创建四步曲之一:开始设计一个完整的窗口类WNDCLASSEX wndClass = { 0 }; //用WINDCLASSEX定义了一个窗口类wndClass.cbSize = sizeof( WNDCLASSEX ) ; //设置结构体的字节数大小wndClass.style = CS_HREDRAW | CS_VREDRAW; //设置窗口的样式wndClass.lpfnWndProc = WndProc; //设置指向窗口过程函数的指针wndClass.cbClsExtra = 0; //窗口类的附加内存,取0就可以了wndClass.cbWndExtra = 0; //窗口的附加内存,依然取0就行了wndClass.hInstance = hInstance; //指定包含窗口过程的程序的实例句柄。wndClass.hIcon=(HICON)::LoadImage(NULL,L"icon.ico",IMAGE_ICON,0,0,LR_DEFAULTSIZE|LR_LOADFROMFILE); //本地加载自定义ico图标wndClass.hCursor = LoadCursor( NULL, IDC_ARROW ); //指定窗口类的光标句柄。wndClass.hbrBackground=(HBRUSH)GetStockObject(GRAY_BRUSH); //为hbrBackground成员指定一个白色画刷句柄 wndClass.lpszMenuName = NULL; //用一个以空终止的字符串,指定菜单资源的名字。wndClass.lpszClassName = L"ForTheDreamOfGameDevelop"; //用一个以空终止的字符串,指定窗口类的名字。//【2】窗口创建四步曲之二:注册窗口类if( !RegisterClassEx( &wndClass ) ) //设计完窗口后,需要对窗口类进行注册,这样才能创建该类型的窗口return -1; //【3】窗口创建四步曲之三:正式创建窗口HWND hwnd = CreateWindow( L"ForTheDreamOfGameDevelop",WINDOW_TITLE, //喜闻乐见的创建窗口函数CreateWindowWS_OVERLAPPEDWINDOW, CW_USEDEFAULT, CW_USEDEFAULT, WINDOW_WIDTH,WINDOW_HEIGHT, NULL, NULL, hInstance, NULL );//Direct3D资源的初始化Direct3D_Init (hwnd); //【4】窗口创建四步曲之四:窗口的移动、显示与更新MoveWindow(hwnd,250,80,WINDOW_WIDTH,WINDOW_HEIGHT,true); //调整窗口显示时的位置,使窗口左上角位于(250,80)处ShowWindow( hwnd, nShowCmd ); //调用ShowWindow函数来显示窗口UpdateWindow(hwnd); //对窗口进行更新,就像我们买了新房子要装修一样PlaySound(L"War3XMainScreen.wav", NULL, SND_FILENAME | SND_ASYNC|SND_LOOP); //循环播放背景音乐 MessageBox(hwnd, L"DirectX,等着瞧吧,我们来降服你了~!", L"浅墨的消息窗口", 0); //使用MessageBox函数,显示一个消息窗口//【5】消息循环过程MSG msg = { 0 }; //初始化msgwhile( msg.message != WM_QUIT ) //使用while循环{if( PeekMessage( &msg, 0, 0, 0, PM_REMOVE ) ) //查看应用程序消息队列,有消息时将队列中的消息派发出去。{TranslateMessage( &msg ); //将虚拟键消息转换为字符消息DispatchMessage( &msg ); //该函数分发一个消息给窗口程序。}else{Direct3D_Render(hwnd); //进行渲染}}//【6】窗口类的注销UnregisterClass(L"ForTheDreamOfGameDevelop", wndClass.hInstance); //程序准备结束,注销窗口类return 0;
}//-----------------------------------【WndProc( )函数】--------------------------------------
// 描述:窗口过程函数WndProc,对窗口消息进行处理
//------------------------------------------------------------------------------------------------
LRESULT CALLBACK WndProc( HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam )
{switch( message ) //switch语句开始{case WM_PAINT: // 若是客户区重绘消息Direct3D_Render(hwnd); //调用Direct3D渲染函数ValidateRect(hwnd, NULL); // 更新客户区的显示break; //跳出该switch语句case WM_KEYDOWN: // 若是键盘按下消息if (wParam == VK_ESCAPE) // 如果被按下的键是ESCDestroyWindow(hwnd); // 销毁窗口, 并发送一条WM_DESTROY消息break; //跳出该switch语句case WM_DESTROY: //若是窗口销毁消息Direct3D_CleanUp(); //调用自定义的资源清理函数Game_CleanUp()进行退出前的资源清理PostQuitMessage( 0 ); //向系统表明有个线程有终止请求。用来响应WM_DESTROY消息break; //跳出该switch语句default: //若上述case条件都不符合,则执行该default语句return DefWindowProc( hwnd, message, wParam, lParam ); //调用缺省的窗口过程}return 0; //正常退出
}//-----------------------------------【Direct3D_Init( )函数】--------------------------------------
// 描述:Direct3D初始化函数,进行Direct3D的初始化
//------------------------------------------------------------------------------------------------
HRESULT Direct3D_Init(HWND hwnd)
{if(!(S_OK==Objects_Init(hwnd))) return E_FAIL; //调用一次Objects_Init,进行渲染资源的初始化return S_OK;
}//-----------------------------------【Object_Init( )函数】--------------------------------------
// 描述:渲染资源初始化函数,在此函数中进行要被渲染的物体的资源的初始化
//--------------------------------------------------------------------------------------------------
HRESULT Objects_Init(HWND hwnd)
{return S_OK;
}//-----------------------------------【Direct3D_Render( )函数】--------------------------------------
// 描述:使用Direct3D进行渲染
//--------------------------------------------------------------------------------------------------
void Direct3D_Render(HWND hwnd)
{//暂时为空,且听下回分解
}//-----------------------------------【Direct3D_CleanUp( )函数】--------------------------------
// 描述:资源清理函数,在此函数中进行程序退出前资源的清理工作
//---------------------------------------------------------------------------------------------------
void Direct3D_CleanUp()
{//暂时为空,且听下回分解
}
我们在Direct3D_ Init 函数内部调用的Objects_Init 函数,这表示我们之后的DirectX 程序都会是先初始化Direct3D,再接着初始化游戏资源,而我们只需在WinMain 函数中调用一次Direct3D_lnit 函数就可以了。
另外, 大家需要注意,为了演示DirectX 各项功能的方便性,与代码的易读性,目前我们并没有以类为载体,因为类说实话不适合进行教学,如果我们一上来就用类的方式来写示例程序, 大家很可能都会云里雾里,无形中给大家增添了学习的烦恼。我们的想法是,当后面需要构建功能复杂的游戏程序的时候,再转向面向对象的思想。而我们接下来书写关于Direct3D 的程序,简单点说,
只需做如下这四步就可以了:
- 在Direct3D_lnit() 函数里完成Direct3D 的相关初始化。
- 在Objects_lnit() 函数里完成将要绘制的绘制资源的初始化.
- 在Direct3D_Render() 函数里完成渲染。
- 在Direct3D_CleanUp() 函数里完成资源的清理。
11.4 化腐朽为神奇——Direct3D 初始化四步曲
想要使用Direct3D 来开发游戏程序,首先要做的就是进行Direct3D初始化,这是Direct3D 程序的根本。这一节里,我们通过四步曲的方式,来教大家如何轻而易举地掌握Direct3D 初始化的方法。
作者在这里自己总结,并引入了“ 四步曲”的理念, 这样我们在对Ditect3D 的初始化就有章可循,理解和记忆起来就很容易了。下面我们正式开始。
11.4.1 Direct3D 初始化四步曲概述
- Direct3D 初始化四步曲之一: 创建Direct3D 接口对象(简称: 创接口)。
- Direct3D 初始化四步曲之二: 获取设备硬件信息(简称:取信息) 。
- Direct3D 初始化四步曲之三: 填充D3DPRESENT_PARAMETERS 结构体(简称: 填内容) 。
- Direct3D 初始化四步曲之四: 创建Direct3D 设备接口(简称: 创设备).
11.4.2 Direct3D 初始化四步曲之一:创接口
首先需要注意, Direct3D 接口对象和Direct3D 设备接口不是一个概念, 大家不耍弄混了。
因为我们咬定了采用C++配合COM 接口的方式来进行游戏开发, 所以初始化的第一步就开门见山,与COM 接口相关。
在四步曲的第一步里我们创建一个lDirect3D 接口对象,这步操作主要是为后面的初始化四步曲的第二、三、四步做铺垫, 因为Direct3D 接口对象在手,才能以此作为媒介,完成第二步的设备硬件信息的获取,以及第四步的Direct3D 设备接口的创建。
下面就开始看这一步的具体思路, 首先我们定义一个LPDIRECT3D9 类型的指针pD3D:
LPDIRECT3D9 pD3D = NULL; //Direct3D接口对象的创建
然后将该对象初始化,这时我们会用到一个叫做Direct3DCreate9 的函数,下面先介绍一下这个函数:
我们可以在DirectX SDK 中查到Direct3DCreate9 函数的原型是这样声明的:
IDirect3D9 * Direct3DCreate9(UINT SDKVersion
);
这个函数作用是返回指向IDirect3D9 接口的指针,并进行DirectX 的版本协商。它有一个唯一的参数,UINT 类型的SDKVersion , 表示当前使用的DirectX SDK 的版本,用于确保我们的应用程序所包含的所有头文件在编译时能够与DirectX 运行时的DLL 相匹配。
如果Direct3DCreate9 函数执行失败的话,就会返回NULL,表示在程序中包含的头文件的版本与运行时的DLL 版本不匹配。
所以, Direct3D 初始化四步曲的第一步整体来看,我们就可以这样写:
//--------------------------------------------------------------------------------------// 【Direct3D初始化四步曲之一,创接口】:创建Direct3D接口对象, 以便用该Direct3D对象创建Direct3D设备对象//--------------------------------------------------------------------------------------LPDIRECT3D9 pD3D = NULL; //Direct3D接口对象的创建if( NULL == ( pD3D = Direct3DCreate9( D3D_SDK_VERSION ) ) ) //初始化Direct3D接口对象,并进行DirectX版本协商return E_FAIL;
11.4.3 Direct3D 初始化四步曲之二:取信息
Direct3D 初始化四步曲之二,简称取信息,也就是获取设备的硬件信息。
我们平常比较关心的是我们的显卡是否支持硬件顶点运算,因为这种方式运行起来比较高效。相比而言,软件顶点运算方式就只能自叹不如了。
HRESULT GetDeviceCaps([in] UINT Adapter,[in] D3DDEVTYPE DeviceType,[out] D3DCAPS9 *pCaps
);
· 第一个参数, UINT 类型的Adapter,表示使用的显卡的序号,通常我们都使用其默认值D3DADAPTER_DEFAULT ,表示当前使用的显卡。
· 第二个参数, D3DDEVTYPE 类型的DeviceType , 表示设备的类型, 取值为D3DDEVTYPE结构体的某一成员, D3DDEVTYPE 结构体声明如下:
typedef enum D3DDEVTYPE {D3DDEVTYPE_HAL = 1,D3DDEVTYPE_NULLREF = 4,D3DDEVTYPE_REF = 2,D3DDEVTYPE_SW = 3,D3DDEVTYPE_FORCE_DWORD = 0xffffffff
} D3DDEVTYPE, *LPD3DDEVTYPE;
一般我们只会涉及到硬件设备类型D3DDEVTYPE_HAL 与软件设备类型D3DDEVTYPE_REF ,了解这两个一般就足够了。
· 第三个参数, D3DCAPS9 类型的*pCaps ,我们可以看到它为一个指针,指向一个前面提到过的用于接收包含设备信息的D3DCAPS9 结构体的指针。
我们知道, 顶点是3D 图形学中的基本元素, 而Direct3D 可以有两种不同的顶点运算方式,也就是前面提到过的硬件顶点运算与软件顶点运算。其中, 硬件顶点运算得到了显卡的支持,可以使用硬件专有的加速功能,其执行速度将远远快于软件顶点运算方式。
所以我们在编写Direct3D 的游戏程序的时候, 始终应该优先考虑使用“高富帅”硬件顶点运算方式。但是,或许某些老掉牙的显卡并不支持硬件顶点运算,所以, 我们就需要在Direct3D 初始化过程中,通过GetDeviceCaps 方法检查显卡支持的顶点运算模式。
所以,Direct3D 初始化四步曲的第二步整体来看, 我们就可以这样写:
//--------------------------------------------------------------------------------------// 【Direct3D初始化四步曲之二,取信息】:获取硬件设备信息//--------------------------------------------------------------------------------------D3DCAPS9 caps; int vp = 0;if( FAILED( pD3D->GetDeviceCaps( D3DADAPTER_DEFAULT, D3DDEVTYPE_HAL, &caps ) ) ){return E_FAIL;}if( caps.DevCaps & D3DDEVCAPS_HWTRANSFORMANDLIGHT )vp = D3DCREATE_HARDWARE_VERTEXPROCESSING; //支持硬件顶点运算,我们就采用硬件顶点运算,妥妥的elsevp = D3DCREATE_SOFTWARE_VERTEXPROCESSING; //不支持硬件顶点运算,无奈只好采用软件顶点运算
其中D3DDEVCAPS_HWTRANSFORMANDLIGHT 宏表示显卡可以硬件支持变换和光照。
关于D3DCAPS9 结构体, 用于描述显卡的所有性能参数,由于里面的内容太多了, 而且没有过多介绍的必要性。在这里就不多做说明了,需要的时候,我们可以在DirectX SDK 中进行查阅。
11.4.4 Direct3D 初始化四步曲之三:填内容
这一步非常好理解, 其实就是做一个填空题, 填充D3DPRESENT_PARAMETERS 结构体,完全就是为后面的第四步创建Direct3D 设备接口做准备的。但是为了便于我们的记忆与理解,在这里专门作为一个步骤列举出来。
这个结构体可谓非常地重要,使用Direct3D 一般都需要进行这个结构体的填充工作,希望大家仔细理解。其实各成员的功能看一下它的变量名就可以知道, 顾名思义,比如BackBufferWidth,按字面意思理解,就是后台缓冲区( BackBuffer )的宽度( Width ) 。
我们可以在DirectX SDK 中查到D3DPRESENT_PARAMETERS 的原型声明:
typedef struct D3DPRESENT_PARAMETERS {UINT BackBufferWidth;UINT BackBufferHeight;D3DFORMAT BackBufferFormat;UINT BackBufferCount;D3DMULTISAMPLE_TYPE MultiSampleType;DWORD MultiSampleQuality;D3DSWAPEFFECT SwapEffect;HWND hDeviceWindow;BOOL Windowed;BOOL EnableAutoDepthStencil;D3DFORMAT AutoDepthStencilFormat;DWORD Flags;UINT FullScreen_RefreshRateInHz;UINT PresentationInterval;
} D3DPRESENT_PARAMETERS, *LPD3DPRESENT_PARAMETERS;
下面我们开始无脑地对成员分别进行介绍:
- UINT 类型的BackBufferWidth , 指定后台缓冲区的宽度。
- UINT 类型的BackBufferHeigh , 指定后台缓冲区的高度。
- D3DFORMAT 类型的BackBufferF ormat , 指定后台缓冲区的保存像素格式, 可以用D3DFORMAT 枚举定义。可以用GetDisplayMode 获取当前像素格式。
- UlNT 类型的BackBufferCount,指定后台缓冲区的宽度。
- D3DMUL TIS AMPLE_ TYPE 类型的MultiSampleType,表示多重采样的类型。通常我们将MultiSample Type 设为
- D3DMULTISAMPLE_ NONE,
- DWORD 类型的MultiSampleQuality,表示多重采样的格式。通常我们将其设为0 ,
- D3DSW APEFFECT 类型的SwapEffect,用于指定Direct3D 如何将后台缓冲区的内容复制到前台的缓存中,通常我们都将其设为D3DSWAPEFFECT_DISCARD.
- HWND 类型的hDeviceWindow ,很显然, 就是我们熟知的窗口句柄,这里指定我们需要在哪个窗口上进行绘制。这个参数也可以设为NULL,这时就表示对当前被激活的窗口进行绘制。
- BOOL 类型的Windowed 表示绘制窗体的显示模式,为TRUE 使表示使用窗口模式,为FALSE 则表示使用全屏模式。
- BOOL 类型的EnableAutoDepthStencil,表示Direct3D 是否为应用程序自动管理深度缓存,这个成员为TRUE 的话,表示需要自动管理深度缓存,这时候就需要对下一个成员A utoDepthStencilFormat 进行相关像素格式的设直。关于深度缓存,后面我们有专门的章节进行介绍.
- D3DFORMAT 类型的AutoDepthStencilForrnat 上面刚介绍这如果我们把EnableAutoDepthStencil 成员设为TRUE 的话,在这里就需要指定AutoDepthStenciIFormat 的深度缓冲的像素格式,具体格式可以在结构体D3DFORMAT 中进行选取,后面我们有专门的章节进行介绍。
- DWORD 类型的Flags ,表示附加属性,通常都设为0 。
- UINT 类型的FuUScreen RefreshRatelnHz,表示在全屏模式时指定的屏幕的刷新率,在全屏模式时在EnumAdapterModes 枚举类型中进行取值,我们在全屏模式时将其设为默认值D3DPRESENT_RATE_DEFAULT,窗口模式时这个成员没有意义,我们把它就设为0 了。
- UINT 类型的Presentationlnterval ,用于指定指定后台缓冲区与前台缓冲区的最大交换频率,可在D3DPRESENT 中进行取值。
//--------------------------------------------------------------------------------------// 【Direct3D初始化四步曲之三,填内容】:填充D3DPRESENT_PARAMETERS结构体//--------------------------------------------------------------------------------------D3DPRESENT_PARAMETERS d3dpp; ZeroMemory(&d3dpp, sizeof(d3dpp));d3dpp.BackBufferWidth = WINDOW_WIDTH;d3dpp.BackBufferHeight = WINDOW_HEIGHT;d3dpp.BackBufferFormat = D3DFMT_A8R8G8B8;d3dpp.BackBufferCount = 1;d3dpp.MultiSampleType = D3DMULTISAMPLE_NONE;d3dpp.MultiSampleQuality = 0;d3dpp.SwapEffect = D3DSWAPEFFECT_DISCARD; d3dpp.hDeviceWindow = hwnd;d3dpp.Windowed = true;d3dpp.EnableAutoDepthStencil = true; d3dpp.AutoDepthStencilFormat = D3DFMT_D24S8;d3dpp.Flags = 0;d3dpp.FullScreen_RefreshRateInHz = 0;d3dpp.PresentationInterval = D3DPRESENT_INTERVAL_IMMEDIATE;
11.4.5 Direct3D 初始化四步曲之四:创设备
Direct3D 初始化四步曲之四,简称创设备,也就是Direct3D 设备接口的正式创建。
其实就是利用第一步创建的Direct3D 接口对象调用一下IDirect3D9::CreateDevice 方法, 非常简单。下面我们就来介绍一下这个也非常重要的IDirect3D9::CreateDevice 方法。
我们可以在DirectX SDK 中查到这个方法的原型如下:
HRESULT CreateDevice([in] UINT Adapter,[in] D3DDEVTYPE DeviceType,[in] HWND hFocusWindow,[in] DWORD BehaviorFlags,[in, out] D3DPRESENT_PARAMETERS *pPresentationParameters,[out, retval] IDirect3DDevice9 **ppReturnedDeviceInterface
);
接下来按顺序分别讲解每个成员的具体含义和使用方法。
- UINT 类型的Adapter,表示将创建的IDirect3D Device9 接口对象所代表的显卡序号,通常我们使用D3DADAPTER DEFAULT,或者取α 表示默认的显卡,因为在d3d9.h头文件中定义了这个宏:
- 1. #define D3DADAPTER_DEFAULT 0
- D3DDEVTYPE 类型的DeviceType ,指定Direct3D 的设备类型,前面第二步中讲到过,我们可以在D3DDEVTYPE 枚举类型中取值,我们一般取D3DDEVTYPE_HAL,表示硬件设备类型。
- HWND 类型的hFocusWindow , 一个窗口句柄,指定当Direct3D 程序从前台交换到后台时的提示窗口。在全屏模式运行时,这个窗口必须是最上层显示的窗口,当窗口模式运行时,这个成员可为NULL。为了达到正确的显示效果,我们一般把这个窗口设为和Direct3D 初始化四步曲的第二步里面D3DPRESENT_PARAMETERS 结构体唯一的窗口句柄成员hDeviceWindow 一致。
- DWORD 类型的BehaviorFlags , 表示设备行为标识,我们只要知道这个参数可以取D3DCREATE_HARDWARE_VERTEXPROCESSING (硬件顶点运算)或者
- D3DCREATE_SOFTWARE_ VERTEXPROCESSING (软件顶点运算)就可以了。
- D3DPRESENT_PARAMETERS 类型的*pPresentationParameters , 在这里填一个已经完成初始化的
- D3DPRESENT_PARMMETERS 类型的结构体,不用多介绍了吧,第二步填充的结构体就是在现在使用的。
- IDirect3DDevice9 类型的*ppRetumedDev icelnterface, 即指定我们创建的Direct3D 设备接口的指针, 可以这样说,调用CreateDevice 函数,就是为了得到这个Direct3D设备接口的指针,以完成之后的绘制过程。
if(FAILED(pD3D->CreateDevice(D3DADAPTER_DEFAULT, D3DDEVTYPE_HAL, hwnd, vp, &d3dpp, &g_pd3dDevice)))return E_FAIL;
在这里我们进行了错误处理,用返回值来判断函数是否调用成功了。因为CreateDevice 方法返回一个HRESULT 类型的返回值,我们可以通过SUCCESSED 和FAIL 宏来判断这个函数的执行结果。
11.4.6 Direct3D 初始化四步曲代码赏析
然后我们贴出Direct3D 初始化四步曲的全部代码,也就是Direct3D_lnit()函数的实现。大家只要理解并消化了下面这段代码了,就能拍拍胸脯对自己说, 我已经掌握Direct3D 初始化的方法了。
//-----------------------------------【Direct3D_Init( )函数】--------------------------------------
// 描述:Direct3D初始化函数,进行Direct3D的初始化
//------------------------------------------------------------------------------------------------
HRESULT Direct3D_Init(HWND hwnd)
{//--------------------------------------------------------------------------------------// 【Direct3D初始化四步曲之一,创接口】:创建Direct3D接口对象, 以便用该Direct3D对象创建Direct3D设备对象//--------------------------------------------------------------------------------------LPDIRECT3D9 pD3D = NULL; //Direct3D接口对象的创建if( NULL == ( pD3D = Direct3DCreate9( D3D_SDK_VERSION ) ) ) //初始化Direct3D接口对象,并进行DirectX版本协商return E_FAIL;//--------------------------------------------------------------------------------------// 【Direct3D初始化四步曲之二,取信息】:获取硬件设备信息//--------------------------------------------------------------------------------------D3DCAPS9 caps; int vp = 0;if( FAILED( pD3D->GetDeviceCaps( D3DADAPTER_DEFAULT, D3DDEVTYPE_HAL, &caps ) ) ){return E_FAIL;}if( caps.DevCaps & D3DDEVCAPS_HWTRANSFORMANDLIGHT )vp = D3DCREATE_HARDWARE_VERTEXPROCESSING; //支持硬件顶点运算,我们就采用硬件顶点运算,妥妥的elsevp = D3DCREATE_SOFTWARE_VERTEXPROCESSING; //不支持硬件顶点运算,无奈只好采用软件顶点运算//--------------------------------------------------------------------------------------// 【Direct3D初始化四步曲之三,填内容】:填充D3DPRESENT_PARAMETERS结构体//--------------------------------------------------------------------------------------D3DPRESENT_PARAMETERS d3dpp; ZeroMemory(&d3dpp, sizeof(d3dpp));d3dpp.BackBufferWidth = WINDOW_WIDTH;d3dpp.BackBufferHeight = WINDOW_HEIGHT;d3dpp.BackBufferFormat = D3DFMT_A8R8G8B8;d3dpp.BackBufferCount = 1;d3dpp.MultiSampleType = D3DMULTISAMPLE_NONE;d3dpp.MultiSampleQuality = 0;d3dpp.SwapEffect = D3DSWAPEFFECT_DISCARD; d3dpp.hDeviceWindow = hwnd;d3dpp.Windowed = true;d3dpp.EnableAutoDepthStencil = true; d3dpp.AutoDepthStencilFormat = D3DFMT_D24S8;d3dpp.Flags = 0;d3dpp.FullScreen_RefreshRateInHz = 0;d3dpp.PresentationInterval = D3DPRESENT_INTERVAL_IMMEDIATE;//--------------------------------------------------------------------------------------// 【Direct3D初始化四步曲之四,创设备】:创建Direct3D设备接口//--------------------------------------------------------------------------------------if(FAILED(pD3D->CreateDevice(D3DADAPTER_DEFAULT, D3DDEVTYPE_HAL, hwnd, vp, &d3dpp, &g_pd3dDevice)))return E_FAIL;SAFE_RELEASE(pD3D) //LPDIRECT3D9接口对象的使命完成,我们将其释放掉if(!(S_OK==Objects_Init(hwnd))) return E_FAIL; //调用一次Objects_Init,进行渲染资源的初始化return S_OK;
}
11.4.7 示例程序D3Ddemo1
//-----------------------------------【库文件包含部分】---------------------------------------
// 描述:包含程序所依赖的库文件
//------------------------------------------------------------------------------------------------
#pragma comment(lib,"winmm.lib") //调用PlaySound函数所需库文件
#pragma comment(lib,"d3d9.lib")
#pragma comment(lib,"d3dx9.lib")
其中,为了演示的方便,我们把Direct3D 的初始化放在了显示和更新窗口之后,井且采用if·· ·else 语句配合MessageBox 函数, Direct3D 调用成功或者失败,都会弹出相应的消息,下面就是这段内容的实现代码:
//Direct3D资源的初始化,成功或者失败都用messagebox予以显示if (S_OK==Direct3D_Init (hwnd)){MessageBox(hwnd, L"Direct3D初始化完成~!", L"浅墨的消息窗口", 0); //使用MessageBox函数,创建一个消息窗口 }else{MessageBox(hwnd, L"Direct3D初始化失败~!", L"浅墨的消息窗口", 0); //使用MessageBox函数,创建一个消息窗口 }
其余的代码就基本上和我们上文中已经详细贴出的DirectX 程序框架D3DdemoCore 的源代码相同,这里就不浪费篇幅重复贴出了。
这个示例程序的运行截图如下:
![](/assets/blank.gif)
11.5 深入理解Direct3D 动画显示技术——交换链
Direct3D 中,使用了一种称作交换链( Pape Flipping )的技术, 来让画面能够平滑的过渡。交换链由两个或者两个以上的表面组成, 而每个表面都是存储着2D 图形的一个线性数组, 其中每个元素都表示着屏幕上的一个像素。
上面讲到的只是2D 图形, 而对于三维物体呢,我们还需要一个称作深度的信息, Direct3D 使用深度缓冲区为最终绘制的图像的每个像素都存储一个深度信息,深度缓冲区只包含特定像素的深度信息,而不包含图像数据的表面信息(表面信息上面讲过, 由表面信息来存储,就是一个存储着2D 图形的线性数组〉。
下面我们通过一幅图来看看这神奇的交换链翻转操作到底是怎样完成的。
![](/assets/blank.gif)
在Direct3D 中创建的每一个渲染设备至少要有一个交换链,在我们的Direct3D 初始化四步曲中的第三步里面,我们填充了
D3DPRESENT_PARAMETERS d3dpp;
d3dpp.BackBufferCount = 2;
需要注意的是,上面这两句只是告诉了Direct3D 相关的信息, 没有真正的去创建, 而交换链正式的创建, 是在四步曲的第四步里面,调用IDirect3D9::CreateDevice() 方法的时候。IDirect3 D9: : Create Device()方法完成了Direct3D 设备对象和相应交换链的创建。
创建完成后,我们自然需要“驱动” 交换链进行翻转操作,而交换链的翻转操作就是本节主要讲解的Direct3D 渲染五步曲里的最后一步“翻转显示”之中,也就是调用IDirect3DDevice9:: Present()函数,进行页面的翻转和显示。接下来会讲解这个函数的具体用法,这里我们知道它用于页面翻转操作的就够了。
交换链技术利用这样的指针交换操作, 实现了高效而流畅的动画绘制。
11.6 对固定功能渲染流水线体系的理解
空间中的物体需要使用三维坐标来描述,而我们的显示器显示的是二维的,所以在屏幕上渲染一个三维场景时,首先需要将物体描述空间物体的三维坐标变换为二维坐标(也就是世界坐标到屏幕坐标〉,这在Direct3D 中称为顶点坐标变换。顶点坐标变换通常通过矩阵来完成。我们之前的几个demo 中,演示的是如何显示一个二维的平面图形,它的顶点是以屏幕坐标系的二维值表示的,也是经过顶点坐标变换之后的顶点坐标数据,可以把顶点坐标变换想象成摄像的过程, 三维世界的景物通过摄像机拍摄显示在二维的相片之上,有所不同的是把相片换成了屏幕。
在固定功能渲染流水线这套体系中,大体分为两个阶段,第一阶段我们将它称为坐标变换和光照处理阶段( Transforming &Lighting ,简称T&L 阶段) 。在这个阶段中,每个对象的顶点从一个抽象的、浮点坐标变换到基于像素的屏幕空间当中。这里需要注意是,坐标变换不仅包含物体顶点位置,它还可能包括顶点的法线、纹理坐标等等。并根据场景中光源和物体表面的材质对物体顶点应用不同类型的光照效果。还有其他一些比较重要的任务,比如视口的设置和裁剪也是在第一阶段进行的。
![](/assets/blank.gif)
矩阵、视口以及所使用的光线来建立T&L 流水线的,然后应用程序将顶点送入流水线,并对这些顶点在流水线中进行坐标变换、照明以及裁剪,将其投影到屏幕空间当中,并根据视口的规定对其进行缩放。顶点在T&L 流水线中进过“涅架”之后,就到了
关于变换和光照渲染流水线阶段,也就是丁&L 阶段,也配了一幅图,方便大家的记忆与理解,如下图所示。
![](/assets/blank.gif)
11. 7 Direct3D 中的“绘制金钥匙”——Direct3D 设备接口
看完这本书的前面小半部分GDI 游戏编程的朋友们应该都知道。在GDI 编程中,有一把金钥匙叫hdc ,也就是传说中的设备描述表的句柄,不过我们在编程中因为命名规范的关系,把它写成了g hdc , 表示他是一个全局变量。我们要在屏幕上采用GDI 绘制图形,都是在与hdc 这个家伙打交道。我们进行各种透明处理, 弄什么双缓冲甚至多缓冲的最终目的,都是想要把流畅的动画绘制到hdc 之中。在GDI 游戏实现代码中,大家肯定对这个句子非常的熟悉:
hdc = GetDC (hwnd) ;
就是这个语句让我们用CreateWindow 创建出来的窗口句柄hwnd 与hdc 有了剪不断理还乱的联系。就是它,成就了hdc 这把GDI 中绘制的金钥匙。
我们再来看看Direct3D 这边。
D3DPRESENT_PARAMETERS d3dpp;
d3dpp.hDeviceWindow = hwnd;
然后在初始化Direct3D 的第四步是创设备填内容中,我们这样写:
pD3D->CreateDevice(D3DADAPTER_DEFAULT, D3DDEVTYPE_HAL, hwnd, vp, &d3dpp, &g_pd3dDevice);
CreateDevice 函数的倒数第二个参数,我们指定的就是D3DPRESENT_PARAMETERS 的实例d3dpp 。最后一个参数, IDirect3DDevice9 类型的**ppReturnedDevicelnterface 就是我们指向Direct3D设备接口的句柄。
举个具体例子,在这一节稍后的示例程序demo 之中, g_pd3dDevice 就是这个绘制金钥匙,后面的绘制操作就是通过它来完成的,比如拿起g_pd3dDevice 指一下Present ,也就是渲染五步曲的最终步骤:
g_pd3dDevice- >Present(NULL, NULL , NULL, NULL); //翻转与显示
这个函数将在后面重点讲解,这里只是提一下。
所以如果我们想要在Direct3D 中进行绘制,拿起Direct3D 中的金钥匙——“ Direct3D 设备”,用箭头“→”调用一下相应的方法就了。
11.8 Direct3D 中二维文本的绘制
11.8.1 D3DXCreateFont 函数
HRESULT D3DXCreateFont(__in LPDIRECT3DDEVICE9 pDevice,__in INT Height,__in UINT Width,__in UINT Weight,__in UINT MipLevels,__in BOOL Italic,__in DWORD CharSet,__in DWORD OutputPrecision,__in DWORD Quality,__in DWORD PitchAndFamily,__in LPCTSTR pFacename,__out LPD3DXFONT *ppFont
);
然后依次是每个变量的介绍:
- 第一个参数, LPDIRECT3DDEVICE9 类型的pDevice ,也就是我们的Direct3D 绘制金钥匙——Direct3D 设备的指针。
- 第二个参数, INT 类型的Height,表示字体的高度。
- 第三个参数, UINT 类型的Width , 表示字体的宽度。
- 第四个参数, UINT 类型的Weight,表示字体的权重值。
- 第五个参数, UINT 类型的MipLevels,表示字体的过滤属性。
- 第六个参数, BOOL 类型的Italic,表示是否为斜体, TRUE 表示是斜体, FLASE 表示不是斜体。
- 第七个参数, DWORD 类型的CharSet , 表示字体所使用的字符集, 通常我们设为默认值DEFAULT CHARS ET , 表示使用默认字符集。
- 第八个参数, DWORD 类型的OutputPrecision,表示输出文本的精度,通常设为默认值OUT_DEFAULT_PREClS。
- 第九个参数, DWORD 类型的Quality ,表示指定字符的输出质量, 通常也设为DEFAULT_QUALITY。
- 第十个参数, DWORD 类型的PitchAndFamily ,用于指定字体的索引号, 通常都设为0 。
- 第十一个参数, LPCTSTR 类型的pFacename , 指定我们想要创建的字体名称,比如“微软雅黑”等等
- 第十二个参数, LPD3DXFONT 类型的*ppFont , 用于存储我们新储存的字体指针。它也是一把钥匙,我们要进行字体绘制相关的操作,全都靠它了。
11.8.2 DrawText 函数
下面看一下这个函数的原型:
INT DrawText([in] LPD3DXSPRITE pSprite,[in] LPCTSTR pString,[in] INT Count,[in] LPRECT pRect,[in] DWORD Format,[in] D3DCOLOR Color
);
- 第一个参数, LPD3DXSPRITE 类型的pSprite ,指定字符串所属的ID3DXSprite 对象接口,我们可以把它设为0 , 表示在当前窗口绘制字符串。
- 第二个参数, LPCTSTR 类型的pString, 指定我们将要绘制的字符串内容。
- 第三个参数, INT 类型的Count ,指定绘制字符的个数,如果取- 1 的话,就表示函数会自动绘制到字符串结束为止。
- 第四个参数, LPRECT 类型的pRect , 表示用于绘制字符串的矩形区域位置。
- 第五个参数, DWORD 类型的Format , 指定字符串在上面设置的这个参数, pRect 矩形区域中的摆放属性。比较常用的属性打在了下面这张表上面了,他们之间用“|” 符号联合起来使用,比如DT_ CENTER I OT_ VCENTER 。
- 第六个参数, D3DCOLOR 类型的Color , 显而易见,它是用于指定我们字符串显示的颜色值的,属于我们之前讲过的D3DCOLOR 结构体, 可以随意从中挑选并设置。
所以,概括地来说,在Direct3D 应用程序中输出文字就两步:
- 调用D3DXCreateFont 创建字体。
- 拿起创建的字体,调用ID3DXFont: :DrawText 进行文本的绘制。
当然,在Direct3D 中绘制2D 文本的方式并不只这一种,但是这种方式用起来最舒服。
11.9 起承转合的艺术: Direct3D 渲染五步曲
11.9.1 Direct30 渲染五步曲概述
//【5】消息循环过程MSG msg = { 0 }; //初始化msgwhile( msg.message != WM_QUIT ) //使用while循环{if( PeekMessage( &msg, 0, 0, 0, PM_REMOVE ) ) //查看应用程序消息队列,有消息时将队列中的消息派发出去。{TranslateMessage( &msg ); //将虚拟键消息转换为字符消息DispatchMessage( &msg ); //该函数分发一个消息给窗口程序。}else{Direct3D_Render(hwnd); //进行渲染}}
这表示我们时时刻刻地在调用Direct3D_Render() 函数,每秒钟调用成千上万次都是可能的。所以为了写出执行效率高的游戏程序,我们一定要保证Direct3D_Render() 函数代码的干净整洁。
下面我们就来看看, Direct3D_Render()函数需要的渲染五步曲, 是哪五步:
- 渲染五步曲之一:清屏操作。
- 渲染五步曲之二:开始场景。
- 渲染五步曲之三:正式绘制。
- 渲染五步曲之四; 结束场景。
- 渲染五步曲之五:翻转显示。
接下来我们对着五步曲进行各个击破,分别进行细讲。首先来看下第一步。
11.9.2 五步曲之一:清屏操作
我们可以在DirectX SDK 中查到。Direct3D 渲染五步曲的第一步中的主角IDirect3DDevice9: :Clear 的原型声明是这样的:
HRESULT Clear([in] DWORD Count,[in] const D3DRECT *pRects,[in] DWORD Flags,[in] D3DCOLOR Color,[in] float Z,[in] DWORD Stencil
);
下面我们对各个成员分别进行讲解。
- 第一个参数, DWORD 类型的Count ,指定了接下来的一个参数pRect 指向的矩形数组中矩形的数量。我们可以这样说, Count 和pRects 是一对好基友。如果pRects 我们将其设为NULL的话, 这参数必须设为0 。而如果pRects 为有效的矩形数组的指针的话,这个Count 必须就为一个非零值了。
- 第二个参数, const D3DRECT 类型的*pRects ,指向一个D3DRECT 结构体的数组指针,表明我们需要清空的目标矩形区域。
- 第三个参数, DWORD 类型的Flags ,指定我们需要清空的缓冲区。它为D3DCLEAR_STENCIL 、D3DCLEAR_TARGET 、D3DCLEAR_ZBUFFER 的任意组合,分别表示模板缓冲区、颜色缓冲区、深度缓冲区,用“| ” 连接。
- 第四个参数, D3DCOLOR 类型的Color,用于指定我们在清空颜色缓冲区之后每个像素对应的颜色值,这里的颜色用D3DCOLOR 宏表示,即这样写D3DCOLOR_XRGB(R, G, B),其中的RGB 为我们设定的红绿蓝三原色的值, 都在0 到255 之间取值,比如D3DCOLOR_XRGB(123 , 76, 228);
D3DCOLOR_RGBA(r,g,b,a)宏,D3DXCOLORVALUE结构体、D3DXCOLOR 结构体来定义颜色值。
- · 第五个参数, float 类型的Z ,用于指定清空深度缓冲区后每个像素对应的深度值。
- · 第六个参数, DWORD 类型的Stencil , 用于指定清空模板缓冲区之后模板缓冲区中每个像素对应的模板值。
所以, 渲染五步曲的第一步就是用一下这个Clear 方法:
//其中g_pd3dDevice 表示我们创建的有效的Direct3D 绘制”金钥匙”—Direct3D 设备对象
g_pd3dDevice- >Clear (0 , NULL , D3DCLEAR_TARGET , D3DCOLOR _ XRGB (0, 0, 0), 1.0f, 0);
11.9.3 五步曲之二:开始绘制
//其中g_pd3dDevice 表示我们创建的有效的Direct3D 绘制”金钥匙”一Direct3D 设备对象
g_pd3dDevice->BeginScene();
其中IDirect3DDevice9: :BeginScene()没有参数,如果调用成功,返回值就为HRESULT 。需要重点注意的是,
11.9.4 五步曲之三:正式绘制
//--------------------------------------------------------------------------------------// 【Direct3D渲染五步曲之三】:正式绘制,在这里我们写了四段文字//--------------------------------------------------------------------------------------//在窗口右上角处,显示每秒帧数int charCount = swprintf_s(g_strFPS, 20, _T("FPS:%0.3f"), Get_FPS() );g_pFont->DrawText(NULL, g_strFPS, charCount , &formatRect, DT_TOP | DT_RIGHT, D3DCOLOR_XRGB(255,39,136));//在纵坐标100处,写第一段文字formatRect.top = 100;//指定文字的纵坐标g_pFont->DrawText(0, _T("【致我们永不熄灭的游戏开发梦想】"), -1, &formatRect, DT_CENTER, D3DCOLOR_XRGB(68,139,256));//在纵坐标250处,写第二段文字formatRect.top = 250;g_pFont->DrawText(0, _T("游戏开发的世界,我们来降服你了~!"), -1, &formatRect, DT_CENTER, D3DCOLOR_XRGB(255,255,255));//在纵坐标400处,写第三段文字formatRect.top = 400;g_pFont->DrawText(0, _T("闪闪惹人爱"), -1, &formatRect, DT_CENTER, D3DCOLOR_XRGB(rand() % 256, rand() % 256, rand() % 256));//采用随机RGB值,做出“闪闪惹人爱”的特效
11.9.5 五步曲之四:结束绘制
写完需要绘制内容的相关代码, 接下来这一步是非常非常简单,就是调用一下“ Direct3 D 绘制双人组”之一的EndScene()方法。向Direct3D 表示,我们的绘制完成了。所以这一步也就是这样写:
//其中g_pd3dDevice表示我们创建的有效的Direct3D 绘制”金钥匙”一Direct3D 设备对象g_pd3dDevice->EndScene () ; // 结束绘制
11.9.6 五步曲之五:翻转显示
HRESULT Present([in] const RECT *pSourceRect,[in] const RECT *pDestRect,[in] HWND hDestWindowOverride,[in] const RGNDATA *pDirtyRegion
);
接着我们看一下这个主持着交换链的Present 方法的具体参数构成:
第一个参数, const RECT 类型的*pSourceRect , 表示指向复制源矩形区域的指针。显然一般我们都将其设为NULL。
第二个参数, const RECT 类型的*pDestRect , 表示指向复制目标矩形区域的指针。显然一般我们也将其设为NULL。
第三个参数, HWND 类型的hDestWindowOverride , 表示指向当前绘制的窗口句柄。如果我们设为0 或NULL 就表示取我们之前初始化四步曲里面第三步填充的D3DPRESENT_PARAMETERS 结构体中的hDeviceWindows 的值。显然一般我们依然将其设NULL
第四个参数, const RGNDATA 类型的*pDirtyRegion , 表示指向最小更新区域的指针。显然一般我们依然将其设为NULL 。
g_pd3dDevice->Present(NULL, NULL, NULL, NULL); // 翻转与显示
11.9.7 Direct3D 渲染五步曲代码整体赏析
具体实现代码也非常简单(先忽略掉正式绘制实现代码),有点起承转合的味道,但基本上千篇一律,也就是:
g_pd3dDevice->Clear(O , NULL , D3DCLEAR_TARGET , D3DCOLOR XRGB(O , 0, 0) , l.Of, 0); // 五步曲之一,清屏操作
g_pd3dDevice->BeginScene (); // 五步曲之二, 开始绘制/*五步曲之三,正式绘制;一千个人眼中有一千个哈姆雷特,在这里按喜好填入相关代码,进行正式绘制操作*/
g_pd3dDevice->EndScene (); // 五步曲之四,结束绘制
g_pd3dDevice- >Present (NULL, NULL , NULL, NULL) ; // 五步曲之五, 翻转与显示
在后面我们学习熟练了就会发现,很多时候, 一、二、四、五这四步的代码基本上不用变,因为它们其实就是Direct3D 中绘制过程约定俗成的套路,我们只是简单地遵守这个套路,要得出不同的绘制图形,可以把第三步正式绘制的代码改改就好了。
11.9.8 示例程序D3Ddemo2
看到FPS ,大家可能就激动了,这里的FPS 可不是游戏里的第一人称射击类游戏FPS( First-Person Shooter Game ) ,如穿越火线CF 、反恐精英cs 、使命召唤Call of the Duty 等等游戏的简称,而是Frame Per Second ,每秒帧速率。
为了之后我们的Direct3D 程序能更清晰地在运行时实时看到帧率, 来评估我们的程序的绘制效率,这里我们来手动写一个测帧率的函数Get_FPS()函数。为了达到显示帧速率的效果,在D3Ddemol 的基础上, 主要有三处地方需要添加实现代码。
首先我们定义两个全局变量:
float g_FPS = 0.0f; //一个浮点型的变量,代表帧速率
wchar_t g_strFPS[50]; //包含帧速率的字符数组
( 2) Get_ FPS ()函数的具体实现
我们先看一下实现的代码:
//-----------------------------------【Get_FPS( )函数】------------------------------------------
// 描述:用于计算每秒帧速率的一个函数
//--------------------------------------------------------------------------------------------------
float Get_FPS()
{//定义四个静态变量static float fps = 0; //我们需要计算的FPS值static int frameCount = 0;//帧数static float currentTime =0.0f;//当前时间static float lastTime = 0.0f;//持续时间frameCount++;//每调用一次Get_FPS()函数,帧数自增1currentTime = timeGetTime()*0.001f;//获取系统时间,其中timeGetTime函数返回的是以毫秒为单位的系统时间,所以需要乘以0.001,得到单位为秒的时间//如果当前时间减去持续时间大于了1秒钟,就进行一次FPS的计算和持续时间的更新,并将帧数值清零if(currentTime - lastTime > 1.0f) //将时间控制在1秒钟{fps = (float)frameCount /(currentTime - lastTime);//计算这1秒钟的FPS值lastTime = currentTime; //将当前时间currentTime赋给持续时间lastTime,作为下一秒的基准时间frameCount = 0;//将本次帧数frameCount值清零}return fps;
}
静态变量的性质复习。静态全局变量在声明它的整个文件都是可见的,而在文件之外是不可见的。静态变量都在全局数据区分配内存。
//在窗口右上角处,显示每秒帧数
int charCount = swprintf_s(g_strFPS, 20, _T("FPS:%0.3f"), Get_FPS() );
g_pFont->DrawText(NULL, g_strFPS, charCount , &formatRect, DT_TOP | DT_RIGHT, D3DCOLOR_XRGB(255,39,136));
其中swprintf_s 函数的第二个参数中的0.3 表示保留3 位有效数字。
这样在Direct3D_ Render()函数每秒钟成千上万次地被调用的过程中,也就让Get_FPS()被成千上万次调用,也让这段显示FPS 的文字也成千上万次被调用了。
2 例程的新增代码分析
这次的渲染五步曲例程代码中,我们首先是新包含了2 个头文件:
#include <d3dx9.h>
#include <tchar.h>
这里的d3dx9.h 表示D3DX 库的头文件。这个D3DX 库提供了一些函数、类和接口,极大地简化了3 D 图形相关的运行,例如数学运算、纹理和图像运算、网格运算等等。以D3DX 开头的众多函数都是来自这个D3DX 库,比如我们这里要用到的字体创建函数D3DXCreateFont ,比如以后我们读取并创建纹理时经常用到的D3DXCreateTextureFile 。
然后tchar.h 大家应该就很熟悉了,调用swprintf_s 函数所需的头文件。
#pragma comment(lib,"d3dx9.lib")
然后就是核心代码的书写了:
//-----------------------------------【全局变量声明部分】-------------------------------------
// 描述:全局变量的声明
//------------------------------------------------------------------------------------------------
LPDIRECT3DDEVICE9 g_pd3dDevice = NULL; //Direct3D设备对象
ID3DXFont* g_pFont=NULL; //字体COM接口
float g_FPS = 0.0f; //一个浮点型的变量,代表帧速率
wchar_t g_strFPS[50]; //包含帧速率的字符数组//-----------------------------------【Object_Init( )函数】--------------------------------------
// 描述:渲染资源初始化函数,在此函数中进行要被渲染的物体的资源的初始化
//--------------------------------------------------------------------------------------------------
HRESULT Objects_Init(HWND hwnd)
{//创建字体if(FAILED(D3DXCreateFont(g_pd3dDevice, 36, 0, 0, 1, false, DEFAULT_CHARSET, OUT_DEFAULT_PRECIS, DEFAULT_QUALITY, 0, _T("微软雅黑"), &g_pFont)))return E_FAIL;srand(timeGetTime()); //用系统时间初始化随机种子 return S_OK;
}//-----------------------------------【Direct3D_Render( )函数】-------------------------------
// 描述:使用Direct3D进行渲染
//--------------------------------------------------------------------------------------------------
void Direct3D_Render(HWND hwnd)
{//--------------------------------------------------------------------------------------// 【Direct3D渲染五步曲之一】:清屏操作//--------------------------------------------------------------------------------------g_pd3dDevice->Clear(0, NULL, D3DCLEAR_TARGET, D3DCOLOR_XRGB(0, 0, 0), 1.0f, 0);//定义一个矩形,用于获取主窗口矩形RECT formatRect;GetClientRect(hwnd, &formatRect);//--------------------------------------------------------------------------------------// 【Direct3D渲染五步曲之二】:开始绘制//--------------------------------------------------------------------------------------g_pd3dDevice->BeginScene(); // 开始绘制//--------------------------------------------------------------------------------------// 【Direct3D渲染五步曲之三】:正式绘制,在这里我们写了四段文字//--------------------------------------------------------------------------------------//在窗口右上角处,显示每秒帧数int charCount = swprintf_s(g_strFPS, 20, _T("FPS:%0.3f"), Get_FPS() );g_pFont->DrawText(NULL, g_strFPS, charCount , &formatRect, DT_TOP | DT_RIGHT, D3DCOLOR_XRGB(255,39,136));//在纵坐标100处,写第一段文字formatRect.top = 100;//指定文字的纵坐标g_pFont->DrawText(0, _T("【致我们永不熄灭的游戏开发梦想】"), -1, &formatRect, DT_CENTER, D3DCOLOR_XRGB(68,139,256));//在纵坐标250处,写第二段文字formatRect.top = 250;g_pFont->DrawText(0, _T("游戏开发的世界,我们来降服你了~!"), -1, &formatRect, DT_CENTER, D3DCOLOR_XRGB(255,255,255));//在纵坐标400处,写第三段文字formatRect.top = 400;g_pFont->DrawText(0, _T("闪闪惹人爱"), -1, &formatRect, DT_CENTER, D3DCOLOR_XRGB(rand() % 256, rand() % 256, rand() % 256));//采用随机RGB值,做出“闪闪惹人爱”的特效//--------------------------------------------------------------------------------------// 【Direct3D渲染五步曲之四】:结束绘制//--------------------------------------------------------------------------------------g_pd3dDevice->EndScene(); // 结束绘制//--------------------------------------------------------------------------------------// 【Direct3D渲染五步曲之五】:显示翻转//--------------------------------------------------------------------------------------g_pd3dDevice->Present(NULL, NULL, NULL, NULL); // 翻转与显示
}//-----------------------------------【Get_FPS( )函数】------------------------------------------
// 描述:用于计算每秒帧速率的一个函数
//--------------------------------------------------------------------------------------------------
float Get_FPS()
{//定义四个静态变量static float fps = 0; //我们需要计算的FPS值static int frameCount = 0;//帧数static float currentTime =0.0f;//当前时间static float lastTime = 0.0f;//持续时间frameCount++;//每调用一次Get_FPS()函数,帧数自增1currentTime = timeGetTime()*0.001f;//获取系统时间,其中timeGetTime函数返回的是以毫秒为单位的系统时间,所以需要乘以0.001,得到单位为秒的时间//如果当前时间减去持续时间大于了1秒钟,就进行一次FPS的计算和持续时间的更新,并将帧数值清零if(currentTime - lastTime > 1.0f) //将时间控制在1秒钟{fps = (float)frameCount /(currentTime - lastTime);//计算这1秒钟的FPS值lastTime = currentTime; //将当前时间currentTime赋给持续时间lastTime,作为下一秒的基准时间frameCount = 0;//将本次帧数frameCount值清零}return fps;
}//-----------------------------------【Direct3D_CleanUp( )函数】--------------------------------
// 描述:资源清理函数,在此函数中进行程序退出前资源的清理工作
//---------------------------------------------------------------------------------------------------
void Direct3D_CleanUp()
{//释放COM接口对象SAFE_RELEASE(g_pFont)SAFE_RELEASE(g_pd3dDevice)
}
我们在Objects_lnit 函数中初始化了字体,并用系统时间初始化随机种子。在Direct3D_ Render()函数中进行了渲染五步曲代码的书写,且最关键的第三步我们用一系列的DrawText,在屏幕中绘制了几段文字以及在右上角绘制出了帧数FPS 的值。最后我们在Direct3D_ Clean Up 方法中, 用我们自定义的SAFE_RELEASE 方法释放了g_pFont 和g_pd3dDevice这两个COM 接口。
另外,大家也许会纳闷_T(”【致我们永不熄灭的游戏开发梦想】”)这句中_T(””)的用法,这里我们也来做一下解释。
我们通过对_T 进行【转到定义F12) 】,可以发现tchar.h 中有如下的宏定义。
#define _T(x) __T(x)
#define _TEXT(x) __T(x)
即_T(x)、__T(x)、___T(x)这三者等价(注意下划线的长度)。而这三种_T 宏可以把一个引号引起来的字符串根据我们的编译环境设置的字符集方式(Unicode 还是ANSI) ,智能进行选择。
比如我们工程的字符集使用的是Unicode ,那么T 宏会智能地把字符串前面加一个L。
而如果我们工程的字符集使用的是多字节字符集的话,那么T 宏便不会在字符串前面加那个L ,
我们在写字符串常量时加上这个宏,工程可以方便地在Unicode 字符集和多字节字符集之间进行转换。
最后看一下程序的运行截图:
![](/assets/blank.gif)
11.10 章节小憩
第11章 三维内功心法——Direct3D编程基础相关推荐
- c语言编程基础课件,第7章_C语言图形编程基础课件
第7章_C语言图形编程基础课件 狭义的组织变革是指组织根据外部环境的变化和内部情况的变化及时地改变自己的内在组织结构,以适应客观发展的需要. 狭义的组织变革是指组织根据外部环境的变化和内部情况的变化及 ...
- 《Python核心编程》第11章 函数和函数式编程 练习
11-3 函数. 在这个练习中,我们将实现max()和min()内建函数. (a) 写分别带两个元素返回一个较大和较小元素,简单的max2()核min2()函数.他们应该可以用任意的python 对象 ...
- 软考-软件设计师 - 第11章 标准化和软件知识产权基础知识【附补充常考知识点】
11.1 标准化基础知识 11.1.1 基本概念 1.标准分类: 1)根据适用范围分类: (1)国际标准 (2)国家标准 (3)区域标准 (4)行业标准 (5)企业标准 (6)项目规范 2)根据标准的 ...
- python第四章单元测试_MOOC选修课答案第四章单元测试答案_Sar编程基础期末答案...
在RLC串联电路中,已知R=100Ω,L=25mH,C=8μF,端电压为,求:电路中的总阻抗Z,电流,各元件上的电压,并画出电流和各电压的相量图.51acff1e9e93fa13124fd75b1b5 ...
- python编程基础与应用-Python程序设计基础与应用
图书简介 配套资源:部分全彩印刷.电子课件.教学大纲.习题答案.源代码 本书特色: ★知名Python教育者董付国老师新作. ★言简意赅,案例丰富,配套资源超全部分内容全彩呈现. ★本书全部代码适用于 ...
- c#创建画布_C#GDI+编程基础(一:Graphics画布类)
GDI+存在的意义:将变成与具体硬件实现细节分开. GDI+步骤:获取画布,绘制图像.处理图像 命名空间: using System.Drawing;//提供对GDI+基本图形功能的访问 using ...
- c语言从键盘输入千米数,第二章 C语言编程基础.ppt
第二章 C语言编程基础 习题2 P51-7.8.13.14.16 2.4.8break 语句和continue语句 [例2.19] 输出100 - 200 之间不能被3整除的数. P44 2.4.9循 ...
- 16第一章 ASP.Net编程基础知识
第一章 ASP.Net编程基础知识 第一章 ASP.Net编程基础知识 本章首先介绍用ASP.Net技术编制服务器端动态网页所需的网络和HTML标记语言方面的有关知识.然后 ...
- 《Python编程快速上手——让繁琐工作自动化》——第一部分 Python编程基础 第1章 Python基础 1.1 在交互式环境中输入表达式...
本节书摘来自异步社区<Python编程快速上手--让繁琐工作自动化>一书中的第1章,第1.1节,作者[美] Al Sweigart,王海鹏 译,更多章节内容可以访问云栖社区"异步 ...
最新文章
- 使用阿里云的maven私服的setting.xml, 提高maven项目jar下载速度
- getpeername()函数
- android5.0(Lollipop) BLE Peripheral牛刀小试
- 金融贷款逾期的模型构建6——特征选择
- 对抗样本与生成式对抗网络
- xml方式实现aop-通知的种类
- shiro 认证思路
- 前端 ---jQuery的补充
- centos 释放swap_centos6.6关闭与打开swap(整理)
- ESP8266调试-P2P(AP模块与STA模块通信)
- 炸裂!跑P站上教微积分,年入170w...
- # iOS项目——IM聊天工具(集成融云SDK)
- 计算机组成原理学习笔记-加法器
- 计算机里面的wps如何删除,如何快速删除电脑上的wps的所有换行符
- 布丰投针实验 MATLAB仿真 以及报告
- 【实用工具01】免费的比较工具Meld
- 笔记 -- 时间复杂度 log2n
- Kinect安装与使用(一)
- java drawstring 模糊_Java绘制文字质量太低的解决方案?
- DBeaver中的常用快捷键和自定义快捷键方式