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:RenderSystemListtypedef(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 跨后端抽象 。
继续阅读
探索更多技术文章
浏览归档,发现更多关于系统设计、工具链和工程实践的内容。