【转贴】DXUT 框架入门 2

这章主要介绍一下DXUT 里面的GUI元素。要在图形界面中添加GUI元素，首先要定义一个DialogResourceManager对象用来管理对话框资源。DialogResourceManager 管理渲染时状态、Sprite控制批量显示更新、对话框字体、纹理等等。CDXUTDialog 相当于MFC里面的对话框，作为各种控件资源的容器。CD3DSettingsDlg 是一个ms已经写好的对话框类，可以用来设置各种Direct3DDevice9 创建时的参数。点击该对话框的ok 按钮，D3D设备将会重建。

  这里先建立了DialogResourceManager全局变量g_DialogResourceManager和CD3DSettingsDlg 全局变量g_SettingsDlg。并且要在 OnCreateDevice OnResetDevice MsgProc OnLostDevice OnDestroyDevice 回调函数中调用自己相应的函数如g_DialogResourceManager.OnCreateDevice(...) 等等。
  对于对话框对象使用前必须初始化 init() 参数为DialogResourceManager类对象，即g_DialogResourceManager.之后对于CDXUTDialog类对象g_HUD需要设置自己的消息回调函数 OnGUIEvent()。并且在 dxut 的消息处理函数MsgProc中调用自己的消息处理函数 g_HUD->MsgProc()， 如果是该对话框的消息，Dxut回调函数将不再处理这个消息。而交由对话框处理。

//使用DXUT 框架GUI程序
#include <dxstdafx.h>

//自定义顶点结构
struct CUSTOMVERTEX
{
 float x,y,z,rhw;
 DWORD diffuse;
};

ID3DXFont*     g_pFont = NULL;     // Font for drawing text
ID3DXSprite*    g_pTextSprite = NULL;   // Sprite for batching draw text calls
bool      g_bShowHelp = true;    // If true, it renders the UI control text
CDXUTDialogResourceManager g_DialogResourceManager;  // manager for shared resources of dialogs
CD3DSettingsDlg    g_SettingsDlg;     // Device settings dialog
CDXUTDialog     g_HUD;       // dialog for standard controls
static const int   D3DFVF_CUSTOMVERTEX = D3DFVF_XYZRHW | D3DFVF_DIFFUSE;
LPDIRECT3DVERTEXBUFFER9  g_pVB;
bool      g_vsb = true;

//定义g_HUD对话框上按钮ID
static const int IDC_TOGGLEFULLSCREEN=1;  
static const int IDC_TOGGLEREF=2;
static const int IDC_CHANGEDEVICE=3;

HRESULT CALLBACK OnCreateDevice( IDirect3DDevice9* pd3dDevice, const D3DSURFACE_DESC* pBackBufferSurfaceDesc, void* pUserContext );
HRESULT CALLBACK OnResetDevice( IDirect3DDevice9* pd3dDevice, const D3DSURFACE_DESC* pBackBufferSurfaceDesc, void* pUserContext );
void    CALLBACK OnFrameMove( IDirect3DDevice9* pd3dDevice, double fTime, float fElapsedTime, void* pUserContext );
void    CALLBACK OnFrameRender( IDirect3DDevice9* pd3dDevice, double fTime, float fElapsedTime, void* pUserContext );
LRESULT CALLBACK MsgProc( HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam, bool* pbNoFurtherProcessing, void* pUserContext );
void    CALLBACK KeyboardProc( UINT nChar, bool bKeyDown, bool bAltDown, void* pUserContext );
void    CALLBACK OnGUIEvent( UINT nEvent, int nControlID, CDXUTControl* pControl, void* pUserContext );
void    CALLBACK OnLostDevice( void* pUserContext );
void    CALLBACK OnDestroyDevice( void* pUserContext );
void    InitApp();
void    RenderText();

INT WINAPI WinMain( HINSTANCE, HINSTANCE, LPSTR, int )
{
 //为DEBUG模式激活运行时内存检查
#if defined(DEBUG) | defined(_DEBUG)
 _CrtSetDbgFlag( _CRTDBG_ALLOC_MEM_DF | _CRTDBG_LEAK_CHECK_DF );
#endif
 // 设置回调函数，这些函数允许DXUT通知应用程序更换设备，用户输入和窗口消息。
 // 回调函数是可选的，因此你要做的仅是设置你感兴趣的事件的回调函数。
 DXUTSetCallbackDeviceCreated( OnCreateDevice );
 DXUTSetCallbackDeviceReset( OnResetDevice );
 DXUTSetCallbackDeviceLost( OnLostDevice );
 DXUTSetCallbackDeviceDestroyed( OnDestroyDevice );
 DXUTSetCallbackFrameRender( OnFrameRender );
 DXUTSetCallbackFrameMove( OnFrameMove );
 DXUTSetCallbackMsgProc( MsgProc );
 DXUTSetCallbackKeyboard( KeyboardProc );
 // 全屏时显示鼠标
 DXUTSetCursorSettings( true, true );
 //InitApp();
 // 初始化DXUT并创建想要的Win32窗口和应用程序的Direct3D设备。调用这些
 // 可选函数中的每一个，此外它们允许你设置几个选项来控制框架的行为。
 DXUTInit( TRUE, TRUE, TRUE );
 DXUTCreateWindow( L"ameng" );
 DXUTCreateDevice( D3DADAPTER_DEFAULT, TRUE, 640, 480 );
 // 通过DXUT来处理消息循环并分派渲染调用。当在空闲时间和处理窗口消息的
 // 时间间隔时，框架将调用OnFrameMove和OnFrameRender回调函数。
 DXUTMainLoop();
 return DXUTGetExitCode();
}
void InitApp()
{
 // 初始化对话框
 g_SettingsDlg.Init(&g_DialogResourceManager );
 g_HUD.Init(&g_DialogResourceManager );
 //设置对话框消息处理函数。
 g_HUD.SetCallback( OnGUIEvent ); 
 int iY = 10; 
 g_HUD.AddButton( IDC_TOGGLEFULLSCREEN, L"Toggle full screen", 35, iY, 125, 22 );
 g_HUD.AddButton( IDC_TOGGLEREF, L"Toggle REF (F3)", 35, iY += 24, 125, 22,VK_F3 );
 g_HUD.AddButton( IDC_CHANGEDEVICE, L"Change device (F2)", 35, iY += 24, 125, 22, VK_F2 );
}


HRESULT CALLBACK OnCreateDevice( IDirect3DDevice9* pd3dDevice, const D3DSURFACE_DESC* pBackBufferSurfaceDesc, void* pUserContext )
{
 HRESULT hr;
 V_RETURN( g_DialogResourceManager.OnCreateDevice( pd3dDevice ) );
  InitApp();
 V_RETURN( g_SettingsDlg.OnCreateDevice( pd3dDevice ) );
 // Initialize the font
 V_RETURN( D3DXCreateFont( pd3dDevice, 15, 0, FW_BOLD, 1, FALSE, DEFAULT_CHARSET, 
  OUT_DEFAULT_PRECIS, DEFAULT_QUALITY, DEFAULT_PITCH | FF_DONTCARE, 
  L"Arial", &g_pFont ) );
 return S_OK;
}
HRESULT CALLBACK OnResetDevice( IDirect3DDevice9* pd3dDevice, const D3DSURFACE_DESC* pBackBufferSurfaceDesc, void* pUserContext )
{
 HRESULT hr;
 static CUSTOMVERTEX vertices[] =
 {
  { 300.0f,  50.0f, 0.1f, 1.0f, D3DCOLOR_ARGB(255,255,0,0) }, // x, y, z, rhw, color
  { 500.0f, 350.0f, 0.1f, 1.0f, D3DCOLOR_ARGB(255,0,255,0) },
  { 100.0f, 350.0f, 0.1f, 1.0f, D3DCOLOR_ARGB(255,0,0,255) },
 };
 pd3dDevice->CreateVertexBuffer(3*sizeof(CUSTOMVERTEX),0,D3DFVF_CUSTOMVERTEX,D3DPOOL_DEFAULT,&g_pVB,NULL);
 BYTE* pVertices;
 if( FAILED( g_pVB->Lock( 0, sizeof(vertices), (void**)&pVertices, 0 )))
  return E_FAIL;
 memcpy(pVertices,vertices,sizeof(vertices));
 g_pVB->Unlock();
 V_RETURN( g_DialogResourceManager.OnResetDevice() );
 V_RETURN( g_SettingsDlg.OnResetDevice() );
 if( g_pFont )
  V_RETURN( g_pFont->OnResetDevice() );
 // Create a sprite to help batch calls when drawing many lines of text
 V_RETURN( D3DXCreateSprite( pd3dDevice, &g_pTextSprite ) );
 g_HUD.SetLocation( pBackBufferSurfaceDesc->Width-170, 0 );
 g_HUD.SetSize( 170, 170 );
 return S_OK;
}
void CALLBACK OnFrameMove( IDirect3DDevice9* pd3dDevice, double fTime, float fElapsedTime, void* pUserContext )
{

}
void CALLBACK OnFrameRender( IDirect3DDevice9* pd3dDevice, double fTime, float fElapsedTime, void* pUserContext )
{
 HRESULT hr;
 V( pd3dDevice->Clear(0, NULL, D3DCLEAR_TARGET | D3DCLEAR_ZBUFFER, D3DCOLOR_ARGB(0, 0, 0, 0), 1.0f, 0) );
 V(pd3dDevice->SetStreamSource(0,g_pVB,0,sizeof(CUSTOMVERTEX)));
 V(pd3dDevice->SetFVF(D3DFVF_CUSTOMVERTEX));
 if( g_SettingsDlg.IsActive() )
 {
  g_SettingsDlg.OnRender( fElapsedTime );
  return;
 }
 if(SUCCEEDED(pd3dDevice->BeginScene()))
 {
  //更新图像
  V(pd3dDevice->DrawPrimitive(D3DPT_TRIANGLELIST,0,1));
  if(g_vsb)
  {
   RenderText();
  }
  V( g_HUD.OnRender( fElapsedTime ) );
//  V( g_SampleUI.OnRender( fElapsedTime ) );
  pd3dDevice->EndScene();
 }
}
void RenderText()
{
 // The helper object simply helps keep track of text position, and color
 // and then it calls pFont->DrawText( m_pSprite, strMsg, -1, &rc, DT_NOCLIP, m_clr );
 // If NULL is passed in as the sprite object, then it will work however the 
 // pFont->DrawText() will not be batched together.  Batching calls will improves performance.
 CDXUTTextHelper txtHelper( g_pFont, g_pTextSprite, 15 );
 // Output statistics
 txtHelper.Begin();
 txtHelper.SetInsertionPos( 5, 5 );
 txtHelper.SetForegroundColor( D3DXCOLOR( 1.0f, 1.0f, 0.0f, 1.0f ) );
 txtHelper.DrawTextLine( DXUTGetFrameStats(true) ); //为true 显现FPS，默认为false不显使FPS
 txtHelper.DrawTextLine( DXUTGetDeviceStats() );

 
 //TODO: add UI text as needed
 txtHelper.SetForegroundColor( D3DXCOLOR( 1.0f, 1.0f, 1.0f, 1.0f ) );
 txtHelper.DrawTextLine( L"Put whatever misc status here" );

 // 获取图象后备缓冲区
 const D3DSURFACE_DESC* pd3dsdBackBuffer = DXUTGetBackBufferSurfaceDesc();
 if( g_bShowHelp )
 {
  txtHelper.SetInsertionPos( 10, pd3dsdBackBuffer->Height-15*6 );
  txtHelper.SetForegroundColor( D3DXCOLOR( 1.0f, 0.75f, 0.0f, 1.0f ) );
  txtHelper.DrawTextLine( L"Controls (F1 to hide):" );
  txtHelper.SetInsertionPos( 40, pd3dsdBackBuffer->Height-15*5 );
  txtHelper.DrawTextLine( L"Quit: ESC" );
 }
 else
 {
  //txtHelper.SetInsertionPos( 10, pd3dsdBackBuffer->Height-15*2 );
  txtHelper.SetForegroundColor( D3DXCOLOR( 1.0f, 1.0f, 1.0f, 1.0f ) );
  txtHelper.DrawTextLine( L"Press F1 for help" );
 }
 
 txtHelper.End();
}

//--------------------------------------------------------------------------------------
// Before handling window messages, DXUT passes incoming windows 
// messages to the application through this callback function. If the application sets 
// *pbNoFurtherProcessing to TRUE, then DXUT will not process this message.
//--------------------------------------------------------------------------------------
LRESULT CALLBACK MsgProc( HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam, bool* pbNoFurtherProcessing, void* pUserContext )
{
 // Always allow dialog resource manager calls to handle global messages
 // so GUI state is updated correctly
 *pbNoFurtherProcessing = g_DialogResourceManager.MsgProc( hWnd, uMsg, wParam, lParam );
 if( *pbNoFurtherProcessing )
  return 0;
 if( g_SettingsDlg.IsActive() )
 {
  g_SettingsDlg.MsgProc( hWnd, uMsg, wParam, lParam );
  return 0;
 }
 // Give the dialogs a chance to handle the message first
 *pbNoFurtherProcessing = g_HUD.MsgProc( hWnd, uMsg, wParam, lParam );
 if( *pbNoFurtherProcessing )
  return 0;
 return 0;
}

//--------------------------------------------------------------------------------------
// As a convenience, DXUT inspects the incoming windows messages for
// keystroke messages and decodes the message parameters to pass relevant keyboard
// messages to the application.  The framework does not remove the underlying keystroke 
// messages, which are still passed to the application's MsgProc callback.
//--------------------------------------------------------------------------------------
void CALLBACK KeyboardProc( UINT nChar, bool bKeyDown, bool bAltDown, void* pUserContext )
{
 if( bKeyDown )
 {
  switch( nChar )
  {
   case VK_F1: 
    g_bShowHelp = !g_bShowHelp; 
    break;
   case VK_F4:
    g_HUD.SetVisible(!g_HUD.GetVisible());
    g_vsb = !g_vsb;
    break;
   default:
    break;
  }
 }
}

//--------------------------------------------------------------------------------------
// Handles the GUI events
//--------------------------------------------------------------------------------------
void CALLBACK OnGUIEvent( UINT nEvent, int nControlID, CDXUTControl* pControl, void* pUserContext )
{
 switch( nControlID )
 {
  case IDC_TOGGLEFULLSCREEN: 
   DXUTToggleFullScreen(); 
   break;
  case IDC_TOGGLEREF:        
   DXUTToggleREF(); 
   break;
  case IDC_CHANGEDEVICE:     
   g_SettingsDlg.SetActive( !g_SettingsDlg.IsActive() ); 
   break;
 }
}
void CALLBACK OnLostDevice( void* pUserContext )
{
 if(g_pVB != NULL)
 {
  g_pVB->Release();
  g_pVB = NULL;
 }
 g_DialogResourceManager.OnLostDevice();
 g_SettingsDlg.OnLostDevice();
 if( g_pFont )
  g_pFont->OnLostDevice();
 
 SAFE_RELEASE( g_pTextSprite );
}
void CALLBACK OnDestroyDevice( void* pUserContext )
{
 g_DialogResourceManager.OnDestroyDevice();
 g_SettingsDlg.OnDestroyDevice();
 SAFE_RELEASE( g_pFont );
}