分析CEGUI的最小资源定制

分析CEGUI的最小资源定制

本文针对只创建一个按钮(PushButton)的情况，分析CEGUI资源目录datafiles下最少可以放些什 么，并加以解释。

[sihan@localhost datafiles]$ tree . |-- fonts |   |-- Commonv2c.ttf |   |-- Commonwealth-10.font |   `-- Font.xsd |-- imagesets |   |-- Imageset.xsd |   |-- TaharezLook.imageset |   `-- TaharezLook.tga |-- looknfeel |   |-- Falagard.xsd |   `-- TaharezLook.looknfeel `-- schemes     |-- GUIScheme.xsd     `-- TaharezLook.scheme

CEGUI资源文件

如下是资源类的一个列表，这四个是必须用到的： CEGUI::Imageset                 - Imageset xml and texture image files. CEGUI::Font                     - Font xml and ttf font files. CEGUI::Scheme                   - Scheme xml files. CEGUI::WidgetLookManager        - LookNFeel xml files 这两个实在这次没有用到的： CEGUI::WindowManager            - Window layout xml files. CEGUI::ScriptModule             - Script files in whichever scripted langauge.

图片集Imageset Imageset只是原图形/纹理文件某个区域的定义（Imageset定义时将会指定区域）。每个定义的区域都有一个唯一的名字，并且在系统内被 认为是一个Image。Image是Imageset中一个基本的元素。如果想要更改CEGUI画出的图形，可以更改原图形/纹理文件，或者更改 image的定义区。 字体 Font 可以定义两种类型的字体供CEGUI使用：             动态字体    基于true-type(.ttf)的字体文件             静态字体    一个位图字体，这种字体基于一个定义了Images的Imageset。 Scheme Schema是把零碎的数据文件组合起来的一种方法。 它也是装载和注册widget类型的最简便的方法。一个Schema可以包含以下一个或者多个类型的定义(这些文件描述的资源可以在schema被装载时 装载)。             Imageset             Font             Window Set             Window Alias Imageset和font在前面已经提到过。一个Window Set指定了可装载模块(.dll/.so, 等等)的名字。 Widgets集包含了你希望注册的模块集。(注，根据网上的资料，widgets类似于windows的themes) Window或者widget类型可以有多个名字，Windows Alias提供了这一机制。我们也可以通过这种机制使一个widget"隐藏"另一个已经注册了的widget。 布局layout 布局文件包含了一个窗口布局的信息，它也是xml格式的。其中每个'window'元素定义了被创建的window或者widet，'Property' 元素定义每个window的属性值。

下面看看这些文件的内容：

TaharezLook.scheme: <?xml version="1.0" ?> <GUIScheme Name="TaharezLook">         <Imageset Name="TaharezLook" Filename="TaharezLook.imageset" />         <Font Name="Commonwealth-10" Filename="Commonwealth-10.font" />         <LookNFeel Filename="TaharezLook.looknfeel" />         <WindowRendererSet Filename="CEGUIFalagardWRBase" />         <FalagardMapping WindowType="TaharezLook/Button"      TargetType="CEGUI/PushButton"  Renderer="Falagard/Button"       LookNFeel="TaharezLook/Button" /> </GUIScheme> TaharezLook.looknfeel: <?xml version="1.0" ?> <Falagard>     <!--     ***************************************************         TaharezLook/Button     ***************************************************     -->     <WidgetLook name="TaharezLook/Button">         <PropertyDefinition name="NormalTextColour" initialValue="FFFFFFFF" redrawOnWrite="true" />         <PropertyDefinition name="HoverTextColour" initialValue="FFFFFFFF" redrawOnWrite="true" />         <PropertyDefinition name="PushedTextColour" initialValue="FFFFFFFF" redrawOnWrite="true" />         <PropertyDefinition name="DisabledTextColour" initialValue="FF7F7F7F" redrawOnWrite="true" />         <PropertyDefinition name="VertLabelFormatting" initialValue="CentreAligned" />         <PropertyDefinition name="HorzLabelFormatting" initialValue="CentreAligned" />         <PropertyDefinition name="NormalImage" initialValue="" redrawOnWrite="true" />         <PropertyDefinition name="HoverImage" initialValue="" redrawOnWrite="true" />         <PropertyDefinition name="PushedImage" initialValue="" redrawOnWrite="true" />         <PropertyDefinition name="DisabledImage" initialValue="" redrawOnWrite="true" />         <PropertyDefinition name="VertImageFormatting" initialValue="Stretched" redrawOnWrite="true" />         <PropertyDefinition name="HorzImageFormatting" initialValue="Stretched" redrawOnWrite="true" />         <ImagerySection name="normal">             <FrameComponent>                 <Area>                     <Dim type="LeftEdge"><AbsoluteDim value="0" /></Dim>                     <Dim type="TopEdge"><AbsoluteDim value="0" /></Dim>                     <Dim type="Width"><UnifiedDim scale="1" type="Width" /></Dim>                     <Dim type="Height"><UnifiedDim scale="1" type="Height" /></Dim>                 </Area>                 <Image type="LeftEdge" imageset="TaharezLook" image="ButtonLeftNormal" />                 <Image type="RightEdge" imageset="TaharezLook" image="ButtonRightNormal" />                 <Image type="Background" imageset="TaharezLook" image="ButtonMiddleNormal" />             </FrameComponent>             <ImageryComponent>                 <Area>                     <Dim type="LeftEdge" ><AbsoluteDim value="0" /></Dim>                     <Dim type="TopEdge" ><AbsoluteDim value="0" /></Dim>                     <Dim type="Width" ><UnifiedDim scale="1" type="Width" /></Dim>                     <Dim type="Height" ><UnifiedDim scale="1" type="Height" /></Dim>                 </Area>                 <ImageProperty name="NormalImage" />                 <VertFormatProperty name="VertImageFormatting" />                 <HorzFormatProperty name="HorzImageFormatting" />             </ImageryComponent>         </ImagerySection>         <ImagerySection name="hover">             <FrameComponent>                 <Area>                     <Dim type="LeftEdge" ><AbsoluteDim value="0" /></Dim>                     <Dim type="TopEdge" ><AbsoluteDim value="0" /></Dim>                     <Dim type="Width" ><UnifiedDim scale="1" type="Width" /></Dim>                     <Dim type="Height" ><UnifiedDim scale="1" type="Height" /></Dim>                 </Area>                 <Image type="LeftEdge" imageset="TaharezLook" image="ButtonLeftHighlight" />                 <Image type="RightEdge" imageset="TaharezLook" image="ButtonRightHighlight" />                 <Image type="Background" imageset="TaharezLook" image="ButtonMiddleHighlight" />             </FrameComponent>             <ImageryComponent>                 <Area>                     <Dim type="LeftEdge" ><AbsoluteDim value="0" /></Dim>                     <Dim type="TopEdge" ><AbsoluteDim value="0" /></Dim>                     <Dim type="Width" ><UnifiedDim scale="1" type="Width" /></Dim>                     <Dim type="Height" ><UnifiedDim scale="1" type="Height" /></Dim>                 </Area>                 <ImageProperty name="HoverImage" />                 <VertFormatProperty name="VertImageFormatting" />                 <HorzFormatProperty name="HorzImageFormatting" />             </ImageryComponent>         </ImagerySection>         <ImagerySection name="pushed">             <FrameComponent>                 <Area>                     <Dim type="LeftEdge" ><AbsoluteDim value="0" /></Dim>                     <Dim type="TopEdge" ><AbsoluteDim value="0" /></Dim>                     <Dim type="Width" ><UnifiedDim scale="1" type="Width" /></Dim>                     <Dim type="Height" ><UnifiedDim scale="1" type="Height" /></Dim>                 </Area>                 <Image type="LeftEdge" imageset="TaharezLook" image="ButtonLeftPushed" />                 <Image type="RightEdge" imageset="TaharezLook" image="ButtonRightPushed" />                 <Image type="Background" imageset="TaharezLook" image="ButtonMiddlePushed" />             </FrameComponent>             <ImageryComponent>                 <Area>                     <Dim type="LeftEdge" ><AbsoluteDim value="0" /></Dim>                     <Dim type="TopEdge" ><AbsoluteDim value="0" /></Dim>                     <Dim type="Width" ><UnifiedDim scale="1" type="Width" /></Dim>                     <Dim type="Height" ><UnifiedDim scale="1" type="Height" /></Dim>                 </Area>                 <ImageProperty name="PushedImage" />                 <VertFormatProperty name="VertImageFormatting" />                 <HorzFormatProperty name="HorzImageFormatting" />             </ImageryComponent>         </ImagerySection>         <StateImagery name="Normal">             <Layer>                 <Section section="normal" />                 <Section section="label">                     <ColourProperty name="NormalTextColour" />                 </Section>             </Layer>         </StateImagery>         <StateImagery name="Hover">             <Layer>                 <Section section="hover" />                 <Section section="label">         <ColourProperty name="HoverTextColour" />         </Section>             </Layer>         </StateImagery>         <StateImagery name="Pushed">             <Layer>                 <Section section="pushed" />                 <Section section="label">                     <ColourProperty name="PushedTextColour" />                 </Section>             </Layer>         </StateImagery>         <StateImagery name="PushedOff">             <Layer>                 <Section section="hover" />                 <Section section="label">                     <ColourProperty name="HoverTextColour" />                 </Section>             </Layer>         </StateImagery>         <StateImagery name="Disabled">             <Layer>                 <Section section="normal">                     <Colours topLeft="FF7F7F7F" topRight="FF7F7F7F" bottomLeft="FF7F7F7F" bottomRight="FF7F7F7F" />                 </Section>                 <Section section="label">                     <ColourProperty name="DisabledTextColour" />                 </Section>             </Layer>         </StateImagery>     </WidgetLook> </Falagard> Commonwealth-10.font: <?xml version="1.0" ?> <Font Name="Commonwealth-10" Filename="Commonv2c.ttf" Type="FreeType" Size="10" NativeHorzRes="800" NativeVertRes="600" AutoScaled="true"/> TaharezLook.imageset: <?xml version="1.0" ?> <Imageset Name="TaharezLook" Imagefile="TaharezLook.tga" NativeHorzRes="800" NativeVertRes="600" AutoScaled="true">     <Image Name="ClientBrush" XPos="2" YPos="2" Width="64" Height="64" />     <Image Name="GenericBrush" XPos="9" YPos="71" Width="1" Height="1" />         <Image Name="ButtonLeftNormal" XPos="68" YPos="20" Width="12" Height="16" />         <Image Name="ButtonMiddleNormal" XPos="82" YPos="20" Width="12" Height="16" />         <Image Name="ButtonRightNormal" XPos="96" YPos="20" Width="12" Height="16" />         <Image Name="ButtonLeftPushed" XPos="68" YPos="38" Width="12" Height="16" />         <Image Name="ButtonMiddlePushed" XPos="82" YPos="38" Width="12" Height="16" />         <Image Name="ButtonRightPushed" XPos="96" YPos="38" Width="12" Height="16" />         <Image Name="ButtonLeftHighlight" XPos="68" YPos="56" Width="12" Height="16" />         <Image Name="ButtonMiddleHighlight" XPos="82" YPos="56" Width="12" Height="16" />         <Image Name="ButtonRightHighlight" XPos="96" YPos="56" Width="12" Height="16" />         <Image Name="MouseArrow" XPos="138" YPos="127" Width="31" Height="25" XOffset="0" YOffset="0" /> </Imageset>

代码

glut_loop.cpp: #include <GL/glew.h> #include <GL/freeglut.h> #include <CEGUI.h> #include <CEGUIDefaultResourceProvider.h> #include <RendererModules/OpenGLGUIRenderer/openglrenderer.h> #define DATA_FILES "./datafiles/" void render(void); void resource_group(void); void load_data_files(void); void create_window(void); int window_id; bool keep_running = true; int main(int argc, char *argv[]) {     glutInit(&argc, argv);         glutInitDisplayMode(GLUT_DEPTH | GLUT_DOUBLE | GLUT_RGBA);     glutInitWindowSize(640, 480);         window_id = glutCreateWindow("GLUT Loop");     glutSetCursor(GLUT_CURSOR_NONE);     GLenum err = glewInit();     CEGUI::OpenGLRenderer* myRenderer = new CEGUI::OpenGLRenderer(0);     new CEGUI::System(myRenderer);         resource_group();     load_data_files();     create_window();     while (keep_running)     {         glutMainLoopEvent();         render();         CEGUI::System::getSingleton().renderGUI();         glutSwapBuffers();     }     glutDestroyWindow(window_id);     return 0; } void render(void) {     glLoadIdentity();     glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT); } void resource_group(void) {     CEGUI::DefaultResourceProvider *rp = static_cast<CEGUI::DefaultResourceProvider*>         (CEGUI::System::getSingleton().getResourceProvider());     rp->setResourceGroupDirectory("schemes", DATA_FILES "schemes/");     rp->setResourceGroupDirectory("imagesets", DATA_FILES "imagesets/");     rp->setResourceGroupDirectory("fonts", DATA_FILES "fonts/");     rp->setResourceGroupDirectory("looknfeels", DATA_FILES "looknfeel/");     CEGUI::Imageset::setDefaultResourceGroup("imagesets");     CEGUI::Font::setDefaultResourceGroup("fonts");     CEGUI::Scheme::setDefaultResourceGroup("schemes");     CEGUI::WidgetLookManager::setDefaultResourceGroup("looknfeels"); } void load_data_files(void) {     CEGUI::SchemeManager::getSingleton().loadScheme("TaharezLook.scheme");     if (!CEGUI::FontManager::getSingleton().isFontPresent("Commonwealth-10"))         CEGUI::FontManager::getSingleton().createFont("Commonwealth-10");     CEGUI::System::getSingleton().setDefaultFont("Commonwealth-10");     CEGUI::System::getSingleton().setDefaultMouseCursor("TaharezLook", "MouseArrow"); } void create_window(void) {     using namespace CEGUI;     WindowManager &wmgr = WindowManager::getSingleton();     Window* myRoot = wmgr.createWindow("DefaultWindow", "root");     System::getSingleton().setGUISheet(myRoot);     // 创建PushButton     PushButton *btn = (PushButton*)wmgr.createWindow("TaharezLook/Button", "testButton");     myRoot->addChildWindow(btn);         // 设置位置，大小        btn->setPosition( UVector2( UDim(0.25f, 0), UDim(0.25f, 0) ) );     btn->setSize( UVector2( UDim(0, 60), UDim(0, 24) ) );     btn->setText("OK"); } Makefile: glut_loop: glut_loop.o     g++ glut_loop.o -lglut -L/usr/local/lib/ -lCEGUIBase -lCEGUIOpenGLRenderer -o glut_loop glut_loop.o: glut_loop.cpp     g++ -g -c glut_loop.cpp -I/usr/local/include/CEGUI .PHONY: clean clean:     rm -rf *.o glut_loop