使用 cegui 来制作界面 , 不论在何种平台下 , 有基本的三大步骤要做 :
1, 创建一个 CEGUI::Render 实例
2, 创建 CEGUI::System 对象
3, 调用各种方法来渲染用户界面
第一步 , 在我使用的 ogre 环境下使用以下代码来创建 CEGUI::Render 实例
Ogre3D
CEGUI::OgreCEGUIRenderer* myRenderer =
       new CEGUI::OgreCEGUIRenderer(myRenderWindow);
第二步相当简单 , 可使用
new CEGUI::System(myRenderer);
第三步,基本上来讲,大部分平台下,如 direct3D, OpenGL, 我们在渲染循环的尾部调用
CEGUI::System::renderGUI 来开始界面的渲染。如果我们使用 ogre3d 引擎,这一步不需要
我们显示的执行。因为 ogre 引擎已经考虑了。
除了这三大步之外,我们还有一些工作要做,首先,我们需要加载数据文件,并且完成初始化工作。
CEGUI 使用了许多类型的文件。 CEGUI 使用一个称为 ResourceProvider 的帮助对象,用它来做为核心 CEGUI 库与外部文件加载系统的接口。通过实现一个特定的 ResourceProvider 对象, cegui 的渲染模块就可以与外部系统的资源管理器、文件加载子系统无缝地集成。 CEGUI 需要的数据文件便可以通过外部系统提供的功能来进行加载。 CEGUI 中的大部分文件是以 XML 的文件格式来保存的。缺省情况下, CEGUI 在内部使用 Xerces-C++ 库来分析 XML 文件,使用 schema 来对 xml 进行校验, schema 文件以标准的 .xsd 扩展名来保存 . 许多文件本质上都是 XML 格式的文件,但是根据其意义不同,分别使用了不同的文件扩展名。
.Imageset 文件可将一幅图像看做若干小图像的集合。换名话说,就是将一幅图像的某个区域看做一幅独立的图片来使用。
.Font 定义了在 CEGUI 中所使用的字体类型。
.scheme  可以将许多数据组合在一起使用,它也是装载与注册 widget 最方便的方法。在一个 .scheme 文件中可以包括下列几种数据:
Imagest,font, window Set, window Alias
window set 指定了装载模块( .dll 等)的名称,和一组可以注册到系统中的 widget.
window alias 提供了别名的功能,实现已经注册的 window/widget 的形式上的隐藏。
.Layout  包含了窗口布局的 xml 表示。每个嵌套的 'window' 元素定义了被创建的 window 或是 widget."Property" 元素定义了窗口的设置与属性值。
.config 是可供选择的配置文件,他可指定一些缺省的属性。
我们使用 CEGUI 来制作图形界面,至少要使用以下三种文件:
.imageset, .Font . Scheme;
当然,我们知道在一个 Scheme 中是可以包括 imageset 与 Font 的。
CEGUI::SchemeManager::getSingleton().loadScheme(“../datafiles/schemes/TaharezLook.scheme”);
// load in a font.  The first font loaded automatically becomes the default font.
CEGUI::FontManager::getSingleton().createFont(“../datafiles/fonts/Commonwealth-10.font”);
对于 ogre 的使用者来讲,应该在 resources.cfg 将这些资源所在的目录加进去。
我们可用下面的语句来指定 cegui 所需要的缺省的 font 与 cursor 资源。
在 cegui 的概念里,每个 widget 都是一个 window, 从编程的角度来讲,每个 widget 类都是从同一个相同的 window 基类继承而来的 . 因此, widget 与 window 有着基本相同的行为。
窗体的许多属性与设置在窗口层树上是可以遗传的。高一级窗口的属性与行为会影响到下一级窗口的属性与行为。例如附着在某个 window 上的 window 与 widget 会被父 window 影响。当父窗口被 destroy 时,它所附属的所有的子窗口与 widget 也都将被 destroy.
创建 CEGUI 窗口,我们可以使用两种形式,一是 C ++代码,二是编辑 XML layout 文件。
注意:在 CEGUI 中,所有的 window 都是由 WindowManager singleton object 来统一创建的。我们首先得到这个对象:
using namespace CEGUI;
WindowManager& wmgr = WindowManager::getSingleton();
一般来讲,我们总是创建一个 DefaultWindow 来做为我们将使用的窗口的 Root, 在这种方式下,我们会有比较好的灵活性。
Window* myRoot = wmgr.createWindow(“DefaultWindow”, “root”);
System::getSingleton().setGUISheet(myRoot);
createwindows() 函数所使用的第一个参数,指明了将要创建的窗口类型,它一般是在我们使用的 .scheme 文件中所注册过的,当然还有一些系统定义的,总是有效的窗口类型如上面所提到的 DefaultWindow.DefualtWindow 是不可见的,它只是做为所有窗口的 root 来使用。
一般我们总是要创建一个 Framewindow, 它可以包括其他窗口与 widget ,本身也是可视的。
FrameWindow* fWnd = (FrameWindow*)wmgr.createWindow(“TaharezLook/FrameWindow”, “testWindow”);
之后,我们将创建的窗口挂到 root 上,形成一个层次关系。
myRoot->addChildWindow(fWnd);
编辑 xml layout 文件,可使用专门提供的制作工具。具体的使用方法可以参阅相关文档,这里说一下如何使用制作好的 xml layout 文件。
using namespace CEGUI;
Window* myRoot = WindowManager::getSingleton().loadWindowLayout(“test.layout”);
System::getSingleton().setGUISheet(myRoot);
首先,将 layout 文件装载进来,再指定根结点。
CEGUI 本身侦测用户输入,这些不是 CEGUI 的责任,而是程序的员的责任。当有用户外部输入时,我
们可以选择将这些消息告知 CEGUI ,这样 CEGUI 才会响应。
在 ceguir::System 类中定义了一组函数,它作为我们进行消息传递的接口。
bool injectMouseMove(float delta_x, float delta_y);
bool injectMousePosition(float x_pos, float y_pos);
bool injectMouseLeaves(void);
bool injectMouseButtonDown(MouseButton button);
bool injectMouseButtonUp(MouseButton button);
bool injectKeyDown(uint key_code);
bool injectKeyUp(uint key_code);
bool injectChar(utf32 code_point);
bool injectMouseWheelChange(float delta);
bool injectTimePulse(float timeElapsed);
这些函数的返回值说明了 CEGUI 是否已经将传入的消息 consume 掉了。
CEGUI 使用回调机制来进行消息处理。可以为某个窗体的特定事件注册一个函数,当窗体事件发生时, CEGUI 会自动调用所注册的函数。
bool TutorialApplication::handlePopMenu(constCEGUI::EventArgs& e)

// 。。。。。进行事件响应

void setupEventHandlers(void)
    {
       CEGUI::WindowManager& wmgr = CEGUI::WindowManager::getSingleton();
       wmgr .getWindow((CEGUI::utf8*)"MyButton")->subscribeEvent(
       CEGUI ::PushButton::EventClicked, CEGUI::Event::Subscriber(&TutorialApplication::handlePopMenu, this));
   }

EventClicked :: 系统预定义的事件 . subscribeEvent:: 注册函数,它事件与响应函数联接在一起。
在 ogre 程序中,当侦听器收到键盘,鼠标消息时,首先经过适当的转换( CEGUI 可以识别)再传递给 CEGUI 。下面这个函数执行鼠标键标识转换。
CEGUI::MouseButton convertOgreButtonToCegui(int buttonID)
{
       switch (buttonID)
       {
       case MouseEvent::BUTTON0_MASK:
              return CEGUI::LeftButton;
       case MouseEvent::BUTTON1_MASK:
              return CEGUI::RightButton;
       case MouseEvent::BUTTON2_MASK:
              return CEGUI::MiddleButton;
       case MouseEvent::BUTTON3_MASK:
              return CEGUI::X1Button;
       default:
              return CEGUI::LeftButton;
       }
}

将 CEGUI 需要知道的键盘,鼠标消息告知它。即在 OGRE 处理这些消息时通知 CEGUI 。以下这函数说明了用法。
       void mouseMoved (MouseEvent *e)// 鼠标移动
       {
              CEGUI::System::getSingleton().injectMouseMove(
                   e->getRelX() * mGUIRenderer->getWidth(),
                   e->getRelY() * mGUIRenderer->getHeight());
                   e->consume();
       }

       void mousePressed (MouseEvent *e)// 鼠标按下
       {
              CEGUI::System::getSingleton().injectMouseButtonDown(
               convertOgreButtonToCegui(e->getButtonID()));
             e->consume();
       }
       void mouseReleased (MouseEvent *e)// 鼠标弹起
       {
              CEGUI::System::getSingleton().injectMouseButtonUp(
              convertOgreButtonToCegui(e->getButtonID()));
              e->consume();
       }

       void keyPressed(KeyEvent* e)// 键按下
       {
              CEGUI::System::getSingleton().injectKeyDown(e->getKey());
              CEGUI::System::getSingleton().injectChar(e->getKeyChar());
              e->consume();
       }
       void keyReleased(KeyEvent* e)// 键弹起
       {
             CEGUI::System::getSingleton().injectKeyUp(e->getKey());
             e->consume();

       }
在 CEGUI 中使用中文的问题:   现在总结了一下在 CEGUI 中显示中文需要注意的事项 :
    1 、将 simhei.ttf copy to \ogrenew\Samples\Media\gui
    2 、将 simhei-12.font  拷到上目录内容为
<?xml version="1.0"  ?>
<Font Name="SimHei-12" Filename="simhei.ttf" Type="Dynamic" Size="12" NativeHorzRes="800" NativeVertRes="600" 
AutoScaled="true">
<GlyphSet Glyphs=" 你好世界退出演示渲染到新材质建编辑窗口 " /> ( <---- 自己要用到的汉字)
</Font>
注意大小写!! GlyphSet Glyphs 是在程序中要用到的汉字,它是让 cegui 预生成一个字符图像集用的(想当然的 :-P )如果修改了这个文件,注意要用 Unicode ( UTF-8 )的编码来保存,在 vc7.1 中:文件 -> 高级保存选项   的   编码   栏中选择。
    3 、在 TaharezLook.scheme 中
     <Font Name="Tahoma-12" Filename="tahoma-12.font" /> 后加入
     <Font Name="SimHei-12" Filename="simhei-12.font" />  注意大小写
     以上是一些准备工作
    4 、在自己的应用中设置默认字体
    mGUISystem->setDefaultFont((CEGUI::utf8*)"Tahoma-12"); 改为
    mGUISystem->setDefaultFont((CEGUI::utf8*)"SimHei-12");
    5 、在自己的应用程序中就可以把相关的 Text 属性该为中文了,如:
    item = new CEGUI::ListboxTextItem((CEGUI::utf8*)" 退出 ", 6);
    同样要注意的是要保存为 Unicode ( UTF-8 )的编码。同时这些字要是在 simhei-12.font 中定义过的字,当然也可以象那个 CEGUIChieseDemo
那样用动态生成如:
    gfont->defineFontGlyphs(gfont->getAvailableGlyphs() + (utf8*)" 当前最佳坏平均的框架率三角 ");
    编译自己的程序,应该就可以看到中文了,罗嗦一下,记住只要有汉字出现的文件就保存为 Unicode ( UTF-8 )编码的!!!

 

posted on 2006-11-01 15:32 清源游民 阅读(5240) 评论(5)  编辑 收藏 引用 所属分类: OGRE

FeedBack:
# re: 在OGRE中使用CEGUI的笔记
2007-02-28 15:53 | pathbreaker
在Ogre中使用最新的CEGUI需要包含那些文件?  回复  更多评论
  
# re: 在OGRE中使用CEGUI的笔记
2007-03-01 21:58 | 清源游民
@pathbreaker
CEGUI更新到了0.5.1,我在学习,随便把笔记放上来,你可以看看。
  回复  更多评论
  
# re: 在OGRE中使用CEGUI的笔记
2007-07-30 21:04 | freezing
正在学习CEGUI,你的笔记正好借鉴,呵呵  回复  更多评论
  
# re: 在OGRE中使用CEGUI的笔记
2007-10-16 23:09 | yifan
ogre中实现倒影的那个例子demo_fresnel 想其中加入cegui 实现鼠标菜单控制 结果导致水面倒影不见了 有谁知道是怎么回事吗 初学 好多问题还不太懂 希望得到高手指点 谢谢!!!  回复  更多评论
  
# re: 在OGRE中使用CEGUI的笔记[未登录]
2008-01-11 18:00 | zz
gou si  回复  更多评论
  

只有注册用户登录后才能发表评论。
网站导航: 博客园   IT新闻   BlogJava   知识库   博问   管理


<2006年11月>
2930311234
567891011
12131415161718
19202122232425
262728293012
3456789

留言簿(35)

随笔分类(78)

随笔档案(74)

文章档案(5)

搜索

  •  

最新评论

阅读排行榜

评论排行榜