《OGRE 3D 渲染引擎原理与架构》2.3 Root 析构与清理顺序

Root 的清理是构造的镜像:shutdown 先停工作队列、关场景管理器、卸插件、清资源组,最后打印 OGRE Shutdown 横幅;析构再按创建倒序释放各管理器,先销毁依赖别人的,后销毁基础。清理顺序错误会踩到悬空引用。lab 用 C++ 复现 shutdown 五步与关键字齐全断言。

2.3 Root 析构与清理顺序

构造有顺序,清理同样有顺序,而且顺序必须与构造相反。OgreRoot.cpp 里 shutdown() 显式调用,~Root() 里则按创建倒序 reset 各管理器。

shutdown():五个关键环节

// OgreMain/src/OgreRoot.cpp:Root::shutdown(v14.6.3 源码摘录,已删减)
    void Root::shutdown(void)
    {
        if(mActiveRenderer)
            mActiveRenderer->_setViewport(NULL);

        // Since background thread might be access resources,
        // ensure shutdown before destroying resource manager.
        mWorkQueue->shutdown();

        if(mSceneManagerEnum)
            mSceneManagerEnum->shutdownAll();
        if(mFirstTimePostWindowInit)
        {
            shutdownPlugins();
            mParticleManager->removeAllTemplates(true);
            mFirstTimePostWindowInit = false;
        }
        mSceneManagerEnum.reset();
        mShadowTextureManager.reset();

        ShadowVolumeExtrudeProgram::shutdown();
        ResourceGroupManager::getSingleton().shutdownAll();

        // Destroy pools
        ConvexBody::_destroyPool();

        mIsInitialised = false;

        LogManager::getSingleton().logMessage("*-*-* OGRE Shutdown");
    }

顺序的每一步都有原因:

  1. mWorkQueue->shutdown() 最先——注释直说:「后台线程可能正在访问资源,必须在销毁资源管理器之前停掉它」。后台资源加载线程不先停,后面删资源会踩悬空引用;
  2. shutdownAll() 场景管理器——场景里挂着可移动对象与渲染队列,先统一关;
  3. shutdownPlugins() 卸插件——插件可能注册了场景类型、编解码器,后注册的先注销;
  4. ResourceGroupManager::shutdownAll()——把资源组从内存里清空;
  5. "*-*-* OGRE Shutdown" 横幅——与构造时的 Initialising 呼应,标记引擎正式关停。

注意 mFirstTimePostWindowInit 这个标志:插件卸载只在「窗口已初始化过」时才执行,防止从未初始化就关停时重复卸载。

~Root():按创建倒序释放

析构函数不重复调 shutdown(shutdown 已被用户或 Root 析构链调用过),而是补上「按创建倒序 reset 管理器」的收尾:

// OgreMain/src/OgreRoot.cpp:~Root(v14.6.3 源码摘录,已删减)
    Root::~Root()
    {
        shutdown();

#if OGRE_NO_DDS_CODEC == 0
        DDSCodec::shutdown();
#endif
        ...
        mCompositorManager.reset(); // needs rendersystem
        mParticleManager.reset(); // may use plugins
        mMaterialManager.reset(); // may use GPU program manager
        mGpuProgramManager.reset(); // may use plugins
        ...

行内注释把依赖关系写得一清二楚:Compositor 需要渲染系统,粒子可能用插件,材质可能用 GPU 程序管理器。所以析构顺序与构造完全镜像——最后构造的先析构。这就是为什么构造时先建 LogManager(最底层),析构时它最后走。

清理顺序的通用法则

OGRE 的清理顺序可以抽象成两条法则,适用于任何分层系统:

  1. 依赖者先销毁,被依赖者后销毁:窗口依赖渲染系统,渲染系统依赖窗口系统——先关窗口,再关渲染后端;
  2. 后台活动先停止:一切会并发访问共享状态的线程,在共享状态销毁前停掉。

这两条法则在本系列反复出现:卷三的分页流式加载、卷四的资源后台队列,清理顺序都是同一套路。违反法则的典型症状是「析构时崩溃但运行正常」——因为悬空引用只在清理路径上被触碰。

退出顺序由资源依赖决定

Root 的关停先停 WorkQueue,再处理场景和资源。析构后续才卸载插件。只等待 worker 退出无法证明主线程任务已经执行,回调中捕获的 ResourcePtr 也会延长引用寿命。

在销毁目标和后端之前完成或处理持有资源的主线程任务。用 场景样例 对照已完成的资源回调和关停时未执行的标记任务。

持有对象的退出依赖

flowchart TD
  App["宿主停止产生新资源任务"] --> Drain["等待已提交的准备并处理主线程任务"]
  Drain --> Ref["释放实体与持有资源的回调"]
  Ref --> S["Root::shutdown"]
  S --> Q["WorkQueue 停止并 join worker"]
  Q --> M["关停场景管理器"]
  M --> P["插件 shutdown"]
  P --> R["清理场景及资源组"]
  R --> D["Root 析构后续卸载插件"]

源码定位

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

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

下面复现 shutdown 的五步清理顺序。它与 src/02-3-shutdown-order.cpp 逐字节一致:

// file: src/02-3-shutdown-order.cpp
// tier: L1
// verify: clang++ -std=c++20 -I. src/02-3-shutdown-order.cpp -o bin/02-3-shutdown-order && ./bin/02-3-shutdown-order
//
// 复现 OgreRoot::shutdown 与 ~Root 的清理顺序:
//   工作队列 → 场景管理器 → 插件 → 资源组 → 日志横幅
// 与析构时「后创建的先销毁」的倒序。独立最小验证,非 OGRE 源码。
#include "verify.h"

#include <string>
#include <vector>

namespace ogre_repro {

class RootRepro {
 public:
  std::vector<std::string> teardown;

  // 对应 OgreRoot.cpp:shutdown()
  void shutdown() {
    teardown.push_back("workQueue.shutdown");         // 后台线程先停
    teardown.push_back("sceneManagerEnum.shutdownAll");
    teardown.push_back("shutdownPlugins");
    teardown.push_back("resourceGroup.shutdownAll");
    teardown.push_back("*-*-* OGRE Shutdown");        // 日志横幅
  }

  // 对应 ~Root:按创建倒序释放(后创建的先 reset)
  ~RootRepro() {
    if (teardown.empty()) shutdown();
  }
};

}  // namespace ogre_repro

int main() {
  using namespace ogre_repro;

  RootRepro root;
  root.shutdown();

  CHECK(root.teardown[0] == "workQueue.shutdown");
  CHECK(root.teardown.back() == "*-*-* OGRE Shutdown");
  CHECK_EQ(root.teardown.size(), 5u);

  // 生命周期语义:后台线程先停,之后才能安全销毁资源管理器。
  // 每个子系统在 teardown 日志中按序出现,且关键环节齐全。
  std::vector<std::string> keywords = {"workQueue", "scene", "Plugins",
                                       "resourceGroup", "Shutdown"};
  CHECK_EQ(keywords.size(), root.teardown.size());
  for (size_t i = 0; i < keywords.size(); ++i) {
    const bool present = root.teardown[i].find(keywords[i]) != std::string::npos;
    CHECK(present);
  }

  for (const auto& s : root.teardown) std::printf("%s\n", s.c_str());
  return lab::report("02-3 Root 析构与清理顺序");
}

本机实测(Apple clang 16,clang++ -std=c++20):编译通过,断言 9/9 通过,打印五步清理序列。

小结

  • shutdown 五步:停工作队列 → 关场景 → 卸插件 → 清资源组 → 关停横幅。
  • 析构与构造镜像:最后构造的先析构,行内注释标注依赖关系。
  • 两条通用法则:依赖者先销毁;后台活动先停止。
  • 后台线程必须在资源销毁前停掉,否则踩悬空引用。

阅读导航:上一节:2.2 Root 启动:选后端、建场景、跑一帧 · 下一节:3.1 OgrePlugin 接口与插件职责 。

继续阅读

探索更多技术文章

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

全部文章 返回首页

「books」更多文章

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