1.1 RenderSystem 抽象基类
卷一第 2 章见过 Root 怎样通过 mActiveRenderer 持有渲染系统;这里把镜头对准渲染系统本身——RenderSystem 这个抽象基类长什么样。它是 OGRE 能同时跑在 OpenGL、Vulkan、Metal、Direct3D 上的地基:一切后端无关的代码只认 RenderSystem 的接口,后端差异被挡在接口之外。
本章与站内既有内容的分工
《游戏引擎实现原理》(helio 四卷)从零实现过自己的后端抽象(Renderer 接口 + 平台实现);这里解析真实 OGRE 的 RenderSystem:接口怎么划分纯虚与默认实现、配置选项表怎么存。
RenderSystem:接口即契约
OgreRenderSystem.h 里的类声明很直白:
// OgreMain/include/OgreRenderSystem.h:RenderSystem 类定义(v14.6.3 源码摘录,已删减)
class _OgreExport RenderSystem : public RenderSysAlloc
{
public:
/** Default Constructor.
*/
RenderSystem();
/** Destructor.
*/
virtual ~RenderSystem();
/** Returns the name of the rendering system.
*/
virtual const String& getName(void) const = 0;
const ConfigOptionMap& getConfigOptions() const { return mOptions; }
virtual void setConfigOption(const String &name, const String &value) = 0;
virtual String validateConfigOptions(void) { return BLANKSTRING; }
三个纯虚、一个内联、一个有默认实现,正好构成「后端必须给什么、基类给什么」的边界:
| 方法 | 性质 | 含义 |
|---|---|---|
getName() | 纯虚 | 后端必须自报家门(“OpenGL 3+ Rendering Subsystem”、“Vulkan Rendering Subsystem”) |
setConfigOption() | 纯虚 | 后端自己解释配置项(如 VSync、Full Screen) |
getConfigOptions() | 内联 | 直接返回基类持有的 mOptions 选项表 |
validateConfigOptions() | 虚,默认空串 | 空串 = 无问题;后端按需覆盖做自家校验 |
关键的取舍:选项表 mOptions 由基类持有(getConfigOptions 返回它的引用),但写入 setConfigOption 是纯虚。也就是说 OGRE 让基类统一保管「有哪些选项、当前值是什么」,却把「选项如何生效」完全交给后端——后端可以在 setConfigOption 里做参数预检、换算,甚至记录脏状态。
后端的名字与会话
后端名字不是随便取的。GL3PlusRenderSystem::getName 返回 "OpenGL 3+ Rendering Subsystem",VulkanRenderSystem 返回 "Vulkan Rendering Subsystem"——这套名字在 RenderSystemList 里充当键,Root::getAvailableRenderers 按名字暴露给上层选择(15.1 会看到选择路径)。名字是纯虚,意味着每个后端都是独立的翻译层,不存在「通用 GL」这种模糊实现。
validateConfigOptions 的默认实现是 return BLANKSTRING(空串即无问题)——大多数后端连覆盖都不用,只有需要跨选项互检的后端(例如校验「Full Screen 必须配 Video Mode」)才写自己的版本。
源码定位
OgreMain/include/OgreRenderSystem.h:class _OgreExport RenderSystem : public RenderSysAlloc(174)、getName() const = 0(187)、getConfigOptions() const { return mOptions; }(210)、setConfigOption(...) = 0(246)、validateConfigOptions(void) { return BLANKSTRING; }(264)
上游引用固定到 OGRE v14.6.3 源码 。
可运行产物:C++ 最小验证
下面用纯 C++ 复现接口契约与多态分派。它与 src/01-1-render-system-interface.cpp 逐字节一致:
// file: src/01-1-render-system-interface.cpp
// tier: L1
// verify: clang++ -std=c++20 -I. src/01-1-render-system-interface.cpp -o bin/01-1-render-system-interface && ./bin/01-1-render-system-interface
//
// 复现 RenderSystem 抽象基类接口(对应 OgreRenderSystem.h 174-247):
// RenderSystem 声明纯虚 getName()/setConfigOption(),后端各自实现;
// getConfigOptions() 内联返回 mOptions 引用(基类持有选项表);
// validateConfigOptions() 有默认实现(空串 = 无问题),后端按需覆盖;
// GL3Plus/Vulkan 两个后端子类各自维护独立的选项表。
// 独立最小验证,非 OGRE 源码。
#include "verify.h"
#include <map>
#include <string>
namespace ogre_repro {
// 对应 OgreRenderSystem.h 的 ConfigOption(结构简化:name + currentValue)
struct ConfigOption {
std::string name;
std::string currentValue;
};
class RenderSystem {
public:
virtual ~RenderSystem() = default;
// 对应 getName() = 0:后端标识,纯虚
virtual const std::string& getName() const = 0;
// 对应 getConfigOptions():内联返回 mOptions 引用
const std::map<std::string, ConfigOption>& getConfigOptions() const { return mOptions; }
// 对应 setConfigOption() = 0:写入选项表,纯虚
virtual void setConfigOption(const std::string& name, const std::string& value) = 0;
// 对应 validateConfigOptions():默认返回空串表示无问题
virtual std::string validateConfigOptions() { return std::string(); }
protected:
std::map<std::string, ConfigOption> mOptions;
};
class GL3PlusRenderSystem : public RenderSystem {
public:
const std::string& getName() const override {
static const std::string name = "OpenGL 3+ Rendering Subsystem";
return name;
}
void setConfigOption(const std::string& name, const std::string& value) override {
mOptions[name].name = name;
mOptions[name].currentValue = value;
}
GL3PlusRenderSystem() { mOptions["VSync"].currentValue = "true"; }
std::string validateConfigOptions() override {
auto it = mOptions.find("VSync");
if (it != mOptions.end() && it->second.currentValue == "bogus")
return "Invalid VSync value";
return std::string();
}
};
class VulkanRenderSystem : public RenderSystem {
public:
const std::string& getName() const override {
static const std::string name = "Vulkan Rendering Subsystem";
return name;
}
void setConfigOption(const std::string& name, const std::string& value) override {
mOptions[name].name = name;
mOptions[name].currentValue = value;
}
VulkanRenderSystem() {
mOptions["Full Screen"].currentValue = "false";
mOptions["VSync"].currentValue = "true";
}
std::string validateConfigOptions() override {
if (!mOptions.count("Full Screen")) return "Missing Full Screen option";
return std::string();
}
};
} // namespace ogre_repro
int main() {
using namespace ogre_repro;
// 基类指针多态:getName 分派到各自后端
RenderSystem* rs = new GL3PlusRenderSystem();
CHECK(rs->getName() == "OpenGL 3+ Rendering Subsystem");
CHECK(rs->validateConfigOptions().empty());
rs->setConfigOption("VSync", "true");
CHECK(rs->getConfigOptions().at("VSync").currentValue == "true");
// 后端自定义校验:非法 VSync 值被拒绝
rs->setConfigOption("VSync", "bogus");
CHECK(rs->validateConfigOptions() == "Invalid VSync value");
delete rs;
// 第二个后端:独立的选项表与校验
RenderSystem* vk = new VulkanRenderSystem();
CHECK(vk->getName() == "Vulkan Rendering Subsystem");
CHECK(vk->validateConfigOptions().empty());
CHECK(vk->getConfigOptions().at("Full Screen").currentValue == "false");
const auto& opts = vk->getConfigOptions();
CHECK(opts.count("VSync") == 1);
// getConfigOptions 返回同一份 mOptions 的引用,修改可见
vk->setConfigOption("Full Screen", "true");
CHECK(vk->getConfigOptions().at("Full Screen").currentValue == "true");
delete vk;
return lab::report("01-1 RenderSystem 抽象基类接口");
}
本机实测(Apple clang 16,clang++ -std=c++20):编译通过(-Wall 零警告),断言 9/9 通过。
小结
RenderSystem是渲染后端的抽象基类:纯虚接口定义「后端必须做什么」,内联方法提供「基类统一做什么」。mOptions选项表由基类持有,但写入setConfigOption是纯虚——后端负责解释与生效。validateConfigOptions默认返回空串(无问题),后端按需覆盖做跨选项校验。- 一切上层代码只依赖
RenderSystem接口,后端差异被隔离在各自的翻译层里。
阅读导航:上一节:卷一目录 · 下一节:1.2 渲染状态管理 。
继续阅读
探索更多技术文章
浏览归档,发现更多关于系统设计、工具链和工程实践的内容。