cegui 2
资源管理入门
读了CEGUI渲染入门这一章,你已经知道,要想让CEGUI跑起来,至少对CEGUI进行最基础的
初始化,并调用System ::renderGUI方法,这看起来不错。可是,你仍然画不出任何东西。
为了达成,下一步是设置资源管理组(resource provider groups),我们将用它们装载一些文件供CEGUI在渲染的时候使用。
ResourceProvide 是什么?
CEGUI使用了一个工具对象,我们叫它“ResourceProvide”。这个对象提供了一组接口负责CEGUI与其他的文件装载系统通讯。
例如: Ogre 和Irrlicht 都有他们自己的资源管理/文件装载子系统,通过实现特定的ResourceProvide 对象,CEGUI
的渲染模块就和那些子系统无缝的组合起来。那样CEGUI的数据文件就可以通过那些子系统装载了。但是,更底层的库
(Direct3D OpenGL) 没有那样的资源管理系统。所以CEGUI 为他们提供了默认的资源管理系统
(default resource provider)。
default resource provider 相关说明
CEGUI::DefaultResourceProvider --------CEGUI 的默认的资源管理系统,是为那些还没有资源管理的库
提供基础帮助的系统。 他不仅提供了CEGUI装载文件 数据时所需要的函数,而且对资源组(resource groups)
也提供了初步的支持。 这里的“资源组”其实只是一个标签,它代表系统的某个文件夹路径。这使得我们可以将文件夹
中的文件按逻辑类型分组,然后可以通过一个人简单的标签而不是硬编码的路径去指定它,也就是说:当数据文件的
路径有改动的时候,只需要更细资源组的路径而不必更改代码和xml文件中的路径信息。
指定资源组和路径
DefaultResourceProvider 允许你定义任意数目的资源组,并为每个资源组指定一个路径。也就是说,你可以
创建一个资源组,比如 “imagesets”,并为它指定一个路径,假设是"./game/datafile/gui/imagesets/".
然后,你通过ImagesetManager装载Imageset的时候,就可以指定"imagesets"为他将要使用的资源组,
这样系统就会在预定义的路径中寻找资源。目前,每个资源组只可以赋予一个路径。
个
例子说明
以前,在没有使用资源组的时候,你may be
Imageset *set = ImagesetManager::getSingleton().createImageset("./game/datafile/gui/imagesets/WindowsLook.imageset");
使用了资源组以后,在初始化阶段,你可以使用默认的资源管理器像这样创建资源组
DefaultResourceProvider *rp = CEGUI::System::getSingleton().getResourecProvider();
rp->setResourcrGroupDirectory("imagesets","("./game/datafile/gui/imagesets/WindowsLook.imageset");
Imageset *set = ImagesetManager::getSingleton().createImageset("WindowsLook.imageset","imagesets")
注意 :你不需要提供任何的路径信息,因为在你指定的资源组中已经包含了相关的路径信息。
默认资源组
系统定义的任何代表可以可装载资源的资源类,都有获取和设置默认资源组的静态函数。
当需要载入数据文件的时候,他就用那个默认资源组。比如:对于Imageset类,默认的资源组应该指向
一个存储imageset xml 文件和材质文件的文件夹。
对于每个资源类,他们获取 设置资源组的静态函数的名字都是一样的(xerces 是个例外)
const String& getDefaultResourceGroup();
void setDefaultResourceGroup(cosnt String& groupname);
如果是资源类的一个列表,后面是他们各自管理的资源类型
CEGUI::Imageset ------- Imageset xml and texture image files
CEGUI::Font ---------- Font xml and ttf font files.
CEGUI::Scheme -------Scheme xml files
CEGUI::WindowManager --------- window layout xml files
CEGUI::WidgetLookManager ---------- LookNFeel xml files
CEGUI::ScriptModule ---------Script files in whichever scripted langauge
上面提到过,xerces是个例外,它是“基于Xerces-C的XML解释器(Xerces-C based XML parser)”。对此,有一个特殊的资源组设置文件,它指明schema文件在哪里(它们是用来检查xml的.xsd文件)。对于这个特殊情况,它的静态成员如下:
const String& XercesParser::getSchemaDefaultResourceGroup();
void XercesParser::setSchemaDefaultResourceGroup(const String& groupname);
需要注意的最后一点是:资源管理类也有一个默认的资源组。当一个资源类没有显示的指定资源组的时候,
系统就会使用它。当你把所有的数据文件都放到一个文件夹的时候,这点就很方便了。
一个完整的例子:配置 DefaultResourceProvider
- // 为DefaultResourceProvider设置所需的路径
- CEGUI::DefaultResourceProvider* rp = static_cast
- (CEGUI::System::getSingleton().getResourceProvider());
- rp->setResourceGroupDirectory("schemes", "../datafiles/schemes/");
- rp->setResourceGroupDirectory("imagesets",
- "../datafiles/imagesets/");
- rp->setResourceGroupDirectory("fonts", "../datafiles/fonts/");
- rp->setResourceGroupDirectory("layouts", "../datafiles/layouts/");
- rp->setResourceGroupDirectory("looknfeels",
- "../datafiles/looknfeel/");
- rp->setResourceGroupDirectory("lua_scripts",
- "../datafiles/lua_scripts/");
- // 这步仅当你使用Xerces作为XML解析器的时候才需要
- rp->setResourceGroupDirectory("schemas", "../../XMLRefSchema/");
完成这步以后,我们就把资源组和它们的路径都设置好了。最后,为了让系统使用新设置的路径,我们来设置默认资源组:
- // 设置默认资源组
- CEGUI::Imageset::setDefaultResourceGroup("imagesets");
- CEGUI::Font::setDefaultResourceGroup("fonts");
- CEGUI::Scheme::setDefaultResourceGroup("schemes");
- CEGUI::WidgetLookManager::setDefaultResourceGroup("looknfeels");
- CEGUI::WindowManager::setDefaultResourceGroup("layouts");
- CEGUI::ScriptModule::setDefaultResourceGroup("lua_scripts");
- // 仅当你用xerces做XML解析器,并为它定义了一个资源组的时候使用
- CEGUI::XercesParser::setSchemaDefaultResourceGroup("schemas");
总结:
目前,你对DefaultResourceProvider 这个类有了大致的了解了。
知道了怎么创建资源
组并为他们制定路径。 还学会为CEGUI的使用的每个资源类型设置默认资源组。