《OGRE 3D 渲染引擎原理与架构》1.1 RenderSystem 抽象基类

OGRE 的 RenderSystem 是渲染后端的抽象基类:getName/setConfigOption 为纯虚、getConfigOptions 内联返回基类持有的选项表、validateConfigOptions 有默认空串实现,GL3Plus/Vulkan 各自实现接口并维护独立选项表。lab 用 C++ 复现接口契约与多态分派。

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 渲染状态管理 。

继续阅读

探索更多技术文章

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

全部文章 返回首页

「books」更多文章

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