《OGRE 3D 渲染引擎原理与架构》5.1 SceneManager 职责与工厂

SceneManager 是场景内容的组织者:建节点、建可移动对象、决定内容如何被渲染。多后端靠 SceneManagerFactory 抽象,枚举器按类型名创建实例。lab 用 C++ 复现工厂注册、按类型创建与未注册抛异常的语义。

5.1 SceneManager 职责与工厂

SceneManager 是整个场景内容的中枢。Root 负责引擎生命周期与插件装载,渲染系统负责把东西画出来,而「场景里有什么、节点怎么组织、可见性怎么判定」全部归 SceneManager。它是 OGRE 分层里最接近「游戏世界」概念的一层——只不过它不拥有逻辑,只拥有内容与结构。

职责划分

OgreSceneManager.h 开头就用注释把职责列得很清楚。这一大段注释本身就是阅读地图:

// OgreMain/include/OgreSceneManager.h:类注释(v14.6.3 教学示意,参照上游同名实现,已删减)
    /** Class for managing all the objects in a scene.
        @remarks
            Manages the scene graph and all movable objects in the scene.
            ...
    */

拆开看,SceneManager 的核心职责有五块:

  1. 场景图:创建/销毁 SceneNode,维护根节点与全节点遍历;
  2. 可移动对象:创建/销毁各类 MovableObject(实体、灯光、相机、粒子等),并维护它们的注册表;
  3. 可见性:视锥剔除、可见对象收集,交给渲染队列;
  4. 场景内容:天空、雾、阴影、渲染环境(setSkyBox/setFog/setShadowTechnique);
  5. 查询:各类场景查询(createRayQuery 等)。

重要的是,内容如何被渲染(渲染队列怎么排、后端怎么画)不由 SceneManager 决定——它把可见对象交给渲染系统。这个「组织内容 vs 执行渲染」的分工,在卷三讲渲染队列时还会深挖。

SceneManager 是多后端的抽象

OGRE 支持多种场景组织策略:通用场景管理器(SMT_DEFAULT)、八叉树(OctreeSceneManager)、遮挡剔除(PCZSceneManager)、二进制空间分割(BSP)。场景内容的组织方式随后端变化,但接口必须统一——上层代码写一次,换后端不用改。

这个抽象靠工厂模式落地。OgreSceneManager.h 的 SceneManagerFactory 提供创建契约和默认销毁实现:

// OgreMain/include/OgreSceneManager.h:SceneManagerFactory(v14.6.3 教学示意,参照上游同名实现,已删减)
    class _OgreExport SceneManagerFactory
    {
    public:
        virtual ~SceneManagerFactory() {}
        /** Get the name of the type of scene manager this factory creates. */
        virtual const String& getTypeName(void) const = 0;
        /** Create an instance of the scene manager. */
        virtual SceneManager* createInstance(const String& instanceName) = 0;
        /** Destroy an instance of the scene manager. */
        virtual void destroyInstance(SceneManager* instance) { delete instance; }
    };

三个方法构成完整契约:getTypeName 报类型名,createInstance 造实例,destroyInstance 回收。SceneManagerEnumerator(在 Root 构造时初始化)持有工厂表,createSceneManager(typeName, instanceName) 按类型名查到工厂再创建。Root::createSceneManager 只是把调用转发给枚举器——Root 自己不知道任何具体后端类型。

源码定位

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

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

下面复现工厂注册与按类型创建:注册 DefaultSceneManagerFactory,用枚举器按类型名创建实例,未注册的类型抛异常。它与 src/05-1-scene-manager-factory.cpp 逐字节一致:

// file: src/05-1-scene-manager-factory.cpp
// tier: L1
// verify: clang++ -std=c++20 -I. src/05-1-scene-manager-factory.cpp -o bin/05-1-scene-manager-factory && ./bin/05-1-scene-manager-factory
//
// 复现 OgreSceneManager.h 的 SceneManagerFactory 与工厂注册/按类型创建。
// 对应 SMT_DEFAULT 与 SceneManagerEnumerator::createSceneManager。
// 独立最小验证,非 OGRE 源码。
#include "verify.h"

#include <map>
#include <memory>
#include <stdexcept>
#include <string>

namespace ogre_repro {

// 对应 OgreSceneManager.h:场景管理器基类
class SceneManager {
 public:
  std::string instanceName;
  explicit SceneManager(const std::string& n) : instanceName(n) {}
  virtual ~SceneManager() = default;
  virtual const std::string& getTypeName() const = 0;
};

// 通用场景管理器(SMT_DEFAULT)
class DefaultSceneManager : public SceneManager {
 public:
  using SceneManager::SceneManager;
  const std::string& getTypeName() const override {
    static const std::string t = "DefaultSceneManager";
    return t;
  }
};

// 对应 SceneManagerFactory:getTypeName/createInstance/destroyInstance
class SceneManagerFactory {
 public:
  virtual ~SceneManagerFactory() = default;
  virtual const std::string& getTypeName() const = 0;
  virtual SceneManager* createInstance(const std::string& instanceName) = 0;
};

class DefaultSceneManagerFactory : public SceneManagerFactory {
 public:
  const std::string& getTypeName() const override {
    static const std::string t = "DefaultSceneManager";
    return t;
  }
  SceneManager* createInstance(const std::string& name) override {
    return new DefaultSceneManager(name);
  }
};

// 对应 SceneManagerEnumerator:按类型名创建
class SceneManagerEnumerator {
 public:
  void addFactory(SceneManagerFactory* f) { factories[f->getTypeName()] = f; }
  SceneManager* createSceneManager(const std::string& typeName,
                                   const std::string& instanceName) {
    auto it = factories.find(typeName);
    if (it == factories.end())
      throw std::runtime_error("No factory for " + typeName);
    return it->second->createInstance(instanceName);
  }

 private:
  std::map<std::string, SceneManagerFactory*> factories;
};

}  // namespace ogre_repro

int main() {
  using namespace ogre_repro;

  DefaultSceneManagerFactory factory;
  CHECK(factory.getTypeName() == "DefaultSceneManager");

  SceneManagerEnumerator enumerator;
  enumerator.addFactory(&factory);

  // 按类型名创建,实例名透传
  std::unique_ptr<SceneManager> sm(enumerator.createSceneManager(
      "DefaultSceneManager", "MainScene"));
  CHECK(sm != nullptr);
  CHECK(sm->getTypeName() == "DefaultSceneManager");
  CHECK(sm->instanceName == "MainScene");

  // 未注册的类型名抛异常
  bool threw = false;
  try {
    enumerator.createSceneManager("OctreeSceneManager", "x");
  } catch (const std::runtime_error&) {
    threw = true;
  }
  CHECK(threw);

  return lab::report("05-1 场景管理:SceneManager 与工厂");
}

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

小结

  • SceneManager 管理场景图、可移动对象、可见性、场景内容与查询——组织内容,不执行渲染。
  • 多后端靠 SceneManagerFactory 抽象,枚举器按类型名创建实例。
  • Root 不关心具体后端,只把 createSceneManager 转发给枚举器。
  • 工厂三件套 getTypeName/createInstance/destroyInstance 贯穿全引擎的可替换机制。

阅读导航:上一节:4.3 Ray 与相交测试 · 下一节:5.2 SceneNode 与场景图 。

继续阅读

探索更多技术文章

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

全部文章 返回首页

「books」更多文章

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