-
这篇文章是对于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;
else
return 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 object
TutorialApplication 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);
#else
fprintf(stderr, "An exception has occured: %s\n",e.getFullDescription().c_str());
#endif
}
return 0;
}
-
运行效果图如下:
把这个例子跑通基础教程后面的部分就会很顺利了