用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<ddraw.h>

#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;

}