【转贴】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 );
}