ogre配置文件

Ogre.cfg

 

 

 

OGRE引擎将会在可执行文件所在的文件夹中生成一个ogre.cfg文件该文件保存了本次对话框的设置结果，下次显示对话框时会将上次的配置结果读入并直接显示。例子框架用mRoot->showConfigDialog()来调出配置对话框。如果你认为在程序运行之前显示一个对话框很难看，或者希望采用另外的形式（比如专门的配置界面，就象在大部分游戏中那样）来配置渲染系统，只要你确保在可执行文件的同一文件夹下存在有效的Ogre.cfg配置文件，就可以直接调用Root对象的restoreConfig()函数来直接读入渲染系统配置信息，而不显示配置对话框。

Ogre::Root::showConfigDialog()会有下述行为：如果程序运行之间已存在一个有效的ogre.cfg，那么它会在显示对话框之前将配置文件的内容载入，如果用户对对话框进行了操行，改变的配置参数，showConfigDialog()会根据用户的新选择依次调用Root::setRenderSystem, RenderSystem::setConfigOption and Root::saveConfig（在ogreWin32ConfigDialog.cpp中实现，写自己的配置对话框时可以参考），需要注意的是配置好的参数，只是在 RenderSystem::initialise or RenderSystem::reinitialise 调用之后才被激活。

以下为典型的ogre.cfg文件的内容

Render System=Direct3D9 Rendering Subsystem

 

 

 

 

[Direct3D9 Rendering Subsystem]

Allow NVPerfHUD=No

Anti aliasing=None

Floating-point mode=Fastest

Full Screen=No

Rendering Device=ATI MOBILITY RADEON X300

VSync=No

Video Mode=800 x 600 @ 32-bit colour

 

 

 

 

[OpenGL Rendering Subsystem]

Colour Depth=32

Display Frequency=N/A

FSAA=0

Full Screen=No

RTT Preferred Mode=FBO

VSync=No

Video Mode=1024 x 768

方括号中为可以选择的渲染子系统，而第一行指出了当前的选择是哪个子系统，方括号下面为各子系统的可选参数，在上的例子中分别列出了Direct3D 9与OpenGL子系统的可选配置参数。

Root(const String& pluginFileName = "plugins.cfg", const String& configFileName = "ogre.cfg", const String& logFileName = "Ogre.log");

 

 

 

        ~Root();

 

 

 

Root的构造函数传递了ogre.cfg,只是简单的将文件名保存下来，供其它方法使用，如上面曾经提到过的Root:saveConfig(void);

 

 

 

 

 

 

 

 

 

 

 

 

在windows平台插件的装入过程如下：

Root::()

{

   if(!pluginFileName.empty())

      loadPlugins(pluginFileName);

｝

――――――＞

void Root::loadPlugins(const String& pluginsfile)

{

   ConfigFile cfg;

   cfg.load(pluginsfile);

    ...........................

   //解析文件，处理后将目录与文件名联接

for(;;)

   loadPlugin(plugindir + (*it))

}――――――＞

 

 

 

 

 

 

Root::loadplugin(const string& pluginName)

{

    DyLibmanager::getsinleton.load(pluginName);

}

――――――＞

 

 

 

 

 

 

DynLibManager::load(const string& filename)

 

 

 

 

 

 

{

        DynLib* pLib=new DynLib(filename);

        pLib->load();

 

 

 

 

 

 

}

――――――＞

void DynLib::load()

{

        m_hInst=(DYNLIB_HANDLE)DYNLIB_LOAD(name.cstr());

}

在windows平台下有如下定义：

#define DYNLIB_LOAD(a)     LoadLibrary(a)

到此，x.dll插件被加载到内存中，可以使用插件的功能了。。。。。。。

以下为一个典型的Plugins.cfg文件的内容：

# Defines plugins to load

 

 

 

 

 

 

# Define plugin folder

PluginFolder=.

 

 

 

 

 

 

# Define plugins

Plugin=RenderSystem_Direct3D9

Plugin=RenderSystem_GL

Plugin=Plugin_ParticleFX

Plugin=Plugin_BSPSceneManager

Plugin=Plugin_OctreeSceneManager

Plugin=Plugin_CgProgramManager

Plugins.cfg文件内容相当直观，不再赘述。

 

 

resources.cfg

 

 

 

资源是OGRE应用程序渲染过程中需要用到的纹理图片、网格模型文件、骨骼动画文件的总称。OGRE应用程序需要在渲染前将这些资源载入内存，那就需要让OGRE引擎知道资源的搜索路径。特别的是OGRE引擎支持直接读取Zip压缩文件中的内容，所以Zip文件也必须被当成搜索路径来指定。在OGRE引擎中具有虚拟文件系统的概念，引擎内部载入资源文件都是通过虚拟文件系统来进行的，引擎并不关心资源文件来自一个普通文件夹、zip压缩包甚至网络映射。真正的文件读取功能是通过插件来实现的，所以大家在运行环境里可以发现Plugin_FileSystem.dll，早期的OGRE版本还有Plugin_Zip.dll，在新的版本里被实现到引擎内部了。目前还没有实现对网络文件的直接访问。

为了方便OGRE程序在运行期间查找资源，使用了资源配置文件resources.cfg。这是一个文本文件，我们可以在OGRE程序的可执行文件的同一文件夹下找到它。它的内容就是对资源路径的指定，示例如下：

Zip=../../../Media/dragon.zip

Zip=../../../Media/knot.zip

Zip=../../../Media/skybox.zip

FileSystem=../../../Media/

如果资源在一个Zip文件中，就写Zip=******，如果资源在一个普通的硬盘文件夹里就写FileSystem=******，通常这两种情况都有。例如在OGRE自带的Demo中，就将大部分资源放在一个文件夹里，特殊的资源该文件夹中的Zip文件里。

在OGRE自带的例子框架setupResources()展示了Resources.cfg文件的使用：先利用ConfigFile类对文件内容进行了解析，将资源目录用ResourceGroupManager:: addResourceLocation()向OGRE进行提交。

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Plugins.cfg

 

 

 

Ogre的许多功能是以插件的形式提供的.Ogre提供的以Plugin_开头的许多.DLL文件都是所谓的插件。Plugins.cfg指定了插件的路径和插件文件名, 它们可以放在其它文件夹里，但必须在本文件里指定路径。