结合使用Ogre 1.7.1 +CEGUI 0.7.1

• 这篇文章是对于Ogre3D中文网——基础教程六的补充，阅读前假定你已经对于Ogre和CEGUI有一定了解，并且阅读了《基础教程六》
  
  如果你还不了解他们，你应该知道：
  Ogre是一个3D图形渲染引擎；CEGUI是灵活的，可自由定义样式的GUI框架，他可以很好的支持Ogre，来绘制界面。
  
  如果你对于Ogre和CEGUI感兴趣，以下将是很好的学习资源：
  Ogre：http://www.ogre3d.org/
  Ogre3D中文网：http://wiki.ogre3d.cn/wiki/
  CEGUI：http://www.cegui.org.uk/
  
  如果你和我一样也是从Ogre1.7开始接触这个食人魔，你也一定在学习的过程中遇到了很多麻烦，官方的入门教程还多数停留在Ogre 1.4的时代，面对这个更新如此频繁的怪物，很多守旧的东西早已不适用，如果你还在挖空心思想要了解这些经历了版本变迁过时的东西，如何能够应用到新的Ogre1.7+CEGUI0.7中，这篇文章或许对你会有帮助:D。另外，Ogre于4月28号刚刚更新到1.7.1，修正了1.7.0的诸多问题，继续学习前建议你更新到此版本。
  
  结合使用Ogre1.7+CEGUI0.7，需要注意的问题：
  1、你可能还在学习官方的Ogre1.4版本的教程，你会发现MouseMotionListener、MouseListener这些由Ogre自己实现的输入设备功能类早已被取消掉，原1.4版本的InputReader已由InputManager替代，键/鼠/手柄设备的输入功能可以由OIS来实现（这并非唯一途径，但，是官方极力推荐的），创建设备对象可以通过

mKeyboard = static_cast<OIS::Keyboard*>(mInputManager->createInputObject(OIS::OISKeyboard, true));
mMouse = static_cast<OIS::Mouse*>(mInputManager->createInputObject(OIS::OISMouse, true));
mJoy = static_cast<OIS::JoyStick*>(mInputManager->createInputObject(OIS::OISJoyStick, true));

• 使用CEGUI时，还需通过System向CEGUI注入OIS事件对象，如：

CEGUI::System::getSingleton().injectMouseButtonDown(convertOgreButtonToCegui(id));

• 2、CEGUI0.7版本之前的Ogre渲染器CEGUI::OgreCEGUIRenderer已由CEGUI::OgreRender替代，并且创建Renderer和System的步骤已经被简化，原来的

mGUIRenderer = new CEGUI::OgreCEGUIRenderer(mWindow, Ogre::RENDER_QUEUE_OVERLAY, false, 3000,mSceneMgr);
mGUISystem = new CEGUI::System(mGUIRenderer);

• 现在可以简化为：

mGUIRenderer=&CEGUI::OgreRenderer::bootstrapSystem();

• 下面对于基础教程六的代码进行新版改造：
  下面的场景中创建了一个简单的天空穹，用CEGUI绘制了一个按钮，点击按钮OK后退出应用程序
  注意：为了能让Ogre找到CEGUI的相关素材资源，你需要将Ogre的resource.cfg资源文件中的CEGUI资源文件路径做相关添加
  全部代码如下：

 #include <CEGUIImageset.h>#include <CEGUISystem.h>#include <CEGUILogger.h>#include <CEGUISchemeManager.h>#include <CEGUIWindowManager.h>#include <CEGUIWindow.h>#include <elements/CEGUIPushButton.h>#include <RendererModules/Ogre/CEGUIOgreRenderer.h>#include <RendererModules/Ogre/CEGUIOgreResourceProvider.h>#include <RendererModules/Ogre/CEGUIOgreGeometryBuffer.h>//regular mem handler#include "ExampleApplication.h"CEGUI::MouseButton convertOgreButtonToCegui(int buttonID){switch (buttonID){case OIS::MB_Left:return CEGUI::LeftButton;case OIS::MB_Right:return CEGUI::RightButton;case OIS::MB_Middle:return CEGUI::MiddleButton;default:return CEGUI::LeftButton;}}class GuiFrameListener:public ExampleFrameListener,public OIS::MouseListener,public OIS::KeyListener{private:CEGUI::Renderer *mGUIRenderer;bool mShoutdownRequested;public:GuiFrameListener(RenderWindow* win,Camera* cam,CEGUI::Renderer* renderer):ExampleFrameListener(win,cam,true,true),mGUIRenderer(renderer),mShoutdownRequested(false){mMouse->setEventCallback(this);mKeyboard->setEventCallback(this);CEGUI::WindowManager* wmgr=CEGUI::WindowManager::getSingletonPtr();CEGUI::Window* quitBtn=wmgr->getWindow((CEGUI::utf8*)"Quit");quitBtn->subscribeEvent(CEGUI::PushButton::EventClicked,CEGUI::Event::Subscriber(&GuiFrameListener::quit,this));}void requestShoutdown(){mShoutdownRequested=true;}bool quit(const CEGUI::EventArgs &evt){mShoutdownRequested=true;return true;}bool frameStarted(const FrameEvent& evt){if(mMouse)mMouse->capture();if(mKeyboard) mKeyboard->capture();return ExampleFrameListener::frameStarted(evt);}bool frameEnded(const FrameEvent& evt){if(mShoutdownRequested)return false;elsereturn ExampleFrameListener::frameEnded(evt);}bool mouseMoved(const OIS::MouseEvent &evt){CEGUI::System::getSingleton().injectMouseMove(evt.state.X.rel,evt.state.Y.rel);return true;}bool mousePressed(const OIS::MouseEvent &evt, OIS::MouseButtonID id) {CEGUI::System::getSingleton().injectMouseButtonDown(convertOgreButtonToCegui(id));return true;}bool mouseReleased(const OIS::MouseEvent &evt, OIS::MouseButtonID id ){CEGUI::System::getSingleton().injectMouseButtonUp(convertOgreButtonToCegui(id));return true;}bool keyPressed(const OIS::KeyEvent &evt ){if(evt.key==OIS::KC_ESCAPE){mShoutdownRequested=true;return true;}CEGUI::System::getSingleton().injectKeyDown(evt.key);CEGUI::System::getSingleton().injectChar(evt.text);return true;}bool keyReleased(const OIS::KeyEvent &evt ){CEGUI::System::getSingleton().injectKeyUp(evt.key);return true;}
};
class TutorialApplication:public ExampleApplication
{
public:CEGUI::OgreRenderer* mGUIRenderer;CEGUI::Window* mEditorGuiSheet;public:TutorialApplication():mGUIRenderer(NULL),mEditorGuiSheet(NULL){}~TutorialApplication(){/**//*if(mEditorGuiSheet){CEGUI::WindowManager::getSingleton().destroyWindow(mEditorGuiSheet);}*/}protected:void createScene(void){mGUIRenderer=&CEGUI::OgreRenderer::bootstrapSystem();//设置日志//Ogre::Log::setLogDetail(Ogre::LoggingLevel::LL_NORMAL);CEGUI::Logger::getSingleton().setLoggingLevel(CEGUI::LoggingLevel::Informative);CEGUI::SchemeManager::getSingleton().create("TaharezLook.scheme");CEGUI::System::getSingleton().setDefaultMouseCursor("TaharezLook", "MouseArrow");CEGUI::MouseCursor::getSingleton().setImage("TaharezLook","MouseMoveCursor");CEGUI::System::getSingleton().setDefaultFont("DejaVuSans-10");mEditorGuiSheet=(CEGUI::Window*)CEGUI::WindowManager::getSingleton().createWindow("DefaultWindow","Sheet");CEGUI::System::getSingleton().setGUISheet(mEditorGuiSheet);CEGUI::PushButton* quitBtn=(CEGUI::PushButton*)CEGUI::WindowManager::getSingleton().createWindow("TaharezLook/Button",(CEGUI::utf8*)"Quit");quitBtn->setPosition(CEGUI::UVector2(cegui_reldim(.35f), cegui_reldim(.45f)));quitBtn->setSize(CEGUI::UVector2(cegui_reldim(.15f), cegui_reldim(.05f)));quitBtn->setText((CEGUI::utf8*)"OK");mEditorGuiSheet->addChildWindow(quitBtn);/**//*mEditorGuiSheet = CEGUI::WindowManager::getSingleton().loadWindowLayout((CEGUI::utf8*)"Tutorial Gui.xml");CEGUI::System::getSingleton().setGUISheet(mEditorGuiSheet);CEGUI::PushButton* quitButton=(CEGUI::PushButton*)CEGUI::WindowManager::getSingleton().getWindow((CEGUI::utf8*)"Quit");*/mSceneMgr->setAmbientLight(ColourValue(1, 1, 1));mSceneMgr->setSkyDome(true, "Examples/CloudySky", 5, 8);}void createFrameListener(void){mFrameListener = new GuiFrameListener(mWindow, mCamera, mGUIRenderer);mRoot->addFrameListener(mFrameListener);}
};#if OGRE_PLATFORM == OGRE_PLATFORM_WIN32
#define WIN32_LEAN_AND_MEAN
#include "windows.h"
INT WINAPI WinMain( HINSTANCE hInst, HINSTANCE, LPSTR strCmdLine, INT )
#else
int main(int argc, char **argv)
#endif
{// Create application objectTutorialApplication app;try {app.go();} catch( Exception& e ) {
#if OGRE_PLATFORM == OGRE_PLATFORM_WIN32 MessageBox( NULL, e.getFullDescription().c_str(), "An exception has occured!", MB_OK | MB_ICONERROR | MB_TASKMODAL);
#elsefprintf(stderr, "An exception has occured: %s\n",e.getFullDescription().c_str());
#endif}return 0;
}

• 运行效果图如下：
  
  
  把这个例子跑通基础教程后面的部分就会很顺利了