《OGRE 3D 渲染引擎原理与架构》15.1 选择渲染后端

Root 用 RenderSystemList 保存所有已加载的渲染后端:插件 install() 时 addRenderSystem 登记,getAvailableRenderers 返回候选列表,getRenderSystemByName 按名查找,setRenderSystem 切换 active 并 shutdown 旧后端。lab 复现登记、查找与切换。

15.1 选择渲染后端

一台机器上可能同时装了好几个 OGRE 后端:Vulkan、Metal、GL3Plus、D3D11。应用启动时要挑一个来用。挑谁、怎么登记候选、怎么切换,全在 Root 手里。这一节看 RenderSystemList 这张候选表和 setRenderSystem 的切换逻辑——它决定了「同一份场景代码跑在哪个 API 上」。

本章与站内既有内容的分工

卷一 ogre-core 讲过 Root 是系统入口与插件枢纽,这一节把 mRenderers/mActiveRenderer 两个成员和四个方法的语义抠细;与 09 章各后端源码(Metal/GL3Plus)对应:后端类自身只负责初始化,登记进 mRenderers 由 Root 统一管。15.2 在此基础上讲跨后端抽象,15.3 拼装最小渲染器。

RenderSystemList:候选后端表

Root 用 std::vector<RenderSystem*> 装所有可用后端,并单独记一个「当前活跃」指针:

// OgreMain/include/OgreRoot.h:RenderSystemList 与 Root 成员(v14.6.3 源码摘录,已删减)
    typedef std::vector<RenderSystem*> RenderSystemList;
    ...
    private:
        RenderSystemList mRenderers;
        RenderSystem* mActiveRenderer;
成员角色
mRenderers全部已登记的后端(插件加载后填充)
mActiveRenderer当前选中的后端,帧循环实际使用的对象

候选表的填充发生在插件 install():每个渲染系统插件在 install() 里 OGRE_NEW 一个具体 RenderSystem 子类并交给 Root。GL 插件就是标准样板:

// RenderSystems/GL/src/OgreGLPlugin.cpp:GLPlugin::install(v14.6.3 源码摘录,已删减)
    void GLPlugin::install()
    {
        mRenderSystem = OGRE_NEW GLRenderSystem();

        Root::getSingleton().addRenderSystem(mRenderSystem);
    }

登记、枚举与按名查找

addRenderSystem 只是 push_back;getAvailableRenderers 返回整张候选表;getRenderSystemByName 线性扫一遍比对名字:

// OgreMain/src/OgreRoot.cpp:Root::getAvailableRenderers/getRenderSystemByName/addRenderSystem(v14.6.3 源码摘录,已删减)
    const RenderSystemList& Root::getAvailableRenderers(void)
    {
        // Returns a vector of renders

        return mRenderers;

    }
    //-----------------------------------------------------------------------
    RenderSystem* Root::getRenderSystemByName(const String& name)
    {
        if (name.empty())
        {
            // No render system
            return NULL;
        }

        for (auto *rs : getAvailableRenderers())
        {
            if (rs->getName() == name)
                return rs;
        }

        // Unrecognised render system
        return NULL;
    }
    //-----------------------------------------------------------------------
    void Root::addRenderSystem(RenderSystem *newRend)
    {
        mRenderers.push_back(newRend);
    }

两个边界值得记住:空名直接返回 NULL(没有后端);未知名返回 NULL(查不到)。配置对话框(默认的 config 界面)就是拿 getAvailableRenderers 渲染下拉列表,再用 getRenderSystemByName 把用户选择翻译成后端指针。

setRenderSystem:切换 active

真正「换后端」的是 setRenderSystem。它最关键的语义是:换后端先 shutdown 旧后端,且对同一后端重复设置不触发任何动作:

// OgreMain/src/OgreRoot.cpp:Root::setRenderSystem/getRenderSystem(v14.6.3 源码摘录,已删减)
    void Root::setRenderSystem(RenderSystem* system)
    {
        // Sets the active rendering system
        // Can be called direct or will be called by
        //   standard config dialog

        // Is there already an active renderer?
        // If so, disable it and init the new one
        if( mActiveRenderer && mActiveRenderer != system )
        {
            mActiveRenderer->shutdown();
        }

        mActiveRenderer = system;
        // Tell scene managers
        if(mSceneManagerEnum)
            mSceneManagerEnum->setRenderSystem(system);

        if(RenderSystem::Listener* ls = RenderSystem::getSharedListener())
            ls->eventOccurred("RenderSystemChanged");
    }
    //-----------------------------------------------------------------------
    RenderSystem* Root::getRenderSystem(void)
    {
        // Gets the currently active renderer
        return mActiveRenderer;
    }

shutdown() 释放旧后端的渲染目标、深度缓冲池等资源(13.3 的 _cleanupDepthBuffers 就在其中)。切换后还要做两件同步:告诉场景管理器枚举换渲染系统、通知共享监听器 RenderSystemChanged 事件——保证场景中的材质、纹理等能重新适配新后端。

源码定位

  • OgreMain/include/OgreRoot.h :RenderSystemList typedef(53)、mRenderers(83)、mActiveRenderer(84)、addRenderSystem(278)、getAvailableRenderers(286)、getRenderSystemByName(294)、setRenderSystem(313)、getRenderSystem(317)
  • OgreMain/src/OgreRoot.cpp :getAvailableRenderers(429-435)、getRenderSystemByName(438-454)、addRenderSystem(479-482)、setRenderSystem(457-477)、getRenderSystem(484-489)
  • RenderSystems/GL/src/OgreGLPlugin.cpp :GLPlugin::install(44-49)

上游引用固定到 OGRE v14.6.3 源码 。

可运行产物:C++ 最小验证

下面复现候选表登记、按名查找与 active 切换。它与 src/15-1-renderer-select.cpp 逐字节一致:

// file: src/15-1-renderer-select.cpp
// tier: L1
// verify: clang++ -std=c++20 -I. src/15-1-renderer-select.cpp -o bin/15-1-renderer-select && ./bin/15-1-renderer-select
//
// 复现 Root 的渲染后端登记与选择(对应 OgreRoot.cpp 429-489 与 OgreRoot.h 53-84):
//   addRenderSystem 把后端压入 mRenderers;getAvailableRenderers 返回候选列表;
//   getRenderSystemByName 按名查找;setRenderSystem 更换 active,旧后端 shutdown;
//   GLPlugin::install 正是通过 addRenderSystem 注册 GLRenderSystem。
// 独立最小验证,非 OGRE 源码。
#include "verify.h"

#include <cstddef>
#include <string>
#include <vector>

namespace ogre_repro {

class RenderSystemRepro {
 public:
  explicit RenderSystemRepro(const std::string& name) : mName(name) {}
  const std::string& getName() const { return mName; }
  int mShutdownCount = 0;
  void shutdown() { ++mShutdownCount; }

 private:
  std::string mName;
};

class RootRepro {
 public:
  using RenderSystemList = std::vector<RenderSystemRepro*>;

  // 对应 Root::addRenderSystem
  void addRenderSystem(RenderSystemRepro* newRend) { mRenderers.push_back(newRend); }
  // 对应 Root::getAvailableRenderers
  const RenderSystemList& getAvailableRenderers() const { return mRenderers; }
  // 对应 Root::getRenderSystemByName
  RenderSystemRepro* 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:换后端时先 shutdown 旧后端
  void setRenderSystem(RenderSystemRepro* system) {
    if (mActiveRenderer && mActiveRenderer != system) {
      mActiveRenderer->shutdown();
    }
    mActiveRenderer = system;
  }
  // 对应 Root::getRenderSystem
  RenderSystemRepro* getRenderSystem() const { return mActiveRenderer; }
  size_t rendererCount() const { return mRenderers.size(); }

 private:
  RenderSystemList mRenderers;                     // 对应 Root::mRenderers
  RenderSystemRepro* mActiveRenderer = nullptr;    // 对应 Root::mActiveRenderer
};

}  // namespace ogre_repro

int main() {
  using namespace ogre_repro;

  RootRepro root;
  RenderSystemRepro gl("OpenGL Rendering Subsystem");
  RenderSystemRepro vulkan("Vulkan Rendering Subsystem");
  RenderSystemRepro metal("Metal Rendering Subsystem");

  // 插件 install() 时逐个 addRenderSystem 注册
  root.addRenderSystem(&gl);
  root.addRenderSystem(&vulkan);
  root.addRenderSystem(&metal);
  CHECK_EQ(root.rendererCount(), size_t(3));

  // getAvailableRenderers 返回候选列表(保持登记顺序)
  const auto& list = root.getAvailableRenderers();
  CHECK_EQ(list.size(), size_t(3));
  CHECK(list[0] == &gl);
  CHECK(list[2] == &metal);

  // 按名查找:命中、未命中、空名
  CHECK(root.getRenderSystemByName("Vulkan Rendering Subsystem") == &vulkan);
  CHECK(root.getRenderSystemByName("Missing") == nullptr);
  CHECK(root.getRenderSystemByName("") == nullptr);

  // 尚未选择任何后端
  CHECK(root.getRenderSystem() == nullptr);

  // 选择 GL:成为 active,不触发 shutdown
  root.setRenderSystem(&gl);
  CHECK(root.getRenderSystem() == &gl);
  CHECK_EQ(gl.mShutdownCount, 0);

  // 换后端:旧后端 shutdown 一次
  root.setRenderSystem(&vulkan);
  CHECK(root.getRenderSystem() == &vulkan);
  CHECK_EQ(gl.mShutdownCount, 1);

  // 重复设置同一后端:不重复 shutdown
  root.setRenderSystem(&vulkan);
  CHECK_EQ(vulkan.mShutdownCount, 0);
  CHECK_EQ(gl.mShutdownCount, 1);

  return lab::report("15-1 选择渲染后端");
}

本机实测(Apple clang 16,clang++ -std=c++20):编译通过(-Wall 零警告),断言 14/14 通过。

小结

  • RenderSystemList 就是 std::vector<RenderSystem*>,插件 install() 时 addRenderSystem 填表。
  • getAvailableRenderers 返回候选表,配置对话框靠它枚举;空名/未知名返回 NULL。
  • setRenderSystem 切换 active:不同后端先 shutdown() 旧的,同一后端重复设置无副作用。
  • 切换后同步 SceneManagerEnumerator 与共享监听器,广播 RenderSystemChanged。
  • getRenderSystem 只返回当前 active 指针,帧循环全部经由它。

阅读导航:上一节:14.3 多线程渲染 · 下一节:15.2 跨后端抽象 。

继续阅读

探索更多技术文章

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

全部文章 返回首页

「books」更多文章

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