我喜欢看张国荣的《东邪西毒》
讨论对象:CEGUI 0.7.1
1.从源代码开始
下完cegui 0.7.1 解压到当前文件夹 得到一个CEGUI-0.7.1文件夹 下载deps 解压到该目录下 形成类似
./CEGUI-0.7.1
./CEGUI-0.7.1/dependencies
./CEGUI-0.7.1/bin
的目录结构 转到./CEGUI-0.7.1/projects/premake/
里面有许多版本的VS 我的版本是VS 2008的 在运行build_vs2008.bat之前 打开config.lua
该文件定制cegui的各个模块 来看下我的:
--
-- CEGUI premake configuration script
--

-- comment this to disable debug suffixes for dynamic module dlls
-- if you want to use another suffix, just change the string :)
-- all the debug cegui libraries are built with this suffix
DEBUG_DLL_SUFFIX 
= "_d"

-- SDK / dependency paths
-- { base, include_suffix, library_suffix }
-- base can be absolute or relative to the root cegui_mk2 dir
IRRLICHT_PATHS 
= { "irrlicht-1.4""include""lib/Win32-visualstudio" }
OGRE_PATHS 
= { "D:/wildpigdev/ogre/ogre_src_v1-7-1/vc9/sdk""include/OGRE""lib" }
OIS_PATHS 
= { "D:/wildpigdev/ogre/ogre_src_v1-7-1/vc9/sdk""include/OIS""lib" }

--- Irrlicht SDK Version
--- 14 is means 1.4 or 1.5.x and 16 means 1.6 (and above?)
CEGUI_IRR_SDK_VERSION 
= 14

--- OIS API version to be used in the Ogre samples base app.
--- true: use older numKeyboards / numMice
--- false: use getNumberOfDevices
CEGUI_OLD_OIS_API 
= false

--- Lua version
--- 51 is 5.1 (and above?) From 0.7.0 onwards, lua 5.0 is no longer supported.
CEGUI_LUA_VER 
= 51

--- Freetype library
--- CEGUI uses the freetype library for some of it's font support.  To disable
--- the use of freetype, set this to false.
CEGUI_USE_FREETYPE 
= true

--- PCRE library
--- CEGUI uses the pcre library for it's regular expression based string
--- validation as used in the Editbox (and derived classes, such as Spinner).
--- To disable the use of PCRE (and therefore the validation factilities), set
--- this to false.  (Attempts to set validation string will throw).
CEGUI_USE_PCRE_REGEX 
= true

--- CEGUI::DefaultLogger
--- To disable compilation and use of the CEGUI::DefaultLogger, set this to
--- false.
---
--- Note: If you disable this, you MUST provide an alternative CEGUI::Logger
--- based class and instantiate it before creating the main CEGUI::System object.
CEGUI_USE_DEFAULT_LOGGER 
= true

--- BiDirectional text support.
--- To enable support for bi-directional text in CEGUI, set CEGUI_BIDI_SUPPORT
--- to true.
--- With bidirectional support enabled, CEGUI_USE_MINIBIDI then controls whether
--- that support is provided viaan embedded copy of minibidi (true) or an
--- external copy of the fribidi library (false).
CEGUI_BIDI_SUPPORT 
= false;
CEGUI_USE_MINIBIDI 
= true;

-------------
-- Renderers
-- this controls which renderer modules are built
OPENGL_RENDERER 
= false
DIRECT3D9_RENDERER 
= false
DIRECT3D10_RENDERER 
= false
IRRLICHT_RENDERER 
= false
OGRE_RENDERER 
= true

----------------
-- Image Codecs
-- this controls which image codecs are built
TGA_IMAGE_CODEC 
= false
SILLY_IMAGE_CODEC 
= false
DEVIL_IMAGE_CODEC 
= false
FREEIMAGE_IMAGE_CODEC 
= true
CORONA_IMAGE_CODEC 
= false

-- this setting selects the default image codec module
-- can be either "tga""silly""devil""freeimage" or "corona"
-- SILLY was written for CEGUI
DEFAULT_IMAGE_CODEC 
= "freeimage"

---------------
-- Window Renderers
-- controls window renderers built
FALAGARD_WR 
= true

-- default WR
-- available: falagard
DEFAULT_WINDOW_RENDERER 
= "falagard"




---------------
-- XML parsers
-- this controls which xml parser modules are built
EXPAT_PARSER 
= true
XERCES_PARSER 
= false
TINYXML_PARSER 
= false
LIBXML_PARSER 
= false

-- this selects the default XML parser module
-- can be either "expat""xerces""tinyxml" or "libxml"
DEFAULT_XML_PARSER 
= "expat"


-------
-- Lua
-- this controls whether CEGUILua is enabled
LUA_SCRIPT_MODULE 
= true

-- disable this for a smaller and faster, but less safe Lua module
-- only affects Release builds. Debug and ReleaseWithSymbols always
-- enable this
LUA_SCRIPT_MODULE_SAFE 
= false

-- enable this to build the bundled tolua++ as a static library
TOLUA_STATIC 
= false


-----------
-- Samples
-- remember you have to edit CEGUISamplesConfig.h as well this just controls
-- dependencies etc. if the renderer is disabled this has no effect
SAMPLES_GL 
= false
SAMPLES_DX9 
= false
SAMPLES_DX10 
= false
SAMPLES_IRRLICHT 
= false
SAMPLES_OGRE 
= true

-- this setting controls if the samples should be included in the same
-- solution as the core libraries. If this setting is disabled you can
-- still generate a seperate solution for the samples
--
-- due to a missing feature in premake enabling this will cause the
-- output files to be placed in cegui_mk2/bin and not cegui_mk2/Samples/bin
--
SAMPLES_INCLUDED 
= true

我是用ogre来渲染的 需要注意的是OGRE_PATHS OIS_PATHS 该路径自己选择 其他的都可根据个人需求定制 比如ImageCodec
定制完该lua脚本后 生成对应的VS版本 编译下 一般没啥问题 然后 可以看看自带的ogre的gui例子
说说初始化 在这个版本中相当简单 一行代码搞定
// 初始化
CEGUI::OgreRenderer::bootstrapSystem();
// 创建gui
CEGUI::SchemeManager::getSingleton().create("TaharezLook.scheme");
CEGUI::WindowManager& winMgr = CEGUI::WindowManager::getSingleton();
CEGUI::Window* root= winMgr.loadWindowLayout("yezhu.layout");
CEGUI::System::getSingleton().setGUISheet(root);
CEGUI::System::getSingletonPtr()->setDefaultMouseCursor((CEGUI::utf8*)"TaharezLook", (CEGUI::utf8*)"MouseArrow");
如果想知道更多 可以看其源代码
如果要定制窗口 需要看看TaharezLook.scheme这个文件 这是个xml文件 里面放着Imageset定义
Font定义 LookNFeel定义 了解这些新名词是定制窗口的关键 事情可以这样理解
LookNFeel文件在这里起着关键因素 我们生成的gui窗口的外貌和这个文件是息息相关的
打开这个LookNFeel文件 我们可以看到各种窗口的外观定义 如果我们要定制外观
修改现有的或者增加新的外观定义 特别感兴趣的可以 看看《火炬之光》里面的gui
迅雷单机游戏里有下的 玩起来还行。。。 ogre+cegui做的 可以打开她的gui文件看看

2.定制窗口
好 接下来 我们要定制窗口了 假如我们现在需要个性点的窗口 假如叫她MyButton 继承自CEGUI::PushButton
#ifndef MYBUTTON_H
#define MYBUTTON_H
#include 
<CEGUI.h>

namespace CEGUI
{
    
class MyButton : public PushButton
    {

    
public:
        MyButton(
const String &type, const String &name);
        
virtual ~MyButton();
        
static const String WidgetTypeName;//工厂名
   };
}
#endif
需要注意的是WidgetTypeName 我们在创建窗口的时候最终会通过该名字来找到相应的工厂
 每一个窗口都有相应的工厂用来创建自己
如果你查看cegui的初始化代码 你会看到一些类似以下的代码:
WindowFactoryManager::addFactory< TplWindowFactory<GUISheet> >();
WindowFactoryManager::addFactory
< TplWindowFactory<DragContainer> >()
WindowFactoryManager::addFactory
< TplWindowFactory<ScrolledContainer> >();
WindowFactoryManager::addFactory
< TplWindowFactory<ClippedContainer> >();
WindowFactoryManager::addFactory
< TplWindowFactory<Checkbox> >();
WindowFactoryManager::addFactory
< TplWindowFactory<PushButton> >();
WindowFactoryManager::addFactory
< TplWindowFactory<RadioButton> >();
WindowFactoryManager::addFactory
< TplWindowFactory<Combobox> >();
所以 现在 我们要做的也是加入MyButton对应的工厂 不错 正如你所看到的 一行代码搞定
WindowFactoryManager::addFactory< TplWindowFactory<MyButton> >()
注意的是 很显然 该行代码要在我们使用该窗口之前调用
接下来 看看MyButton的实现文件
#include "MyButton.h"

namespace CEGUI
{
    // 工厂名 通过该名字找到对应工厂
    
const String MyButton::WidgetTypeName("Custom/MyButton");
    MyButton::MyButton(
const String &type, const String &name) :PushButton(type, name)
    {
    }
    MyButton::
~MyButton()
    {
    }
}
没啥特别的地方 你可以放置任何其他数据 好 目前为止 我们新建了一个窗口类 并把对应的工厂加入系统
回过头看TaharezLook.scheme文件 我们可以看到里面有许多类似这样的元素:
<FalagardMapping WindowType="TaharezLook/Button" TargetType="CEGUI/PushButton" Renderer="Falagard/Button" LookNFeel="TaharezLook/Button"/>
<FalagardMapping WindowType="TaharezLook/Checkbox" TargetType="CEGUI/Checkbox" Renderer="Falagard/ToggleButton" LookNFeel="TaharezLook/Checkbox"/>
<FalagardMapping WindowType="TaharezLook/ImageButton" TargetType="CEGUI/PushButton" Renderer="Falagard/Button" LookNFeel="TaharezLook/ImageButton"/>
<FalagardMapping WindowType="TaharezLook/Titlebar" TargetType="CEGUI/Titlebar" Renderer="Falagard/Titlebar" LookNFeel="TaharezLook/Titlebar"/>
<FalagardMapping WindowType="TaharezLook/SystemButton" TargetType="CEGUI/PushButton" Renderer="Falagard/Button" LookNFeel="TaharezLook/Button"/>
<FalagardMapping WindowType="TaharezLook/Editbox" TargetType="CEGUI/Editbox" Renderer="Falagard/Editbox" LookNFeel="TaharezLook/Editbox"/>
<FalagardMapping WindowType="TaharezLook/Menubar" TargetType="CEGUI/Menubar" Renderer="Falagard/Menubar" LookNFeel="TaharezLook/Menubar"/>
WindowType是我们在创建窗口时用到的名字 当然 我们也可以直接用后面的TargetType
该名字就是对应的工厂名 Render不用去管她 相当于如何渲染
LookNFeel是重点 在对应的LookNFeel文件中我们可以找到该名字对应的定义
就是这些定义使得我们的窗口会呈现各种外观 所以下面的工作就是写LookNFeel定义
并通过程序加入如上的映射
好 关于如何写LookNFeel定义 好吧 这是另外一个主题了 在这里
我们假设在外观文件中新增一个外观定义“CustomLook/MyButton”
现在 我们要加入一个映射:
CEGUI::WindowFactoryManager& wfMgr = CEGUI::WindowFactoryManager::getSingleton();
wfMgr.addFalagardWindowMapping(
"TaharezLook/MyButton""Custom/MyButton""CustomLook/MyButton""Falagard/Button");
映射函数参数依次是 映射名 工厂名 外观定义名 Render名
好了 现在你就可以使用这个新窗口了
CEGUI::WindowManager * m_WndMgr = CEGUI::WindowManager::getSingletonPtr();
m_WndMgr->createWindow("TaharezLook/MyButton","mytestwindow");
createWindow会从对应映射中找到工厂创建窗口
基本就是这样 over~

PS:
另外 当我们只需要改变某个窗口的lookNFeel定义时
调用void Window::setLookNFeel(const String& look)
可以在运行时改变窗口的lookNFeel定义

posted on 2010-06-29 13:59 野猪红 阅读(1505) 评论(0)  编辑 收藏 引用 所属分类: CEGUI

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