【MangoGUI控件系列教程】MangoGUI Tut03_CreateSceneManager 创建场景管理器

夜行的猫仔

在Tut01_CreateWindwos 里已经介绍了MANGOGUI的程序框架，例题Tut01为了让结构看起来更简单，因此简化了很多的函数，这样做甚至牺牲了一部分框架的完整性。在本节例题中，将介绍较为完整的框架结构。以及如何控制创景管理器创建GUI界面。

Tut02中已经讲过了，每一个界面控制文件都对应游戏界面中的一个Scene，一系列的Scene组成了一个游戏的GUI界面。因此管理好Scene就管理了游戏界面。在MANGOGUI中是通过CMANGOSceneManager 来控制游戏中的Scene的。


本教程完整项目下载地址(工作目录是bin文件夹)：
http://kuai.xunlei.com/d/SUFKNHVDLQLU

以下是完整调用代码

1. //=============================================================================
   
2. // Desc: Direct3D应用程序框架
   
3. //=============================================================================
   
4. #include "../MangoInterface/interface/Mango.h"
   
5. #include "MessageId.h"
   
6. //-----------------------------------------------------------------------------
   
7. // 全局变量
   
8. //-----------------------------------------------------------------------------
   
9. CMANGOSceneManager                   g_SceneManager;
   
10. 
    
11. //-----------------------------------------------------------------------------
    
12. // Desc: 函数声明
    
13. // 以下罗列了MANGOGUI中使用到的回调函数。整个MANGOGUI都是在这些回调函数的驱动下工作的。
    
14. //------------------------------------------------------------------------------
    
15. bool    CALLBACK IsDeviceAcceptable( D3DCAPS9* pCaps, D3DFORMAT AdapterFormat, D3DFORMAT BackBufferFormat, bool bWindowed, void* pUserContext );
    
16. bool    CALLBACK ModifyDeviceSettings( MANGODeviceSettings* pDeviceSettings, const D3DCAPS9* pCaps, void* pUserContext );
    
17. HRESULT CALLBACK OnCreateDevice( IDirect3DDevice9* pd3dDevice, const D3DSURFACE_DESC* pBackBufferSurfaceDesc, void* pUserContext );
    
18. HRESULT CALLBACK OnResetDevice( IDirect3DDevice9* pd3dDevice, const D3DSURFACE_DESC* pBackBufferSurfaceDesc, void* pUserContext );
    
19. void    CALLBACK OnFrameMove( IDirect3DDevice9* pd3dDevice, double fTime, float fElapsedTime, void* pUserContext );
    
20. void    CALLBACK OnFrameRender( IDirect3DDevice9* pd3dDevice, double fTime, float fElapsedTime, void* pUserContext );
    
21. LRESULT CALLBACK MsgProc( HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam, bool* pbNoFurtherProcessing, void* pUserContext );
    
22. void    CALLBACK KeyboardProc( UINT nChar, bool bKeyDown, bool bAltDown, void* pUserContext );
    
23. void    CALLBACK OnGUIEvent( UINT nEvent, int nControlID, CMANGOControl* pControl, void* pUserContext );
    
24. void    CALLBACK OnLostDevice( void* pUserContext );
    
25. void    CALLBACK OnDestroyDevice( void* pUserContext );
    
26. 
    
27. void    InitApp();
    
28. 
    
29. //-----------------------------------------------------------------------------
    
30. // Desc: 入口函数
    
31. //-----------------------------------------------------------------------------
    
32. INT WINAPI WinMain( HINSTANCE, HINSTANCE, LPSTR, int )
    
33. {
    
34.         //为Debug配置启用运行时内存检查功能
    
35. #if defined(DEBUG) | defined(_DEBUG)
    
36.         _CrtSetDbgFlag( _CRTDBG_ALLOC_MEM_DF | _CRTDBG_LEAK_CHECK_DF );
    
37. #endif
    
38. 
    
39.         //设置回调函数
    
40.         MANGOSetDeviceCreated( OnCreateDevice );
    
41.         MANGOSetDeviceReset( OnResetDevice );
    
42.         MANGOSetDeviceLost( OnLostDevice );
    
43.         MANGOSetDeviceDestroyed( OnDestroyDevice );
    
44.         MANGOSetMsgProc( MsgProc );
    
45.         MANGOSetKeyboard( KeyboardProc );
    
46.         MANGOSetFrameRender( OnFrameRender );
    
47.         MANGOSetFrameMove( OnFrameMove );
    
48. 
    
49.         //应用程序相关的初始化
    
50.         InitApp();
    
51. 
    
52.         //初始化MANGO, 创建窗口, 创建Direct3D设备对象
    
53.         MANGOInit( true, true, true );
    
54.         MANGOSetCursorSettings( true, true );
    
55.         MANGOCreateWindow( L"MangoGUI System  v 0.1.53" );
    
56.         MANGOCreateDevice( D3DADAPTER_DEFAULT, true, 640, 480, IsDeviceAcceptable, ModifyDeviceSettings );
    
57. 
    
58.         //进入消息循环和场景渲染
    
59.         MANGOMainLoop();
    
60. 
    
61.         //在此进行应用程序相关的清除工作
    
62. 
    
63.         return MANGOGetExitCode();
    
64. }
    
65. 
    
66. 
    
67. //-----------------------------------------------------------------------------
    
68. // Desc: 应用程序相关初始化
    
69. //-----------------------------------------------------------------------------
    
70. void InitApp()
    
71. {
    
72.         //载入一个界面
    
73.         g_SceneManager.CreateScene("layout/scene.xml");       
    
74. }
    
75. 
    
76. 
    
77. //-----------------------------------------------------------------------------
    
78. // Desc: 设备能力检查
    
79. //-----------------------------------------------------------------------------
    
80. bool CALLBACK IsDeviceAcceptable( D3DCAPS9* pCaps, D3DFORMAT AdapterFormat,
    
81.                                                                  D3DFORMAT BackBufferFormat, bool bWindowed,
    
82.                                                                  void* pUserContext )
    
83. {
    
84.         //检查后台缓冲区格式是否支持Alpha混合等操作(post pixel blending operations)
    
85.         IDirect3D9* pD3D = MANGOGetD3DObject();
    
86.         if( FAILED( pD3D->CheckDeviceFormat( pCaps->AdapterOrdinal, pCaps->DeviceType,
    
87.                 AdapterFormat, D3DUSAGE_QUERY_POSTPIXELSHADER_BLENDING,
    
88.                 D3DRTYPE_TEXTURE, BackBufferFormat ) ) )
    
89.                 return false;
    
90. 
    
91.         return true;
    
92. }
    
93. 
    
94. 
    
95. //-----------------------------------------------------------------------------
    
96. // Desc: 修改Direct3D渲染设备设置
    
97. //-----------------------------------------------------------------------------
    
98. bool CALLBACK ModifyDeviceSettings( MANGODeviceSettings* pDeviceSettings,
    
99.                                                                    const D3DCAPS9* pCaps, void* pUserContext )
    
100. {
     
101.         pDeviceSettings->pp.PresentationInterval = D3DPRESENT_INTERVAL_IMMEDIATE;
     
102.         //如果不支持硬件顶点处理则使用软件顶点处理
     
103.         if( (pCaps->DevCaps & D3DDEVCAPS_HWTRANSFORMANDLIGHT) == 0)
     
104.         {
     
105.                 pDeviceSettings->BehaviorFlags = D3DCREATE_SOFTWARE_VERTEXPROCESSING;
     
106.         }
     
107. 
     
108.         //如果使用参考设备,则弹出警告对话框
     
109.         static bool s_bFirstTime = true;
     
110.         if( s_bFirstTime )
     
111.         {
     
112.                 s_bFirstTime = false;
     
113.                 if( pDeviceSettings->DeviceType == D3DDEVTYPE_REF )
     
114.                         MANGODisplaySwitchingToREFWarning();
     
115.         }
     
116. 
     
117.         return true;
     
118. }
     
119. 
     
120. 
     
121. //-----------------------------------------------------------------------------
     
122. // Desc: 在此创建管理内存资源对象
     
123. //-----------------------------------------------------------------------------
     
124. HRESULT CALLBACK OnCreateDevice( IDirect3DDevice9* pd3dDevice,
     
125.                                                                 const D3DSURFACE_DESC* pBackBufferSurfaceDesc,
     
126.                                                                 void* pUserContext )
     
127. {
     
128.         HRESULT hr;
     
129. 
     
130.         V_RETURN( g_SceneManager.OnCreateDevice( pd3dDevice ) );
     
131. 
     
132.         return S_OK;
     
133. }
     
134. 
     
135. 
     
136. //-----------------------------------------------------------------------------
     
137. // Desc: 在此创建默认内存类型资源对象
     
138. //-----------------------------------------------------------------------------
     
139. HRESULT CALLBACK OnResetDevice( IDirect3DDevice9* pd3dDevice,
     
140.                                                            const D3DSURFACE_DESC* pBackBufferSurfaceDesc,
     
141.                                                            void* pUserContext )
     
142. {
     
143.         HRESULT hr;
     
144.         V_RETURN( g_SceneManager.OnResetDevice() );
     
145. 
     
146.         g_SceneManager.GetSceneByName(L"Mango")->SetLocation( pBackBufferSurfaceDesc->Width - 170, 0 );
     
147. 
     
148.         //设置观察矩阵
     
149.         D3DXMATRIXA16 matView;
     
150.         D3DXVECTOR3 vEyePt( 0.0f, 0.0f,-5 );
     
151.         D3DXVECTOR3 vLookatPt( 0.0f, 0.0f, 0.0f );
     
152.         D3DXVECTOR3 vUpVec( 0.0f, 1.0f, 0.0f );
     
153.         D3DXMatrixLookAtLH( &matView, &vEyePt, &vLookatPt, &vUpVec );
     
154.         pd3dDevice->SetTransform( D3DTS_VIEW, &matView );
     
155. 
     
156.         //设置投影矩阵
     
157.         D3DXMATRIXA16 matProj;
     
158.         float fAspectRatio = (float)pBackBufferSurfaceDesc->Width / pBackBufferSurfaceDesc->Height;
     
159.         D3DXMatrixPerspectiveFovLH( &matProj, D3DX_PI/4, fAspectRatio, 1.0f, 100.0f );
     
160.         pd3dDevice->SetTransform( D3DTS_PROJECTION, &matProj );
     
161. 
     
162.         return S_OK;
     
163. }
     
164. 
     
165. 
     
166. //-----------------------------------------------------------------------------
     
167. // Desc: 更新场景
     
168. //-----------------------------------------------------------------------------
     
169. void CALLBACK OnFrameMove( IDirect3DDevice9* pd3dDevice, double fTime,
     
170.                                                   float fElapsedTime, void* pUserContext )
     
171. {
     
172. }
     
173. 
     
174. 
     
175. //-----------------------------------------------------------------------------
     
176. // Desc: 渲染场景
     
177. //-----------------------------------------------------------------------------
     
178. void CALLBACK OnFrameRender( IDirect3DDevice9* pd3dDevice, double fTime,
     
179.                                                         float fElapsedTime, void* pUserContext )
     
180. {
     
181.         HRESULT hr;
     
182.         //清除后台颜色缓冲区和深度缓冲区
     
183.         V( pd3dDevice->Clear(0, NULL, D3DCLEAR_TARGET | D3DCLEAR_ZBUFFER,
     
184.                 D3DCOLOR_ARGB(0, 45, 50, 170), 1.0f, 0) );
     
185. 
     
186.         //渲染场景
     
187.         if( SUCCEEDED( pd3dDevice->BeginScene() ) )
     
188.         {
     
189.                 //渲染文本和控件
     
190.                 MANGO_BeginPerfEvent( MANGO_PERFEVENTCOLOR, L"HUD / Stats" );
     
191.                 g_SceneManager.OnRender(fElapsedTime);
     
192.                 MANGO_EndPerfEvent();
     
193. 
     
194.                 V( pd3dDevice->EndScene() );
     
195.         }
     
196. }
     
197. 
     
198. //-----------------------------------------------------------------------------
     
199. // Desc: 消息处理
     
200. //-----------------------------------------------------------------------------
     
201. LRESULT CALLBACK MsgProc( HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam,
     
202.                                                  bool* pbNoFurtherProcessing, void* pUserContext )
     
203. {
     
204. 
     
205.         *pbNoFurtherProcessing = g_SceneManager.MsgProc( hWnd, uMsg, wParam, lParam );
     
206. 
     
207.         if( *pbNoFurtherProcessing )
     
208.                 return 0;
     
209. 
     
210.         return 0;
     
211. }
     
212. 
     
213. //-----------------------------------------------------------------------------
     
214. // Desc: 键盘消息处理
     
215. //-----------------------------------------------------------------------------
     
216. void CALLBACK KeyboardProc( UINT nChar, bool bKeyDown, bool bAltDown, void* pUserContext )
     
217. {
     
218. }
     
219. 
     
220. 
     
221. //-----------------------------------------------------------------------------
     
222. // Desc: 处理各种控件消息
     
223. //-----------------------------------------------------------------------------
     
224. void CALLBACK OnGUIEvent( UINT nEvent, int nControlID, CMANGOControl* pControl,
     
225.                                                  void* pUserContext )
     
226. {
     
227.         switch( nControlID )
     
228.         {
     
229.         case Button1:
     
230.                 MANGOToggleFullScreen();
     
231.                 break;
     
232. 
     
233.         case Button2:
     
234.                 MANGOToggleREF();
     
235.                 break;
     
236. 
     
237.         case Button3:
     
238.                 break;
     
239.         }
     
240. }
     
241. 
     
242. 
     
243. //-----------------------------------------------------------------------------
     
244. // Desc: 释放在OnResetDevice()中创建的资源
     
245. //-----------------------------------------------------------------------------
     
246. void CALLBACK OnLostDevice( void* pUserContext )
     
247. {
     
248.         g_SceneManager.OnLostDevice();
     
249. }
     
250. 
     
251. 
     
252. //------------------------------------------------------------------------------
     
253. // Desc: 释放在OnCreateDevice()中创建的资源
     
254. //------------------------------------------------------------------------------
     
255. void CALLBACK OnDestroyDevice( void* pUserContext )
     
256. {
     
257.         g_SceneManager.OnDestroyDevice();
     
258. }
     

复制代码

需要解释的几个地方：
"MessageId.h"是消息ID定义文件。在MangoGUI中每一个消息的识别是通过 所在Scene ID+控件ID来识别的。但是对于每一个Scene内部的控件用ID就足够了。MessageId.h中定义的就是控件ID。我们Tut02中已经展示了scene.xml中的数据：

1. <Button ID='101' name ="FullScreen" x='35' y='10' width ='135' height='45' >Toggle full screen</Button>

复制代码

显示Toggle full screen的按钮的ID是101，在“MessageId.h”中也定义了

1. //Window Massage map
   
2. #define Button1 101
   
3. #define Button2 102
   
4. #define Button3 103

复制代码

在后面的OnGUIEvent()函数中，处理了对应的宏定义为Button1的方法。也就是说，当按下了Toggle full screen按钮就会发送nControlID 是101的消息，当我们在OnGUIEvent()中收到这个消息，就执行MANGOToggleFullScreen()这个全屏化操作。

如果大家对D3D不是太熟悉，那么以上的框架就不要改动，以为这个框架完全不影响游戏GUI的操作。我们要完成游戏GUI的所有操作，都是在限定的几个函数内完成的。只需要将我们的逻辑类放在框架内运行即可。


CMANGOSceneManager场景管理器最好在游戏中只创建一个，这个管理器已经集成了对界面控制文件的相关操作，因此需要在界面上显示例如按钮等控件，只需要在相应的界面控制XML文件中添加，控件产生的响应在OnGUIEvent()中对应处理即可。

1. g_SceneManager.CreateScene("layout/scene.xml");

复制代码

通过CreateScene方法载入UI数据。

1. g_SceneManager.OnRender(fElapsedTime);

复制代码

OnRender方法绘制UI数据。