DirectX 3D 基本框架(一)

給出DirectX 3D 應用程序的基本框架,顯示一個空白窗口。若要寫出相關例程，只需修改相關函數即可。我已經加了詳細註釋。

 

頭文件:

1. //////////////////////////////////////////////////////////////////////////////////////////////////
2. //
3. // File: d3dUtility.h
4. // by tianzhihen 
5. // 2008.10.9
6. // MSVC++ 8.0
7. //////////////////////////////////////////////////////////////////////////////////////////////////
9. #ifndef __d3dUtilityH
10. #define __d3dUtilityH
12. #include <d3dx9.h>
13. //#include <string>
15. namespace d3d
16. {
17.     bool InitD3D(
18.         HINSTANCE hInstance,    //應用程序實例
19.         int width, int height,  //後備緩衝寬/高
20.         bool windowed,          //顯示模式(窗口/全屏)
21.         D3DDEVTYPE deviceType,  //設備類型(HAL/REF)
22.         IDirect3DDevice9** device   //指向設備(顯卡)接口地址的指針
23.         );
25.     //進入消息循環
26.     int EnterMsgLoop(
27.         bool (*ptr_display)(float timeDelta));
29.     //回調函數
30.     LRESULT CALLBACK WndProc(
31.         HWND hwnd,
32.         UINT msg,
33.         WPARAM wParam,
34.         LPARAM lParam
35.         );
37.     template<class T> void Release(T t)
38.     {
39.         if (t)
40.         {
41.             t->Release();
42.             t = 0;
43.         }
44.     }
46.     template<class T> void Delete(T t)
47.     {
48.         if (t)
49.         {
50.             delete t;
51.             t = 0;
52.         }
53.     }
55. }
57. #endif

其實現文件:

1. //////////////////////////////////////////////////////////////////////////////////////////////////
2. //
3. // File: d3dUtility.cpp
4. // by tianzhihen 
5. // 2008.10.9
6. // MSVC++ 8.0
7. //////////////////////////////////////////////////////////////////////////////////////////////////
9. #include "d3dUtility.h"
12. bool d3d::InitD3D(HINSTANCE hInstance, 
13.                   int width, int height, 
14.                   bool windowed, 
15.                   D3DDEVTYPE deviceType,
16.                   IDirect3DDevice9** device )
17. {
18.     //
19.     //創造應用程序窗口
20.     //
22.     //初始化windows窗口類
23.     WNDCLASS wc;
25.     wc.style         = CS_HREDRAW | CS_VREDRAW;
26.     wc.lpfnWndProc   = (WNDPROC)d3d::WndProc; 
27.     wc.cbClsExtra    = 0;
28.     wc.cbWndExtra    = 0;
29.     wc.hInstance     = hInstance;
30.     wc.hIcon         = LoadIcon(0, IDI_APPLICATION);
31.     wc.hCursor       = LoadCursor(0, IDC_ARROW);
32.     wc.hbrBackground = (HBRUSH)GetStockObject(WHITE_BRUSH);
33.     wc.lpszMenuName  = 0;
34.     wc.lpszClassName = "Direct3D9App";
36.     //註冊窗口類
37.     if (!RegisterClass(&wc))
38.     {
40.         ::MessageBox(0,"RegisterClass() - FAILED",0,0);
41.         return false;
42.     }
43.     
44.     //創建窗口並返回其句柄
45.     HWND hwnd = 0;
46.     hwnd = ::CreateWindow("Direct3D9App", "Direct3D9App", 
47.         WS_EX_TOPMOST,
48.         0, 0, width, height,
49.         0 /*parent hwnd*/, 0 /* menu */, hInstance, 0 /*extra*/); 
51.     if( !hwnd )
52.     {
53.         ::MessageBox(0, "CreateWindow() - FAILED", 0, 0);
54.         return false;
55.     }
58.     //顯示/更新 窗口
59.     ::ShowWindow(hwnd,SW_SHOW);
60.     ::UpdateWindow(hwnd);
62.     //
63.     // Init D3D
64.     //
66.     HRESULT hr = 0;
68.     //獲取IDirect3D9 的指針(第1步)
69.     IDirect3D9* d3d9 = 0;
70.     d3d9 = Direct3DCreate9(D3D_SDK_VERSION);
72.     if (!d3d9)
73.     {
74.         ::MessageBox(0, "Direct3DCreate9() - FAILED", 0, 0);
75.         return false;
76.     }
78.     //校驗頂點運算(第2步)
79.     //獲取設備性能
80.     D3DCAPS9 caps;
81.     d3d9->GetDeviceCaps(D3DADAPTER_DEFAULT, //指定默認顯示卡
82.         deviceType,     //指定設備類型
83.         &caps /*返回已初始化的設備性能結構實例*/);
85.     int vp = 0;
86.     if (caps.DevCaps & D3DDEVCAPS_HWTRANSFORMANDLIGHT)
87.         vp = D3DCREATE_HARDWARE_VERTEXPROCESSING;   //支持硬件頂點運算
88.     else
89.         vp = D3DCREATE_SOFTWARE_VERTEXPROCESSING;   //不支持硬件頂點運算
91.     //填充D3DPRESENT_PARAMETERS 結構(第3步)
92.     D3DPRESENT_PARAMETERS d3dpp;
93.     d3dpp.BackBufferWidth            = width;
94.     d3dpp.BackBufferHeight           = height;
95.     d3dpp.BackBufferFormat           = D3DFMT_A8R8G8B8;
96.     d3dpp.BackBufferCount            = 1;
97.     d3dpp.MultiSampleType            = D3DMULTISAMPLE_NONE;
98.     d3dpp.MultiSampleQuality         = 0;
99.     d3dpp.SwapEffect                 = D3DSWAPEFFECT_DISCARD; //指定交換鏈中的緩存的頁面置換方式
100.     d3dpp.hDeviceWindow              = hwnd;
101.     d3dpp.Windowed                   = windowed;
102.     d3dpp.EnableAutoDepthStencil     = true; 
103.     d3dpp.AutoDepthStencilFormat     = D3DFMT_D24S8;
104.     d3dpp.Flags                      = 0;
105.     d3dpp.FullScreen_RefreshRateInHz = D3DPRESENT_RATE_DEFAULT; //默認刷新頻率
106.     d3dpp.PresentationInterval       = D3DPRESENT_INTERVAL_IMMEDIATE;   //立即提交(後備緩衝)
108.     //創建設備(第4步)
109.     hr = d3d9->CreateDevice(
110.         D3DADAPTER_DEFAULT, //默認顯示卡
111.         deviceType, //設備類型(HAL/REF)
112.         hwnd,   //窗口句柄
113.         vp,     //指定頂點運算方式
114.         &d3dpp, //present parameters
115.         device  //返回創建的設備接口的地址
116.         );
118.     if(FAILED(hr))
119.     {
120.         //如果創建失敗,重設深度緩存的像素格式,再創建一次。
121.         d3dpp.AutoDepthStencilFormat = D3DFMT_D16;
123.         hr = d3d9->CreateDevice(
124.             D3DADAPTER_DEFAULT, //默認顯示卡
125.             deviceType, //設備類型(HAL/REF)
126.             hwnd,   //窗口句柄
127.             vp,     //指定頂點運算方式
128.             &d3dpp, //present parameters
129.             device  //返回創建的設備接口的地址
130.             );
132.         if (FAILED(hr))
133.         {
134.             d3d9->Release();
135.             ::MessageBox(0, "CreateDevice() - FAILED", 0, 0);
136.             return false;
137.         }
138.     }
140.     d3d9->Release();
142.     return true;
144. }
146. int d3d::EnterMsgLoop(bool (*ptr_display)(float timeDelta))
147. {
148.     //
149.     //消息循環
150.     //
152.     MSG msg;
153.     ::ZeroMemory(&msg,sizeof(MSG));
155.     static float lastTime = (float)timeGetTime(); 
157.     while (msg.message!=WM_QUIT)
158.     {
159.         if (::PeekMessage(&msg,0,0,0,PM_REMOVE))
160.         {
161.             ::TranslateMessage(&msg);
162.             ::DispatchMessage(&msg);
163.         }
164.         else
165.         {
166.             float currTime = (float)timeGetTime();
167.             float timeDelta = (currTime - lastTime)*0.001f;
169.             ptr_display(timeDelta);
170.             lastTime = currTime;
172.         }
173.     }
175.     return msg.wParam;
176. }

主程序文件:

1. //////////////////////////////////////////////////////////////////////////////////////////////////
2. //
3. // File: d3dUtility.cpp
4. // by tianzhihen 
5. // 2008.10.9
6. // MSVC++ 8.0
7. //////////////////////////////////////////////////////////////////////////////////////////////////
10. #include "d3dUtility.h"
13. //
14. //  全局變量
15. //
17. IDirect3DDevice9* Device = 0;
19. //
20. // 框架函數
21. //
23. bool Setup()
24. {
25.     return true;
26. }
29. void Cleanup()
30. {
32. }
34. bool Display(float timeDelta)
35. {
36.     if (Device)
37.     {
38.         Device->Clear(0,0,D3DCLEAR_TARGET | D3DCLEAR_ZBUFFER , 0x00000000,1.0f,0);
39.         Device->Present(0,0,0,0);
40.     }
42.     return true;
43. }
45. //
46. // WndProc
47. //
49. LRESULT CALLBACK d3d::WndProc(HWND hwnd, UINT msg, WPARAM wParam, LPARAM lParam )
50. {
51.     switch(msg)
52.     {
53.     case WM_DESTROY:
54.         ::PostQuitMessage(0);
55.         break;
57.     case WM_KEYDOWN:
58.         if(wParam == VK_ESCAPE)
59.             ::DestroyWindow(hwnd);
60.         break;
61.     }
63.     return ::DefWindowProc(hwnd,msg,wParam,lParam);
65. }
67. //
68. //  WinMain
69. //
71. int WINAPI WinMain(HINSTANCE hInstance,
72.                    HINSTANCE hPrevInstance, 
73.                    LPSTR lpCmdLine,
74.                    int nShowCmd )
75. {
76.     //程序入口地址
78.     //初始化D3D
79.     if (!d3d::InitD3D(hInstance,640,480,true,D3DDEVTYPE_HAL,&Device))
80.     {
81.         ::MessageBox(0, "InitD3D() - FAILED", 0, 0);
82.         return 0;
83.     }
85.     //分配資源
86.     if (!Setup())
87.     {
88.         ::MessageBox(0, "Setup() - FAILED", 0, 0);
89.         return 0;
90.     }
92.     //進入消息循環
93.     d3d::EnterMsgLoop(Display);
95.     //清理資源
96.     Cleanup();
98.     Device->Release();
100.     return 0;
101. }