15.2 跨后端抽象
「同一份场景代码,跑在不同 API 上」是 OGRE 的核心承诺。兑现它的结构很简单:Root 持有一张 RenderSystemList,场景侧只跟 RenderSystem 抽象基类打交道。15.1 看了候选表怎么挑 active,这一节看后端怎么进来(插件链)、以及为什么场景能无感切换。
本章与站内既有内容的分工
15.1 讲选择后端,这一节讲后端如何被装载进候选表(插件链)以及抽象边界;与卷一 ogre-core 的插件系统直接承接——loadPlugin 拉起动态库、installPlugin 调 install()。cg 三卷与 helio 四卷不涉及插件装载,此节是 OGRE 特有的「多 API 支持」装配。
插件链:后端如何进入候选表
候选表 mRenderers 的填充走完整插件链:loadPlugin 加载动态库并找 dllStartPlugin 符号 → dllStartPlugin 内部创建插件实例并 install() → 插件 install() 里 OGRE_NEW 后端并 addRenderSystem。先看 installPlugin 的登记动作:
// OgreMain/src/OgreRoot.cpp:Root::installPlugin(v14.6.3 源码摘录,已删减)
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");
}
install() 是插件把后端交给 Root 的地方。loadPlugin 负责动态库层面:DynLibManager::load 打开共享库,getSymbol("dllStartPlugin") 取入口函数并调用——它注释明说「This must call installPlugin」:
// OgreMain/src/OgreRoot.cpp:Root::loadPlugin(v14.6.3 源码摘录,已删减)
void Root::loadPlugin(const String& pluginName)
{
#if OGRE_PLATFORM != OGRE_PLATFORM_EMSCRIPTEN
// Load plugin library
DynLib* lib = DynLibManager::getSingleton().load( pluginName );
// Store for later unload
// Check for existence, because if called 2+ times DynLibManager returns existing entry
if (std::find(mPluginLibs.begin(), mPluginLibs.end(), lib) == mPluginLibs.end())
{
mPluginLibs.push_back(lib);
// Call startup function
#ifdef __GNUC__
__extension__
#endif
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");
// This must call installPlugin
pFunc();
}
#endif
}
loadPlugins 则是批量版:读 plugins.cfg 的 PluginFolder 与多条 Plugin,逐个 loadPlugin。整条链的终点是 15.1 看过的 addRenderSystem——三个环节(动态库、插件、后端)层层剥开,最终候选表多一个 RenderSystem*。
抽象边界:场景只看 RenderSystem 基类
跨后端不跨界的根源在于:场景、材质、网格等系统从不持有具体后端类型。它们拿到的要么是 Root::getRenderSystem() 返回的 RenderSystem*,要么是各 Manager 内部缓存的同一指针。RenderSystem 基类把「创建窗口、设状态、画几何」全部声明为虚函数,GL3Plus/Vulkan/Metal/D3D11 各写一套 override。切换后端时,这些指针不变、调用点不变,只有虚表指向的具体实现变了。
setRenderSystem 换 active 后会广播 RenderSystemChanged,让持有旧后端资源的系统重建(15.1 已述)。对场景代码而言,换后端只是换了个「画出来长得一样的实现」:
// OgreMain/src/OgreRoot.cpp:Root::setRenderSystem 摘录(v14.6.3 源码摘录,已删减)
if( mActiveRenderer && mActiveRenderer != system )
{
mActiveRenderer->shutdown();
}
mActiveRenderer = system;
// Tell scene managers
if(mSceneManagerEnum)
mSceneManagerEnum->setRenderSystem(system);
mSceneManagerEnum->setRenderSystem(system) 把新后端传给所有场景管理器,让它们后续创建视口、分配缓冲时走新后端——这就是「换后端要动的东西」:不需要动的(场景逻辑)不动,需要动的(场景管理器的渲染依赖)由 Root 统一通知。
源码定位
OgreMain/include/OgreRoot.h:RenderSystemList(53)、mRenderers(83)、mActiveRenderer(84)、addRenderSystem(278)、setRenderSystem(313)OgreMain/src/OgreRoot.cpp:installPlugin(1013-1027)、loadPlugin(1045-1069)、loadPlugins(817-866)、addRenderSystem(479-482)RenderSystems/GL/src/OgreGLPlugin.cpp:GLPlugin::install(44-49)
上游引用固定到 OGRE v14.6.3 源码 。
可运行产物:C++ 最小验证
下面复现插件注册、抽象接口与同场景换后端。它与 src/15-2-cross-backend-abstract.cpp 逐字节一致:
// file: src/15-2-cross-backend-abstract.cpp
// tier: L1
// verify: clang++ -std=c++20 -I. src/15-2-cross-backend-abstract.cpp -o bin/15-2-cross-backend-abstract && ./bin/15-2-cross-backend-abstract
//
// 复现跨后端抽象的调用链(对应 OgreRoot.cpp 429-489 / 1013-1027 与 OgreRoot.h 53-84):
// 插件 install() 通过 addRenderSystem 填充 mRenderers;loadPlugin 拉起的插件工厂逐一注册;
// Root::setRenderSystem 选 active;场景对象只持有抽象 RenderSystem 指针,
// 同一份场景代码不感知后端差异即可在 GL/Vulkan/Metal 间切换。
// 独立最小验证,非 OGRE 源码。
#include "verify.h"
#include <cstddef>
#include <functional>
#include <string>
#include <vector>
namespace ogre_repro {
// 抽象后端:对应 RenderSystem 基类
class RenderSystem {
public:
explicit RenderSystem(const std::string& name) : mName(name) {}
virtual ~RenderSystem() = default;
const std::string& getName() const { return mName; }
// 后端差异的替身:各后端画同一场景的返回不同
virtual std::string draw(int objCount) = 0;
void shutdown() { ++mShutdownCount; }
int mShutdownCount = 0;
protected:
std::string mName;
};
class GLRenderSystem : public RenderSystem {
public:
GLRenderSystem() : RenderSystem("OpenGL Rendering Subsystem") {}
std::string draw(int objCount) override { return "gl(" + std::to_string(objCount) + ")"; }
};
class VulkanRenderSystem : public RenderSystem {
public:
VulkanRenderSystem() : RenderSystem("Vulkan Rendering Subsystem") {}
std::string draw(int objCount) override { return "vk(" + std::to_string(objCount) + ")"; }
};
class MetalRenderSystem : public RenderSystem {
public:
MetalRenderSystem() : RenderSystem("Metal Rendering Subsystem") {}
std::string draw(int objCount) override { return "mtl(" + std::to_string(objCount) + ")"; }
};
class RootRepro {
public:
// 对应 GLPlugin::install 调用的 addRenderSystem
void addRenderSystem(RenderSystem* newRend) { mRenderers.push_back(newRend); }
// 模拟 loadPlugin -> installPlugin:每个插件工厂 install() 时登记一个后端
void loadPlugins(const std::vector<std::function<RenderSystem*()>>& factories) {
for (auto& f : factories) addRenderSystem(f());
}
const std::vector<RenderSystem*>& getAvailableRenderers() const { return mRenderers; }
RenderSystem* getRenderSystemByName(const std::string& name) const {
if (name.empty()) return nullptr;
for (auto* rs : getAvailableRenderers())
if (rs->getName() == name) return rs;
return nullptr;
}
// 对应 Root::setRenderSystem
void setRenderSystem(RenderSystem* system) {
if (mActiveRenderer && mActiveRenderer != system) mActiveRenderer->shutdown();
mActiveRenderer = system;
}
RenderSystem* getRenderSystem() const { return mActiveRenderer; }
size_t rendererCount() const { return mRenderers.size(); }
private:
std::vector<RenderSystem*> mRenderers; // 对应 Root::mRenderers
RenderSystem* mActiveRenderer = nullptr; // 对应 Root::mActiveRenderer
};
// 场景对象:只经抽象接口使用当前 active 后端
class SceneRepro {
public:
explicit SceneRepro(RootRepro* root) : mRoot(root) {}
std::string render(int objCount) { return mRoot->getRenderSystem()->draw(objCount); }
private:
RootRepro* mRoot;
};
} // namespace ogre_repro
int main() {
using namespace ogre_repro;
RootRepro root;
// 加载三个后端插件:install() 各自登记
root.loadPlugins({
[]() { return new GLRenderSystem(); },
[]() { return new VulkanRenderSystem(); },
[]() { return new MetalRenderSystem(); },
});
CHECK_EQ(root.rendererCount(), size_t(3));
CHECK(root.getRenderSystemByName("Missing") == nullptr);
// 选择 GL:场景经抽象接口画
root.setRenderSystem(root.getRenderSystemByName("OpenGL Rendering Subsystem"));
CHECK(root.getRenderSystem()->getName() == "OpenGL Rendering Subsystem");
SceneRepro scene(&root);
CHECK_EQ(scene.render(3), "gl(3)");
// 同一场景对象换 Vulkan:调用点零改动
root.setRenderSystem(root.getRenderSystemByName("Vulkan Rendering Subsystem"));
CHECK_EQ(scene.render(3), "vk(3)");
// 换 Metal
root.setRenderSystem(root.getRenderSystemByName("Metal Rendering Subsystem"));
CHECK(root.getRenderSystem()->getName() == "Metal Rendering Subsystem");
CHECK_EQ(scene.render(7), "mtl(7)");
// 切换时旧后端被 shutdown:GL、Vulkan 各一次,Metal 未再切换
CHECK(root.getRenderSystemByName("OpenGL Rendering Subsystem")->mShutdownCount == 1);
CHECK(root.getRenderSystemByName("Vulkan Rendering Subsystem")->mShutdownCount == 1);
CHECK(root.getRenderSystemByName("Metal Rendering Subsystem")->mShutdownCount == 0);
return lab::report("15-2 跨后端抽象");
}
本机实测(Apple clang 16,clang++ -std=c++20):编译通过(-Wall 零警告),断言 10/10 通过。
小结
- 候选表
mRenderers由插件链填充:loadPlugin(动态库)→dllStartPlugin→installPlugin→plugin->install()→addRenderSystem。 - 场景侧只持有抽象
RenderSystem*,虚表切换后端,调用点零改动。 setRenderSystem换 active 后统一通知场景管理器,只重建渲染依赖,不碰场景逻辑。- 换后端会
shutdown旧后端并广播RenderSystemChanged。 - 跨后端抽象 = 候选表 + 抽象基类 + 插件注册三点闭合。
阅读导航:上一节:15.1 选择渲染后端 · 下一节:15.3 最小跨后端渲染器 。
继续阅读
探索更多技术文章
浏览归档,发现更多关于系统设计、工具链和工程实践的内容。