CEGUI说明文档.doc

一 CEGUI sdk概述主要功能：提供一些用户界面的组件，如按钮，列表框，文本框，滚动条等。组件的创建：所有的组件都是由名字空间CEGUI中WindowManager类的一个实例通过成员函数creatWindow（const CEGUI:String &type，const CEGUI:String &name=” “）来创建。格式如下：Slider* slider = static_cast(winMgr.createWindow(TaharezLook/Slider, my slider)其中Slider为组件类型，winMgr为WindowManager类的实例。字符串TaharezLook/Slider是创建组件的风格，my slider是组件的名字，名字不能重复。组件通过自己的成员函数设置自己的属性以及事件响应等。组件的组合方式：各种组件是以树形结构组合在一起的。组件通过各自的成员函数addChildWindow()来添加自己的子组件。例如主窗口子窗口按钮滚动条文本筐滑块子组件可以设置在父组件中的位置，大小等。组件的显示：1通过CEGuiRendererSelector* d_rendererSelector选择使用gui渲染类型，如D8、D9之类。 2根据选择的渲染类型，创建CEGuiBaseApplication* d_sampleApp的应用实例，实例会在初始化的时候进行D3D初始化、D3Dinput初始化、窗口初始化等操作。3进入组件渲染，处理windows消息和输入消息的循环。 二 CEGUI对xml文档的解析过程CEGUI中负责对xml文档解析并加载的类是CEGUI:XMLParser，他是一个基类，主要的成员函数都需要由子类来实现。这个类的所有成员如下：XMLParser(void)XMLParser(void) virtualcleanup(void)在使用之后清除XMLParser模型，调用虚函数cleanupImpl(void)=0。cleanupImpl(void)=0 protected, pure virtual由继承的子类来实现，在TinyXMLParser类的实现中并未进行任何操作，没用。d_identifierString protectedXml解析模型的标识字符串，在实现CEGUI:XMLParser的类中对他进行赋值，例如在TinyXMLParser类中就是这样一个字符串CEGUI:TinyXMLParser - Official tinyXML based parser module for CEGUIgetIdentifierString() const 公有接口，获得当前使用的xml解析模型的标识，可以知道现在用的是哪个解析模型。返回一个String类的字符串。initialise(void)公有接口，返回一个bool值来确定解析模型是否已经初始化，可用。initialiseImpl(void)=0 protected, pure virtualInitialise()的实现，返回true，这个函数被实现即说明有解析模型可以使用了。parseXMLFile(XMLHandler &handler, const String &filename, const String &schemaName, const String &resourceGroup)=0pure virtual公有接口，对xml文档进行解析，要由继承的子类来实现。接着将对parseXmlFile函数的一个重要参数handler进行解释。XMLHandler这个类和XMLParser有些类似，他的成员函数也是需要他的子类来实现的。他的作用就是持有一些类的实例的指针，在解析过程中，把解析得到的结果保存在实例的容器中。下面具体解释一下XMLHandler这个类除了构造函数和析构函数，还有两个 virtual void elementStart(const String& element, const XMLAttributes& attributes); virtual void elementEnd(const String& element);这两个函数会在parseXmlFile函数中被调用，element是解析器分析得到的元素名，attributes是解析器的属性控制，用来得到相应元素的属性值。XMLHandler类本身有四个函数的定义，但是都为空，需要他的子类来实现重载。保存结果所用实例的指针也是在子类中定义的，使用XMLHandler声明一个对象的时候作为构造的参数传递给他。这个实例的指针在解析之后将会被保存直到整个程序结束，实例中就是解析得到的结果。用CEGUI中读取scheme的例子来说明xml文档的读取过程（scheme就是xml结构的文档）。下面这一语句完成了TaharezLook.scheme的解析和结果保存，在CEGUI名字空间中，可以直接使用。SchemeManager:getSingleton().loadScheme(./datafiles/schemes/TaharezLook.scheme);其中SchemeManager类从Singleton类继承，我们有class CEGUIEXPORT SchemeManager : public SingletonSingleton是一个模板类，在被继承的同时被SchemeManager这个模板参数实例化。Singleton类中有一个静态的指针，在实例化的同时被指向了参数类。在SchemeManager的使用过程用中总是通过Singleton的成员函数getSingleton来得到他自己的指针。所以整个程序中一直就只有一个SchemeManager实例。以上这些保证了在调用loadScheme之后，解析得到的结果被保存在SchemeManager的某个成员容器中，并且之后还能随时访问。以下是loadScheme的执行过程（其中写日志的操作将被省去）l 使用用new Scheme (scheme_filename, resourceGroup);来创建Scheme对象。n 创建一个Scheme_xmlHandler handler(this)持有当前Scheme对象n 调用parseXMLFile来解析文档。u 使用TinyXMLParser解析得到元素u 使用handler的成员函数对解析到的元素进行识别保存等。l 根据元素的类型，把元素的属性保存在Scheme对象对应的容器中。n 调用loadResources(void)来分配解析得到资源。u 逐个扫描Scheme的各个容器。容器中元素分配到各种组件的Manager中分别保存。u Scheme中的元素的属性值其实是其余文件的路径。在分配的时候会由各种组件的Manager类进行再次读取解析。详细请看CEGUIScheme.cpp文件中的loadResources函数。l 把创建的Scheme对象保存在map d_schemes中。请参看Scheme的结构。ImagesetManagerFontManagerWindowFactoryManagerWidgetLookManagerWindowManager这些类与SchemeManager有类似的对xml文档进行读写的操作。他们读取的文档针对不同的类型。如图片，字体，窗口等。其中WindowManager是读取CELayout的类，他有一个成员函数loadWindowLayout用来读取界面，返回一个指向window的指针。关于layout的xml文档数据结构，请勿必看一下GUILayout.xsd和demolayout.xml，可以知道界面是如何用xml文档来表示的。(两个文档在CELayoutEditor这个软件的安装文件夹中)用WindowManager装入layout文档之后。即可创建文档中定义的界面窗口。界面的数据保存在WindowManager中。有关layout文档解析，参看CEGUIGUILayout_xmlHandler.cpp文件中的函数实现。 三 界面装载前面说的都是程序的运行过程。实际上使用界面的装载非常简单，用前面提到loadWindowLayout函数即可返回一个window的指针，把这个window加到现有的框架window上面即可。四中文字符使用std:wstring szWstring(L你好,世界! ); char *szUtf8String = NULL; int iLengthAnsiString = 0; iLengthAnsiString = WideCharToMultiByte(CP_UTF8, 0,szWstring.c_str(), szWstring.capacity(), NULL, 0, NULL, NULL); szUtf8String = new char iLengthAnsiString; memset(szUtf8String, 0, sizeof(char)*(iLengthAnsiString); WideCharToMultiByte(CP_UTF8, 0,szWstring.c_str(), szWstring.length(), szUtf8String, iLengthAnsiString, NULL, NULL); textwnd-setText(CEGUI:utf8*)szUtf8String); delete szUtf8String; szUtf8String = NULL;中文输入的使用。 SchemeManager:getSingleton().loadScheme(CEGUI:utf8*)./datafiles/schemes/123.scheme); System:getSingleton().setDefaultMouseCursor(CEGUI:utf8*)TaharezLook, (CEGUI:utf8*)MouseArrow);/ FontManager:getSingleton().createFont(./datafiles/fonts/Commonwealth-10.font);System:getSingleton().setDefaultFont(CEGUI:utf8*)songti ); CEGUI:Font* font = CEGUI:FontManager:getSingleton().getFont(CEGUI:utf8*)songti ); font-setAutoScalingEnabled(true); font-setNativeResolution(Size(800, 600); font-defineFontGlyphs(font-getAvailableGlyphs();具体设置请看123.scheme，songti.font文件。Listbox可以显示中文。关于demo8中listbox无法显示中文的问题，问题在demo8.lua文件。重写按钮push事件的响应可以解决。同时注销demo8.lua中的事件注册函数。（最新更新，问题在于，在lua实现gettext函数的时候，把得到的字符串从CEGUI:string转化成了char* 类型，导致了中文格式的不符。在后面创建item以及additem后无法显示）/Sample_Demo8.cpp/bool Demo8Sample:initialiseSample()/new System(renderer, scriptmod, (utf8*)./datafiles/configs/demo8.config);PushButton* btn=static_cast(WindowManager:getSingleton().getWindow(Demo8/Window1/Controls/Add);btn-subscribeEvent(PushButton:EventClicked,&pushButtonHandler);/bool pushButtonHandler(const CEGUI:EventArgs& e) using namespace CEGUI;Editbox* ebox=static_cast(WindowManager:getSingleton().getWindow(Demo8/Window1/Controls/Editbox);Listbox* lbox=static_cast(WindowManager:getSingleton().getWindow(Demo8/Window1/Listbox);CEGUI:String str=ebox-getText();str+=sing;lbox-addItem(new MyListItem(str);return true;从CEGUI:string的c_str()函数得到的const char*字符串英文可以直接给std:string使用。中文只能用(utf8*)转换后给CEGUI:string使用。使用下面的方法将CEGUI中的中文字符串转换为STD的宽字符串str为CEGUI中的中文字符串（更新，std宽字符串和CEGUI的中文字符串编码一样，采用直接拷贝）std:wstring szWstring; const char *szUtf8String = str.c_str(); int iLengthAnsiString = MultiByteToWideChar( CP_UTF8, 0,szUtf8String,strlen(szUtf8String), NULL, 0);wchar_t* wszUnicode=new wchar_tiLengthAnsiString+1;MultiByteToWideChar(CP_UTF8, 0, szUtf8String, iLengthAnsiString,wszUnicode, iLengthAnsiString); wszUnicodeiLengthAnsiString=0;szWstring=wszUnicode;使用下面方法将char *字符串转换为CEGUI可用的字符串int iLengthUniString = MultiByteToWideChar(CP_THREAD_ACP, 0,g_szCompStr, strlen(g_szCompStr), NULL, 0); wchar_t* wszUnicode=new wchar_tiLengthUniString+1;MultiByteToWideChar(CP_THREAD_ACP, 0, g_szCompStr,strlen(g_szCompStr),wszUnicode, iLengthUniString); wszUnicodeiLengthUniString=0;int iLengthAnsiString = WideCharToMultiByte(CP_UTF8, 0,wszUnicode,iLengthUniString+1, NULL, 0, NULL, NULL); char * szUtf8String = new char iLengthAnsiString; memset(szUtf8String, 0, sizeof(char)*(iLengthAnsiString); WideCharToMultiByte(CP_UTF8, 0,wszUnicode, iLengthUniString+1, szUtf8String, iLengthAnsiString, NULL, NULL); imereading-setText(CEGUI:utf8*)szUtf8String); delete szUtf8String; szUtf8String = NULL;CEGUI控件按键消息的响应解决case WM_KEYDOWN:i=lParam&0xff0000;i=i16;if(lParam&0x1000000)i|=0x80;CEGUI:System:getSingleton().injectKeyDown(i);break;case WM_KEYUP:i=lParam&0xff0000;i=i16;if(lParam&0x1000000)i|=0x80;CEGUI:System:getSingleton().injectKeyUp(i);break;CEGUI控件消