用MFC构造DIRECTX应用框架

一、 MFC类库与DirectXSDK

Microsoft DirectX SDK是开发基 于 Windows平台游戏的一个软件开发工具，其主要功能主要包括在五个组件中: DirectDraw、 DirectSound、DirectPlay、Direct3D和DirectInput，每个组件都具不同的功能:

．DirectDraw使用直接写存技术加快游戏的动画速度；
．DirecSound控制游戏声音的合成和播放；
．DirectPlay使游戏具有网络多人游戏功能；
．Direct3D让程序员更方便地开发三维游戏:
．DirectInput使游戏支待更多的输入设备(现在只支持游戏杆、鼠标和键盘)。

可以说DirectXSDK提供了编写一个游戏所必须的功能及基层函数，所以大多Windows游戏都使用了DitrectXSDK。

MFC(Microsoft Foundation Class)类库是Microsoft Visual C++中提供的一个功能强大的Windows应用程序开发类，使用这些类我们可以避免和繁琐的Windows APl打交道，而且在VisualC++中我们还可以利用C1assWizard对MFC类进行Windows消息映射，所以如果能用MFC类库来开发DirectXSDK的应用程序，至少有以下几个好处:

1．可以用 VC++的 C1assWizard方便地对Windows消息进行映射；
2．增加了程序的可读性，并且可以用VC++的ClassView方便的管理所用的类；
3．增加程序代码的可重用性，可以在原有的基础上开发出功能更强大的应用程序更进一步，如果我们能开发出一个能生成DirectXSDK应用程序基本框架的VC++的工程向导，则为以后开发DirectX SDK应用程序提供及大的方便。下面，我们将用Visua1 C++5．0先编写一个DirectXSDK应用程序的基本框架。

二、编写DirectXSDK应用程序基本框架

我们按下列步骤建立一个勘rectXSDK程序的基本框架:

1．用 Visual C++的 MFC AppWizard(EXE)生成一个基于对话框的工程文件，取名为DirectX，在向导第二步时取消About Box的复选框，然后按Finish按钮。
2．删除在DirectX工程目录中生成的DirectXDlg．CPP和DirectXDlg．H两个文件，并在Visual C++的FileView中删除以上两个文件，按CTRL十W启动ClassWizard删除CDirectXDlg类，然后在ResourceView中删除 IDD_DIRECTX_
DIALOG。
3．建立两个文件 DirectXWnd.CPP和DirectXWnd．H(这两个文件在本文的附录中，请注意不要删除有“\\{”和“\\}”之间的内容，否则将不能使用ClassWizard对窗口消息进行映射)，并把它们加入到工程中。这时工程中将增加一个基于CWnd的CDirectXWnd类，这是我们的DirrectX应用程序的基类。CDirectXWnd类创建一个窗口并生成一个与该窗口相关联的DirectDraw对象lpDD，同时还生成一个显示平面(lpFrontBuffer)和一个显示缓冲平面(lpBackBuffer)，该类使用了几个虚函数，必要时其派生类可以覆盖这些函数。
4．打开DirectX．CPP，把# include“DirectXDlg．h”改为#include“DirectXWnd．H”然后把CDirectXApp::InitInstance()函数修改如下，其中黑体字为要增加的内容:

BOOL CDirectXApp::lnitlnstnnce()
{
    #ifdef _AFXDLL    Enable3dControls()；//Call this when Using MFC in a shared DLL
    #else    Enable3dControlsStatic()；//Call this when linking to MFC statically
    #endif

    CDirectXWnd *pWnd=new CDirectXWnd();
    pWnd->Create("DirectXWnd Test");
    m_pMainWnd = pWnd;
    pWnd->UpdateWindow();
    pWnd->SetFocus();
    if(pWnd->InitializeGame(640,480,8)==FALSE)
    {
        pWnd->DestroyWindow();
        return FALSE;
    }
    MSG msg;
    while(1)
    {
        if(PeekMessage(&msg,NULL,0,0,PM_NOREMOVE))
        {
            if(!GetMessage(&msg,NULL,0,0))
                return msg.wParam;
            TranslateMessage(&msg);
            DispatchMessage(&msg);
        }
        else
        {
            if(pWnd->blsActive)
            {
                pWnd->UpdateFrame();
            }
        }
    }
    return FALSE;
}
编译该程序并运行，可以看到出现一个黑色的屏幕窗口，按ESC或F12则可退出程序。至此，我们的基本框架已经建立好了，虽然这个框架还比较简单，但我们可以在此基础上开发出更强大的应用框架。为了方便使用该框架，我们可以为该框架写一个Custom AppWizard，当然也可以不写，只要把该工程目录下的文件拷贝到另一个工程目录中即可。

三、测试框架

现在，我们按下列步骤写一个测试程序来测试这个框架:

1．把刚才创建的工程框架拷贝到一个新目录下，并打开。用C1assView创建一个基于CWnd的类CTestWnd，然后把CTestWnd.h和CTestWnd.CPP文件中的所有"CWnd"字符串替换为"CDirectXWnd"，并在CTestWnd.h文件头加入下列
字符串:#include"DirectXWnd.h"。
2．打开DirectX.CPP文件，在文件头加入#include"TestWnd.h"，并把该文件中的所有"CDirectXWnd"字符串替换成"CTestWnd"并保存。
3．为 CTestWnd类增加一个虚函数UpdateFrame()，这个函数覆盖了其基类CDirectWnd的UpdateFrame():

void CTestWnd::UpdateFrame()
{
    static int x=0,dx=5;
    static int y=0,dy=5;
    HDC hdc;
    DDBLTFX ddbltfx;
    HRESULT ddrval;
    UpdateWindow();
    ddbltfx.dwSize=sizeof(ddbltfx);
    ddbltfx.dwFillColor=0;
    ddrval=lpBackBuffer->Blt(
        NULL,//dest rect
        NULL,//src surface
        NULL,//src rect
        DDBLT_COLORFILL|DDBLT_WAIT,
        &ddbltfx);
    if(ddrval!=DD_OK)
    {
        Msg("Fill failed ddrval=0x%081x",ddrval);
        return;
    }
    if(lpBackBuffer->GetDC(&hdc)==DD_OK)
    {
        if(x<0)dx=5;
        if(x>590)dx=-5;
        if(y<0)dy=5;
        if(y>430)dy=-5;
        x+=dx;y+=dy;
        Ellipse(hdc,x,y,x+50,y+50);
        lpBackBuffer->ReleaseDC(hdc);
    }
    while(1)
    {
        HRESULT ddrval;
        ddrval=lpFrontBuffer->Flip(NULL,0);
        if(ddrval==DD_OK)
        {
            break;
        };
        if(ddrval==DDERR_SURFACELOST)
        {
            if(!CDirectXWnd::RestoreSurfaces())
            {
                break;
            }
        }
        if(ddrval!=DDERR_WASSTILLDRAWING)
        {
            break;
        }
    }
}

无心柳按：光是这么追加在测试中没有成功，可能要在CTestWnd.H中追加两行：
public:
    void    UpdateFrame();
否则编译可能出错。

4、编译并运行该程序，屏幕上会出现一个白色球在移动。

附录：

文件：DirectXWnd.H

#if!defined(DIRECTXWND_H)
#define DIRECTXWND_H
//DirectXWnd.h:header file
#include
#pragma comment(lib,"ddraw.lib")//链接时加入ddraw.lib库

class CDirectXWnd:public CWnd
{
//Construction
public:
    CDirectXWnd();
    //Attributes
public:
    BOOL blsActive;//应用程序是否被激活
protected:
    LPDIRECTDRAW lpDD;//DirectDraw对象指针
    LPDIRECTDRAWSURFACE lpFrontBuffer;//DirectDraw主缓冲区
    LPDIRECTDRAWSURFACE lpBackBuffer;//DirectDraw后台缓冲区

    int nBufferCount;//后备缓冲区个数
    //Operations
protected:
    void Msg(LPSTR fmt,...);
public:
    BOOL Create(LPCSTR lpszAppName);//创建窗体
    //Overrides
    virtual BOOL InitializeGame(UINT GModex,UINT GModeY,UINT GBPP);
    virtual BOOL CleanSurface();
    virtual void UpdateFrame();
    virtual BOOL RestoreSurfaces(void);
    //{{AFX_VIRTUAL(CDirectXWnd)
    //}}AFX_VIRTUAL
    //implementation
public:
    virtual ~CDirectXWnd();
    //Generated message map functions
protected:
    //{{AFX_MSG(CDirectXWnd)
    afx_msg void OnKeyDown(UINT nChar,UINT nRepCnt,UINT nFlags);
    afx_msg void OnActivateApp(BOOL bActive,HTASK hTask);
    //}}AFX_MSG
    DECLARE_MESSAGE_MAP()
};
////////////////////{{AFX_INSERT_LOCATION}}
#endif//!define(DIRECTXWND_H)

文件：DirectXWnd.CPP
//DirectXWnd.cpp:implementation file
#include "stdafx.h"
#include "DirectX.h"
#include "DirectXWnd.h"
#ifdef _DUBUG
#define new DEBUG_NEW
#undef THIS_FILE
static char THIS_FILE[]=__FILE__;
#endif
CDirectXWnd::CDirectXWnd()
{
    lpDD=NULL;
    lpFrontBuffer=NULL;
    lpBackBuffer=NULL;
    nBufferCount=0;
    blsActive=TRUE;
}
CDirectXWnd::~CDirectXWnd()
{
    if(lpDD)
    {
        CleanSurface();
        lpDD->Release();
        lpDD=NULL;
    }
}
BOOL CDirectXWnd::Create(LPCSTR lpszAppName)
{
    CString className=AfxRegisterWndClass(CS_DBLCLKS,::LoadCursor(NULL,IDC_ARROW),
        NULL,AfxGetApp()->LoadIcon(IDR_MAINFRAME));
    return(CWnd::CreateEx(WS_EX_APPWINDOW,className,lpszAppName,
        WS_VISIBLE|WS_SYSMENU|WS_POPUP,0,0,GetSystemMetrics(SM_CXSCREEN),
        GetSystemMetrics(SM_CYSCREEN),NULL,NULL));
}
BOOL CDirectXWnd::InitializeGame(UINT GModeX,UINT GModeY,UINT GBPP)
{
    HRESULT ddrval;
    ddrval=DirectDrawCreate(NULL,&lpDD,NULL);
    if(ddrval!=DD_OK)
    {
        Msg("DirectDrawCreate failed err=%d",ddrval);
        return FALSE;
    }
    ddrval=lpDD->SetCooperativeLevel(m_hWnd,DDSCL_EXCLUSIVE|DDSCL_FULLSCREEN);
    if(ddrval!=DD_OK)
    {
        Msg("SetCooperativeLevel failed err=%d",ddrval);
        return FALSE;
    }
    ddrval=lpDD->SetDisplayMode(GModeX,GModeY,GBPP);
    if(ddrval!=DD_OK)
    {
        Msg("SetDisplayMode failed err=%d",ddrval);
        return FALSE;
    }
    //check capabilites
    DDCAPS ddcaps;
    ddcaps.dwSize=sizeof(ddcaps);
    ddrval=lpDD->GetCaps(&ddcaps,NULL);
    if(ddrval!=DD_OK)
    {
        Msg("GetCaps failed err=%d",ddrval);
        return FALSE;
    }
    if(ddcaps.dwCaps&DDCAPS_NOHARDWARE)
    {
        Msg("No hardware support at all");
    }
    //default to double buffered on 1mb,triple buffered
    if(nBufferCount==0)
    {
        if(ddcaps.dwVidMemTotal<=1024L*1024L*(GBPP/8)||GModeX>640)
        {
            nBufferCount=2;
        }
        else
        {
            nBufferCount=3;
        }
    }
    DDSURFACEDESC ddsd;
    ::ZeroMemory(&ddsd,sizeof(ddsd));
    ddsd.dwSize=sizeof(ddsd);
    ddsd.dwFlags=DDSD_CAPS|DDSD_BACKBUFFERCOUNT;
    ddsd.ddsCaps.dwCaps=DDSCAPS_PRIMARYSURFACE|DDSCAPS_FLIP|DDSCAPS_COMPLEX;
    ddsd.dwBackBufferCount=nBufferCount-1;
    ddrval=lpDD->CreateSurface(&ddsd,&lpFrontBuffer,NULL);
    if(ddrval!=DD_OK)
    {
        Msg("CreateSurface failed err=%d",ddrval);
        return FALSE;
    }
    else Msg("显示内存允许建立的缓冲区数=%d（最多需要3）",nBufferCount);
    DDSCAPS ddscaps;
    ddscaps.dwCaps=DDSCAPS_BACKBUFFER;
    ddrval=lpFrontBuffer->GetAttachedSurface(&ddscaps,&lpBackBuffer);
    if(ddrval!=DD_OK)
    {
        Msg("GetAttachedsurface failed err=%d",ddrval);
        return FALSE;
    }
    return TRUE;
}
void CDirectXWnd::Msg(LPSTR fmt,...)
{
    char buff[256];
    va_list va;
    lstrcpy(buff,"DirectxWnd:");
    va_start(va,fmt);
    wvsprintf(&buff[lstrlen(buff)],fmt,va);
    va_end(va);
    lstrcat(buff,"\r\n");
    AfxMessageBox(buff);
}
////////////////////////Virtual Function
BOOL CDirectXWnd::RestoreSurfaces()
{
    HRESULT ddrval;
    ddrval=lpFrontBuffer->Restore();
    if(ddrval!=DD_OK)
        return FALSE;
    return TRUE;
}
BOOL CDirectXWnd::CleanSurface()
{
    if(lpBackBuffer)
    {
        lpBackBuffer->Release();
        lpBackBuffer=NULL;
    }
    if(lpFrontBuffer)
    {
        lpFrontBuffer->Release();
        lpFrontBuffer=NULL;
    }
    return TRUE;
}
void CDirectXWnd::UpdateFrame()
{
}
BEGIN_MESSAGE_MAP(CDirectXWnd,CWnd)
//{{AFX_MSG_MAP(CDirectXWnd,Cwnd)
ON_WM_KEYDOWN()
ON_WM_ACTIVATEAPP()
//}}AFX_MSG_MAP
END_MESSAGE_MAP()
///////////////////CDirectXWnd message handlers
void CDirectXWnd::OnKeyDown(UINT nChar,UINT nRepCnt,UINT nFlags)
{
    switch(nChar)
    {
    case VK_ESCAPE:
    case VK_F12:
        PostMessage(WM_CLOSE);
        break;
    }
    CWnd::OnKeyDown(nChar,nRepCnt,nFlags);
}
void CDirectXWnd::OnActivateApp(BOOL bActive,HTASK hTask)
{
    CWnd::OnActivateApp(bActive,hTask);
    blsActive=bActive;
    return;
}