将KlayGE嵌入到MFC

     说明：

    1、KlayGE是一款国人开发的开源游戏引擎（http://klayge.sourceforge.net/），以下都是以KlayGE3.8.0而言，并且假定您已经可以编译该引擎（具体可以参看readme.html,有一点需要提醒由于KlayGE使用了动态运行时库，所以boost都会使用动态库版本，例如boost::signals, boost::filesystem等，运行时不要忘了相关dll文件）并且可以运行给定的demo。

    2、KlayGE和Ogre都是相当优秀的开源游戏引擎，个人感觉Ogre设计上更为灵活，这是其最值得学习的地方；而KlayGE则在技巧和技术上有更多可以学习的地方（他的设计也是相当优秀的，至少是我辈望尘莫及的），例如boost库的大量使用（尤其是boost::signals和boost::python），强大的字体系统（与Ogre的字体系统对比一下就知道了），与python的结合等。

    3、MFC只是提供了一个GUI框架，还可以有更多的选择，wx,qt,甚至是.net Framework等。

    4、本文并没有完美的实现嵌入，至少KlayGE自带的GUI系统嵌入后就无法正常使用了。并且由于KlayGE没有开放单独绘制一桢这样的函数，所以直接关闭程序会有内存泄漏和异常。以后再研究研究，试着把相关功能提取一下，做成和Ogre一样的，那样就可以在OnIdle()和OnPaint()时渲染一桢，在OnDestory()时清理资源。

 

~~~~~~~~~~~~~~~~~~~~~哥不是分界线，是寂寞~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

 

    KlayGE本身并没有为嵌入MFC做过考虑（这似乎也是正常的），但是假如我们要做一款编辑器或是其他什么东东，需要用到这方面的功能。KlayGE源代码的修改是必须的。

    KlayGE工程，window.hpp/cpp，class Window     这个类就是一个窗口，KlayGE会在构造函数的时候CreateWindow，而我们所要做的就是创建另一个构造函数，传入一个HWND，这个构造函数不会CreateWindow。如下：

Window::Window(HWND hWnd, const std::string& strName){Convert(wname_, strName);wnd_ = hWnd;m_bIsExternal = true;RECT rect;GetWindowRect(wnd_, &rect);left_ = rect.left;top_ = rect.top;width_ = rect.right - rect.left;height_ = rect.bottom - rect.top;}Window::~Window(){if (wnd_ != NULL && !m_bIsExternal){::DestroyWindow(wnd_);wnd_ = NULL;}}

这里多添了一个成员变量m_bIsExternal，如果是外部传入的窗口句柄，那么window在析构的时候就不销毁窗口。

    Window的创建是在App3D.hpp/cpp中App3DFramework类的构造函数中进行的，建立一个3D程序必须继承这个类。同理我们需要添加一个传入HWND的构造函数。

App3DFramework::App3DFramework(HWND hWnd, const std::string& strName, RenderSettings const & settings): name_(strName), settings_(settings),fps_(0), accumulate_time_(0), num_frames_(0){Context::Instance().AppInstance(*this);main_wnd_ = this->MakeWindow(hWnd, strName);settings_.left = main_wnd_->Left();settings_.top = main_wnd_->Top();settings_.width = main_wnd_->Width();settings_.height = main_wnd_->Height();}WindowPtr App3DFramework::MakeWindow(HWND hWnd, const std::string &strName){return MakeSharedPtr<Window>(hWnd, strName);}

    这样我们的准备工作就完成了。接下来就是建立一个MFC程序（单文档或多文档均可），选择一个Demo插入到工程中，在合适的位置初始化（我个人喜欢把Demo的头文件包含在CXXXXApp.h中，并在BOOL CXXXXApp::InitInstance()中的ShowWindow之前初始化，因为这个时候View肯定已经创建完成了。别忘了using namespace KlayGE;），最后删除原Demo中的main函数。

// 调度在命令行中指定的命令。如果// 用 /RegServer、/Register、/Unregserver 或 /Unregister 启动应用程序，则返回 FALSE。if (!ProcessShellCommand(cmdInfo))return FALSE;ResLoader::Instance().AddPath("./media/Common");ResLoader::Instance().AddPath("./media/Cartoon");RenderSettings settings = Context::Instance().LoadCfg("KlayGE.cfg");CMainFrame* pMainFrm = (CMainFrame*)m_pMainWnd;Cartoon app(pMainFrm->GetActiveView()->GetSafeHwnd(), "卡通渲染", settings);app.Create();app.Run();// 唯一的一个窗口已初始化，因此显示它并对其进行更新m_pMainWnd->ShowWindow(SW_SHOW);m_pMainWnd->UpdateWindow();

    ResLoader开始，注意这里的资源位置要正确，并且KlayGE的Demo中使用的都是.kui .kfx这样加密成二进制的文件。把对应的xml文件（如 .uiml .fxml）插入到工程中vs会自动编译的。

    好了，一切就绪，编译……………………等等，怎么出现一大堆错误？

    原来是windef.h中的min max宏定义和std::min std::max冲突了，在有冲突的头文件开头加入#undef min和#undef max（我加在mathhelper.hpp和elementformat.hpp中）就好了。

     ok, enjoy yourself!