DirectX3D游戏开发一 第一个DirectX3D项目

    欢迎访问EasyLiu的博客!此博客为博主原创，未经允许不得转载！

    开发环境：WIN764+VS2013+DirectX SDK(June 2010)

     首先提供DirectX3D软件包下载地址：下载地址。

    下载下来之后直接双击安装就行，默认安装目录为：C:\Program Files (x86)\Microsoft DirectX SDK (June 2010)（不管你的系统是32还是64位）。

    下面就开始我们的第一个DirectX3D项目。

    1、新建一个空的win32应用程序，记住不是win32控制台应用程序，这两者是由区别的！

    2、项目完成以后，配置DirectX开发环境：

    选择“项目”--》“属性”，打开属性配置窗口如下所示：

    

    选择“VC++目录”，把DirectX  SDK 的“包含目录（Include）”以及"库目录（Lib）"包含进去，分别为：

   C:\Program Files (x86)\Microsoft DirectX SDK (June 2010)\Include

    C:\Program Files (x86)\Microsoft DirectX SDK (June 2010)\Lib\x86，虽然我的系统是win764位，但是当我的引用库目录改为x64时候会报错，改为x86就不会报错，不知道      怎么回事！

  点击确定退出属性配置窗口。

  新建文件：main.cpp,在文件开头加上引用库：

  #pragma comment(lib, "d3d9.lib")
  #pragma comment(lib, "d3dx9.lib")

   打开帮助文档：C:\Program Files (x86)\Microsoft DirectX SDK (June 2010)\Documentation\DirectX9\directx_sdk.chm，切换到如下目录：

   

  Toutorial 1就详细讲了怎么创建一个DirectX 3D项目，虽然是英文但是应该不难看，并且Toutorial  1有对应的Sample 工程，位于如下目录：

  C:\Program Files (x86)\Microsoft DirectX SDK (June 2010)\\Samples\C++\Direct3D\Tutorials\Tut01_CreateDevice，这里包含了一个完整的工程，我们只需把其代码复制到  我们的文件main.cpp里面就行了！

 下面是源代码：应该不难看懂，纯粹使用win32 API开发，包括设计窗口、注册窗口、创建窗口等一系列过程，如果对win32开发还不是很懂的朋友可以先看一下孙鑫的VC++深入详解，讲得很详细，通俗易懂！

//-----------------------------------------------------------------------------// File: CreateDevice.cpp//// Desc: This is the first tutorial for using Direct3D. In this tutorial, all//       we are doing is creating a Direct3D device and using it to clear the//       window.//// Copyright (c) Microsoft Corporation. All rights reserved.//-----------------------------------------------------------------------------#pragma comment(lib, "d3d9.lib") //引入依赖库#pragma comment(lib, "d3dx9.lib")#include <d3d9.h>#include "Windows.h"//必须得包含这个文件夹#pragma warning( disable : 4996 ) // disable deprecated warning #include <strsafe.h>#pragma warning( default : 4996 )//-----------------------------------------------------------------------------// Global variables //-----------------------------------------------------------------------------LPDIRECT3D9         g_pD3D = NULL; // Used to create the D3DDevice LPDIRECT3DDEVICE9   g_pd3dDevice = NULL; // Our rendering device//-----------------------------------------------------------------------------// Name: InitD3D()// Desc: Initializes Direct3D//-----------------------------------------------------------------------------HRESULT InitD3D(HWND hWnd){// Create the D3D object, which is needed to create the D3DDevice.if (NULL == (g_pD3D = Direct3DCreate9(D3D_SDK_VERSION)))return E_FAIL;// Set up the structure used to create the D3DDevice. Most parameters are// zeroed out. We set Windowed to TRUE, since we want to do D3D in a// window, and then set the SwapEffect to "discard", which is the most// efficient method of presenting the back buffer to the display.  And // we request a back buffer format that matches the current desktop display // format.D3DPRESENT_PARAMETERS d3dpp;ZeroMemory(&d3dpp, sizeof(d3dpp));d3dpp.Windowed = TRUE;d3dpp.SwapEffect = D3DSWAPEFFECT_DISCARD;d3dpp.BackBufferFormat = D3DFMT_UNKNOWN;// Create the Direct3D device. Here we are using the default adapter (most// systems only have one, unless they have multiple graphics hardware cards// installed) and requesting the HAL (which is saying we want the hardware// device rather than a software one). Software vertex processing is // specified since we know it will work on all cards. On cards that support // hardware vertex processing, though, we would see a big performance gain // by specifying hardware vertex processing.if (FAILED(g_pD3D->CreateDevice(D3DADAPTER_DEFAULT, D3DDEVTYPE_HAL, hWnd,D3DCREATE_SOFTWARE_VERTEXPROCESSING,&d3dpp, &g_pd3dDevice))){return E_FAIL;}// Device state would normally be set herereturn S_OK;}//-----------------------------------------------------------------------------// Name: Cleanup()// Desc: Releases all previously initialized objects//-----------------------------------------------------------------------------VOID Cleanup(){if (g_pd3dDevice != NULL)g_pd3dDevice->Release();if (g_pD3D != NULL)g_pD3D->Release();}//-----------------------------------------------------------------------------// Name: Render()// Desc: Draws the scene//-----------------------------------------------------------------------------VOID Render(){if (NULL == g_pd3dDevice)return;// Clear the backbuffer to a blue colorg_pd3dDevice->Clear(0, NULL, D3DCLEAR_TARGET, D3DCOLOR_XRGB(0, 0, 255), 1.0f, 0);// Begin the sceneif (SUCCEEDED(g_pd3dDevice->BeginScene())){// Rendering of scene objects can happen here// End the sceneg_pd3dDevice->EndScene();}// Present the backbuffer contents to the displayg_pd3dDevice->Present(NULL, NULL, NULL, NULL);}//-----------------------------------------------------------------------------// Name: MsgProc()// Desc: The window's message handler//-----------------------------------------------------------------------------LRESULT WINAPI MsgProc(HWND hWnd, UINT msg, WPARAM wParam, LPARAM lParam){switch (msg){case WM_DESTROY:Cleanup();PostQuitMessage(0);return 0;}return DefWindowProc(hWnd, msg, wParam, lParam);}//-----------------------------------------------------------------------------// Name: wWinMain()// Desc: The application's entry point//-----------------------------------------------------------------------------INT WINAPI wWinMain(HINSTANCE hInst, HINSTANCE, LPWSTR, INT){UNREFERENCED_PARAMETER(hInst);// Register the window classWNDCLASSEX wc ={sizeof(WNDCLASSEX), CS_CLASSDC, MsgProc, 0L, 0L,GetModuleHandle(NULL), NULL, NULL, NULL, NULL,"D3D Tutorial", NULL};RegisterClassEx(&wc);// Create the application's windowHWND hWnd = CreateWindow("D3D Tutorial", "D3D Tutorial 01: CreateDevice",WS_OVERLAPPEDWINDOW, 100, 100, 300, 300,NULL, NULL, wc.hInstance, NULL);// Initialize Direct3Dif (SUCCEEDED(InitD3D(hWnd))){// Show the windowShowWindow(hWnd, SW_SHOWDEFAULT);UpdateWindow(hWnd);// Enter the message loop<span style="white-space:pre"></span>MSG msg;<span style="white-space:pre"></span>ZeroMemory(&msg, sizeof(msg));<span style="white-space:pre"></span>while (msg.message != WM_QUIT)<span style="white-space:pre"></span>{<span style="white-space:pre"></span>if (PeekMessage(&msg, NULL, 0U, 0U, PM_REMOVE))<span style="white-space:pre"></span>{<span style="white-space:pre"></span>TranslateMessage(&msg);<span style="white-space:pre"></span>DispatchMessage(&msg);<span style="white-space:pre"></span>}<span style="white-space:pre"></span>else<span style="white-space:pre"></span>Render();<span style="white-space:pre"></span>}}UnregisterClass("D3D Tutorial", wc.hInstance);return 0;}

运行结果如下所示：

源代码分析

首先是添加头文件：d3d9.h

声明LPDIRECT3D9 和LPDIRECT3DDEVICE9变量：

LPDIRECT3D9         g_pD3D = NULL; // Used to create the D3DDevice 指向接口IDirect3D9的指针LPDIRECT3DDEVICE9   g_pd3dDevice = NULL; // Our rendering device   指向IDirect3DDevice9接口的指针

然后添加InitD3D,Cleanup,Render方法。

InitD3D方法

HRESULT InitD3D(HWND hWnd){// Create the D3D object, which is needed to create the D3DDevice.if (NULL == (g_pD3D = Direct3DCreate9(D3D_SDK_VERSION)))return E_FAIL;//fill D3DCAPS9 struct with the capabilities of the primary display adapterD3DCAPS9 caps;g_pD3D->GetDeviceCaps(D3DADAPTER_DEFAULT, D3DDEVTYPE_HAL, &caps);//can we use hardware vertex processing?DWORD vp = 0;if (caps.DevCaps&D3DDEVCAPS_HWTRANSFORMANDLIGHT){//yes,support hardware vertex processingvp = D3DCREATE_HARDWARE_VERTEXPROCESSING;}else{//no,vp = D3DCREATE_SOFTWARE_VERTEXPROCESSING;}D3DPRESENT_PARAMETERS d3dpp;ZeroMemory(&d3dpp, sizeof(d3dpp));d3dpp.Windowed = TRUE;d3dpp.SwapEffect = D3DSWAPEFFECT_DISCARD;d3dpp.BackBufferFormat = D3DFMT_UNKNOWN;if (FAILED(g_pD3D->CreateDevice(D3DADAPTER_DEFAULT, D3DDEVTYPE_HAL, hWnd,vp,&d3dpp, &g_pd3dDevice))){return E_FAIL;}// Device state would normally be set herereturn S_OK;}

(1)Hwnd为窗口句柄，在此为当前窗口，Direct3Dcreate方法创建IDirect3D9对象，其中只有一个参数，D3D_SDK_VERSION，为当前SDK版本。

(2)检查设备性能。Direct3D提供的每一项性能都对应于结构D3DCAPS9中的一个数据成员或者某一位，以某一具体硬件为基础（默认运行的显卡），初始化一个D3DCAPS9类型的实例，然后通过检查该D3DCAPS9实例中相应的数据成员或者某一位来判断设备是否支持某项性能。这里判断显卡是否支持硬件顶点运算。

(3)D3DPRESENT_PARAMETERS结构体定义了Direct3D设备的信息，在对相关参数进行赋值之前，先将所有参数归零处理，不然，有可能造成创建Direct3D设备失败。D3DPRESENT_PARAMETERS中信息有很多，在此我们只是用其中三个：Windowed = true，表示已窗口模式显示；SwapEffect指定系统如何将后台缓冲区的内容提交到前台，SwapEffect = D3DSWAPEFFECT_DISCARD，表示后台缓冲区的内容提交到前台后，清除后台缓冲区内容；BackBufferFormat指后台缓冲区像素格式，BackBufferFormat = D3DFMT_UNKNOWN，表示后台缓冲区像素格式和当前使用的显卡的像素格式是相同的。

(4)利用已初始化的结构D3DPRESENT_PARAMETERS创建IDirect3DDevice9对象（一个C++对象，代表了我们用来显示3D图形的物理硬件设备）。第一个参数表示使用哪一块显卡，一般情况下为D3DADAPTER_DEFAULT，使用当前显卡；第二个参数表示Direct3D的设备类型，在此我们将其设置为硬件抽象层D3DDEVTYPE_HAL；第三个参数就是方法传入的窗口句柄；第四个参数为Direct3D设备的行为标志，在此选择之前我们通过检查设备性能得到的变量vp；第五和第六个参数分别为指向d3dpp的指针和Direct3D设备指针的地址。

一切创建成功后，方法返回S_OK。

Cleanup()方法

VOID Cleanup(){if (g_pd3dDevice != NULL)g_pd3dDevice->Release();if (g_pD3D != NULL)g_pD3D->Release();}

此方法主要是释放Direct3D资源，因为不管Direct3D对象还是Direct3D设备对象都是COM对象，所以，在此必须调用Release方法，使COM对象的引用计数-1。并且，必须先释放Direct3D设备对象，再释放Direct3D对象（因为Direct3D设备对象是通过Direct3D对象创建的）。

Render()方法

VOID Render(){if (NULL == g_pd3dDevice)return;// Clear the backbuffer to a blue colorg_pd3dDevice->Clear(0, NULL, D3DCLEAR_TARGET, D3DCOLOR_XRGB(192, 192, 192), 1.0f, 0);// Begin the sceneif (SUCCEEDED(g_pd3dDevice->BeginScene())){// Rendering of scene objects can happen here// End the sceneg_pd3dDevice->EndScene();}// Present the backbuffer contents to the displayg_pd3dDevice->Present(NULL, NULL, NULL, NULL);}

从Render()方法中我们可以看出，Direct3D设备对象是一切Direct 3D图形绘制的基础。

首先Clear方法，作用是清空后台缓冲区，其中参数分别为：count，表示pRect参数的矩形的数量，如果pRect为NULL，则count必须为0，如果pRect是有效的指针，则count必须不为0；pRect存储着需要清空的矩形区域；Flags参数表示要清空的缓冲区，此处设置为D3DCLEAR_TARGET，表示清空颜色缓冲区；Color参数表示以什么颜色填充清空后的缓冲区的每个像素的颜色；Z参数表示清空深度缓冲区(ZBUFFER)后每个像素的深度值；Stencil表示清空模板缓冲区后每个像素的模板值。

BeginScene()方法，必须在进行图形渲染之前调用此方法，而在图形渲染结束后，必须调用EndScene()方法，并且，两者必须成对出现。

Render的最后一个方法Present方法，是将在后台渲染的东西翻转到前台，这样就完成了图形渲染的过程。其中Present的第一个参数，表示后台复制源矩形指针，一般为NULL，表示整个后台区域；第二个参数表示前台目标矩形指针，一般为NULL，表示整个前台区域；第三个参数表示当前渲染图形的窗口句柄，一般情况为NULL；第四个参数为最小更新区域指针，一般为NULL。并且，在InitD3D方法中的D3DPRESENT_PARAMETERS结构的SwapEffect参数的值不是D3DSWAPEFFECT_COPY的时候，Present的第一、二、四个参数必须为NULL。

消息循环

// Enter the message loopMSG msg;ZeroMemory(&msg, sizeof(msg));while (msg.message != WM_QUIT){if (PeekMessage(&msg, NULL, 0U, 0U, PM_REMOVE)){TranslateMessage(&msg);DispatchMessage(&msg);}elseRender();}

在这里使用方法PeekMessage，而不使用GetMessage方法，因为GetMessage会在此等待，直至有消息到来，PeekMessage在没有消息时会直接返回，这样，我们的Render方法就在系统空闲之时得以运行（这对于我们的游戏至关重要，谨记）。

总结：帮助文档还是挺好的，写的很详细，还有助于锻炼我们的英文水平！哈哈！