《OGRE 3D 渲染引擎原理与架构》15.2 跨后端抽象

跨后端抽象的秘密在 Root 持有的 RenderSystemList 与抽象基类:插件 install() 注册后端,loadPlugin 拉起 dllStartPlugin,场景只持有抽象 RenderSystem 指针,setRenderSystem 换 active 后同一场景零改动。lab 复现换后端的行为差异。

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 统一通知。

源码定位

上游引用固定到 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 最小跨后端渲染器 。

继续阅读

探索更多技术文章

浏览归档,发现更多关于系统设计、工具链和工程实践的内容。

全部文章 返回首页

「books」更多文章

  1. 《大规模分布式计算深入解析》15.3 落地:从 Neo4j 到自研图引擎
  2. 《大规模分布式计算深入解析·图计算与图数据库内核》 · 目录与学习路径(45 篇)
  3. 《大规模分布式计算深入解析》15.2 十一卷主线:从切分到图