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 的核心职责有五块:
- 场景图:创建/销毁
SceneNode,维护根节点与全节点遍历; - 可移动对象:创建/销毁各类
MovableObject(实体、灯光、相机、粒子等),并维护它们的注册表; - 可见性:视锥剔除、可见对象收集,交给渲染队列;
- 场景内容:天空、雾、阴影、渲染环境(
setSkyBox/setFog/setShadowTechnique); - 查询:各类场景查询(
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 自己不知道任何具体后端类型。
源码定位
OgreMain/include/OgreSceneManager.h:SceneManager类、SceneManagerFactory工厂接口OgreMain/src/OgreSceneManager.cpp:SceneManager构造与析构(建根节点、注册对象表)OgreMain/src/OgreSceneManagerEnumerator.h:按类型名创建/销毁实例OgreMain/src/OgreRoot.cpp:Root::createSceneManager(转发给枚举器)
上游引用固定到 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 与场景图 。
继续阅读
探索更多技术文章
浏览归档,发现更多关于系统设计、工具链和工程实践的内容。