OGRE 1.7 例子程序分析
如果你自己都不清楚所谈论的东西,就根本不可能精确的描述它——冯诺依曼
今天我就试着来表述一件众人皆知的事情,以测试自己到底有没有明白这件事情。
OGRE是著名的设计模式大师,这已是不争的事实。可以说OGRE里将设计模式用得淋漓尽致。在这里我就不批判设计模式该不该用了。反正OGRE已经用了,并且没有出现什么不好的结果。适合的就是最好的,OGRE证明了这一点。
随着OGRE 1.7的发布,大家熟悉的DEMO程序不见了,换来的是一个个的DLL库。而这些库,就是作为OGRE的一个插件而存在。拿SkyBox为例,(不要问为什么拿SkyBox,如果真要知道,我只能说,我刚好看上它了。)我们可以在SkyBox.cpp里发现如下代码。
SamplePlugin* sp; Sample* s; extern "C" _OgreSampleExport void dllStartPlugin() { s = new Sample_SkyBox; sp = OGRE_NEW SamplePlugin(s->getInfo()["Title"] + " Sample"); sp->addSample(s); Root::getSingleton().installPlugin(sp); } extern "C" _OgreSampleExport void dllStopPlugin() { Root::getSingleton().uninstallPlugin(sp); OGRE_DELETE sp; delete s; }
dllStartPlugin 和 dllStopPlugin 是插件的加载和卸载接口。可以看到,当调用dllStartPlugin 时,它先新建了一个Sample_SkyBox实例,这就是我们真正的示例程序。紧接着,它又新建了一个插件。插件的名字则以实例的Title信息加上Sample来标志。随后,这个示例程序的实例被加入插件中,然后调用Root::getSingleton().installPlugin(sp);函数初始化我们的插件。
显然,我们需要看看installPlugin干了些什么。
void Root::installPlugin(Plugin* plugin) { LogManager::getSingleton().logMessage("Installing plugin: " + plugin->getName()); mPlugins.push_back(plugin); plugin->install(); // if rendersystem is already initialised, call rendersystem init too if (mIsInitialised) { plugin->initialise(); } LogManager::getSingleton().logMessage("Plugin successfully installed"); }
不难看出,OGRE在这个函数中将插件加入了自己的插件容器中,并调用插件的初始化接口。以及输出相关LOG信息。
而又是在何时调用这个dllStartPlugin来加载插件的呢。我们打开SampleBrowser.h找到virtual Sample* loadSamples()函数。在这个函数中的前几句便反应了它所做的工作。
Sample* startupSample = 0; Ogre::StringVector unloadedSamplePlugins; Ogre::ConfigFile cfg; cfg.load(mFSLayer->getConfigFilePath("samples.cfg")); Ogre::String sampleDir = cfg.getSetting("SampleFolder"); // Mac OS X just uses Resources/ directory Ogre::StringVector sampleList = cfg.getMultiSetting("SamplePlugin"); Ogre::String startupSampleTitle = cfg.getSetting("StartupSample");
在这里,例子浏览器加载了samples.cfg文件,并读取相关内容。我们看看samples.cfg 里装了些什么便一切明了了。
SampleFolder=. SamplePlugin=Sample_BezierPatch_d SamplePlugin=Sample_BSP_d SamplePlugin=Sample_CameraTrack_d SamplePlugin=Sample_CelShading_d SamplePlugin=Sample_Character_d SamplePlugin=Sample_Compositor_d SamplePlugin=Sample_CubeMapping_d SamplePlugin=Sample_DeferredShading_d 。。。。
这些正好是我们的例子插件的DLL文件名。loadSamples函数在读取了这些信息后,将其放入 StringVector sampleList 中,然后依次遍历这个容器,并调用插件加载函数。代码如下
// loop through all sample plugins... for (Ogre::StringVector::iterator i = sampleList.begin(); i != sampleList.end(); i++) { mRoot->loadPlugin(sampleDir + *i); }
按照我们分析问题的方案(我们总是从程序的行为进行跟踪分析)。于是我们看看loadPlugin函数做了些什么。
void Root::loadPlugin(const String& pluginName) { //根据名字加载动态库 DynLib* lib = DynLibManager::getSingleton().load( pluginName ); //查找是否已经加载,如果没有存在,则加入其中。并且取得入口函数并执行。 if (std::find(mPluginLibs.begin(), mPluginLibs.end(), lib) == mPluginLibs.end()) { mPluginLibs.push_back(lib); DLL_START_PLUGIN pFunc = (DLL_START_PLUGIN)lib->getSymbol("dllStartPlugin"); if (!pFunc) OGRE_EXCEPT(Exception::ERR_ITEM_NOT_FOUND, "Cannot find symbol dllStartPlugin in library " + pluginName, "Root::loadPlugin"); pFunc();//执行dllStartPlugin( ) } }
由此,我们便可以知道整个程序的流程。。即例子浏览器在初始化时读取samples_d.cfg文件,然后根据文件内容加载所有的DLL并初始化相关内容。
此时我们会考虑,如果我们想要新增一个例子,应该如何去做?于是,我们需要先看看Sample_SkyBox 以及SamplePlugin.
打开Sample_SkyBox.h 我们便会看到
class _OgreSampleClassExport Sample_SkyBox : public SdkSample { protected: void setupContent() { //实现代码 } };
上面代码说明了,Sample_SkyBox继承自SdkSample,并且实现了setupContent函数。
我们再打开SamplePlugin可以看到有些空函数,说明在我们的例子中,SamplePlugin并没有做太多的初始化工作。于是,我们得到如下的关系
1、 Sample_SkyBox派生自SdkSample
2、 SamplePlugin派生自Plugin
3、 SamplePlugin持有Sample_SkyBox实例指针
4、 SamplePlugin会注册到Root的插件管理中
5、 Sample_SkyBox应该被加入到Samples_d.cfg中。
于是,我们可以看到,如果我们想实现一个简单的例子。则只需要自SdkSample派生一个实现类,并至少实现setupContent函数。然后学着Sample_SkyBox的样子写好dllStartPlugin和dllStopPlugin函数,并导出成DLL,然后将DLL名字添加到smaples_d.cfg中。
以上描述均是Debug版本下。如果是Release,则去掉后面的_d即可。
作者:麒麟子
出处:http://www.cnblogs.com/qilinzi/
蛮牛专栏:麒麟子
简介:麒麟子,编程15年,科技创始人,技术作家。
09年进入游戏行业,16年创立成都幼麟科技有限公司。十年从业经验练就了游戏全栈技能,目前专注于手机游戏领域。
版权声明:本文版权归作者和博客园共有,欢迎转载。转载必须保留此段声明,且在文章页面明显位置给出原文连接,否则保留追究法律责任的权利。