《OGRE 3D 渲染引擎原理与架构》11.3 天空渲染实现

天空渲染由 SkyRenderer 类族实现:它同时是 SceneManager 的监听器,setEnabled 时挂进监听器列表,postFindVisibleObjects 把天空节点平移到相机派生位置(恒定距离),再更新渲染队列。drawFirst 决定挂 RENDER_QUEUE_SKIES_EARLY(5) 还是 LATE(90)。lab 复现启用开关、队列选择与跟随相机。

11.3 天空渲染实现

11.1 只讲了参数,天空真正进帧靠的是 SkyRenderer 类族。它的设计很巧妙:SkyRenderer 同时是 SceneManager::Listener,在 postFindVisibleObjects 这个回调里把天空节点搬到相机脚下、再把天空对象塞进渲染队列。这一节解析这个「监听器 + 恒定距离 + 队列选择」的实现骨架。

本章与站内既有内容的分工

helio 四卷的背景贴图直接画在帧缓冲上,不走渲染队列;ogre-render 卷讲过渲染队列分组但没谈天空。这里解析真实 OGRE 的 SceneManager::SkyRenderer(OgreSceneManager.h)与其在 OgreSkyRenderer.cpp 的实现:setEnabled 怎么挂监听器、postFindVisibleObjects 怎么让天空恒距、RENDER_QUEUE_SKIES_EARLY/LATE 怎么被选用。

SkyRenderer:天空的通用外壳

SkyRenderer 嵌套在 SceneManager 里,继承 Listener,持有 mSceneNode 与 mEnabled 两个公开成员。三种具体天空(Plane/Box/Dome)都派生于它:

// OgreMain/include/OgreSceneManager.h:SkyRenderer(v14.6.3 源码摘录,已删减)
        class _OgreExport SkyRenderer : public Listener
        {
        protected:
            SceneManager* mSceneManager;
            virtual void _updateRenderQueue(RenderQueue* queue) = 0;
        public:
            ...
            SkyRenderer(SceneManager* owner);
            virtual ~SkyRenderer();

            SceneNode* mSceneNode;
            bool mEnabled;

            void setEnabled(bool enable);
            void postFindVisibleObjects(SceneManager* source, IlluminationRenderStage irs, Viewport* vp) override;
        };

        std::unique_ptr<SkyRenderer> mSkyRenderer;

SceneManager 只保留一个 std::unique_ptr<SkyRenderer> mSkyRenderer——这就是三种天空互斥的底层原因:同一时刻只有一个具体 renderer 被创建并持有。setEnabled 的核心动作是挂/摘监听器:

// OgreMain/src/OgreSkyRenderer.cpp:SkyRenderer::setEnabled(v14.6.3 源码摘录,已删减)
void SceneManager::SkyRenderer::setEnabled(bool enable)
{
    if(enable == mEnabled) return;
    mEnabled = enable;
    enable ? mSceneManager->addListener(this) : mSceneManager->removeListener(this);
}

启用即把 this 加进 SceneManager 的监听器列表,禁用即摘除。这样天空的每帧更新完全复用了 SceneManager 既有的监听器回调机制,不侵入渲染主循环。

postFindVisibleObjects:恒定距离的魔法

天空「无穷远」的错觉来自一个关键动作:每帧把天空节点平移到相机位置。相机走到哪,天空就跟到哪,两者相对距离永远不变:

// OgreMain/src/OgreSkyRenderer.cpp:SkyRenderer::postFindVisibleObjects(v14.6.3 源码摘录,已删减)
void SceneManager::SkyRenderer::postFindVisibleObjects(SceneManager* source, IlluminationRenderStage irs,
                                                       Viewport* vp)
{
    // Queue skies, if viewport seems it
    if (!vp->getSkiesEnabled() || irs == IRS_RENDER_TO_TEXTURE)
        return;

    if(!mEnabled || !mSceneNode)
        return;

    // Update nodes
    // Translate the box by the camera position (constant distance)
    mSceneNode->setPosition(vp->getCamera()->getDerivedPosition());
    _updateRenderQueue(source->getRenderQueue());
}

三个早期返回各守一道闸:视口没开天空、正在渲染阴影纹理、天空没启用或节点没建——都直接跳过。然后调用具体 renderer 的 _updateRenderQueue(纯虚函数),把各自的实体/ManualObject 塞进队列。注意天空只在 IRS_RENDER_TO_TEXTURE 之外的主渲染里出现,避免把天空画进阴影贴图。

队列选择:EARLY 还是 LATE

drawFirst 参数翻译成渲染队列组号:true 走 RENDER_QUEUE_SKIES_EARLY(5)(先画、通常不更新深度缓冲),false 走 RENDER_QUEUE_SKIES_LATE(90)(后画,省一次天空深度测试但要求距离足够大)。两者在 OgreRenderQueue.h 里相邻定义:

// OgreMain/include/OgreRenderQueue.h:RenderQueueGroupID(v14.6.3 源码摘录,已删减)
        /// First queue (after backgrounds), used for skyboxes if rendered first
        RENDER_QUEUE_SKIES_EARLY = 5,
        ...
        /// Used for skyboxes if rendered last
        RENDER_QUEUE_SKIES_LATE = 90,

_setSkyPlane/_setSkyBox/_setSkyDome 接受 uint8 renderQueue 参数(默认 RENDER_QUEUE_SKIES_EARLY),把队列号透传给 renderer 的 create。天空材质被强制 setDepthWriteEnabled(false),无论先后都不污染深度缓冲。

天空跟随视点但仍有队列顺序

天空的渲染位置与当前相机有关,从而在观察者移动时维持远景效果。早绘制与晚绘制需要连同深度和队列阶段一起解释,雾是否作用还取决于材质和渲染方式。

移动相机并固定观察方向,观察天空位置。切换队列时记录清理、天空、普通几何的相对顺序,并单独测试雾。

源码定位

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

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

下面用纯 C++ 复现天空渲染的启用开关、队列选择与跟随相机。它与 src/11-3-sky-rendering.cpp 逐字节一致:

// file: src/11-3-sky-rendering.cpp
// tier: L1
// verify: clang++ -std=c++20 -I. src/11-3-sky-rendering.cpp -o bin/11-3-sky-rendering && ./bin/11-3-sky-rendering
//
// 复现天空渲染的实现骨架(对应 OgreSceneManager.h 471/497、OgreSkyRenderer.cpp 48/375/387、OgreRenderQueue.h 57/70):
//   SkyRenderer 持 SceneNode 与 mEnabled;setEnabled 时把 renderer 挂进监听器;
//   postFindVisibleObjects 把天空节点平移到相机派生位置(恒定距离),再更新渲染队列;
//   drawFirst 决定挂 RENDER_QUEUE_SKIES_EARLY(5) 还是 RENDER_QUEUE_SKIES_LATE(90)。
// 独立最小验证,非 OGRE 源码。
#include "verify.h"

#include <cstdint>

namespace ogre_repro {

// 对应 OgreRenderQueue.h 52 的 RenderQueueGroupID 节选
enum RenderQueueGroupID : uint8_t {
  RENDER_QUEUE_SKIES_EARLY = 5,  // OgreRenderQueue.h 57
  RENDER_QUEUE_SKIES_LATE = 90   // OgreRenderQueue.h 70
};

struct Vec3 {
  float x = 0.f;
  float y = 0.f;
  float z = 0.f;
  Vec3() = default;
  Vec3(float px, float py, float pz) : x(px), y(py), z(pz) {}
};

// 对应 OgreSceneManager.h 471:SkyRenderer(简化)
class SkyRenderer {
 public:
  SkyRenderer() : mSceneNode(0.f, 0.f, 0.f), mEnabled(false) {}
  // 对应 OgreSkyRenderer.cpp 48:setEnabled
  void setEnabled(bool enable) { mEnabled = enable; }
  bool isEnabled() const { return mEnabled; }
  // 对应 OgreSkyRenderer.cpp 375:postFindVisibleObjects 的核心动作
  // 把天空节点平移到相机位置,保持恒定距离(无穷远错觉)
  void followCamera(const Vec3& camPos) { mSceneNode = camPos; }
  // drawFirst 决定队列:先画走 EARLY,后画走 LATE
  uint8_t queueFor(bool drawFirst) const {
    return drawFirst ? RENDER_QUEUE_SKIES_EARLY : RENDER_QUEUE_SKIES_LATE;
  }

  Vec3 mSceneNode;  // 对应 OgreSceneManager.h 490:mSceneNode

 private:
  bool mEnabled;  // 对应 OgreSceneManager.h 491:mEnabled
};

}  // namespace ogre_repro

int main() {
  using namespace ogre_repro;

  // 队列组常量
  CHECK_EQ(RENDER_QUEUE_SKIES_EARLY, 5);
  CHECK_EQ(RENDER_QUEUE_SKIES_LATE, 90);

  SkyRenderer sky;
  CHECK(!sky.isEnabled());

  // 启用天空:setSkyBox(enable=true) 内部创建 renderer 并启用
  sky.setEnabled(true);
  CHECK(sky.isEnabled());

  // drawFirst=true 走 EARLY(先画、不更新深度缓冲),false 走 LATE(后画)
  CHECK_EQ(sky.queueFor(true), RENDER_QUEUE_SKIES_EARLY);
  CHECK_EQ(sky.queueFor(false), RENDER_QUEUE_SKIES_LATE);

  // 天空跟随相机:相机移动后天空节点仍与相机重合
  sky.followCamera(Vec3(100.f, 50.f, 0.f));
  CHECK_EQ(sky.mSceneNode.x, 100.f);
  CHECK_EQ(sky.mSceneNode.y, 50.f);
  sky.followCamera(Vec3(-30.f, 20.f, 8.f));
  CHECK_EQ(sky.mSceneNode.x, -30.f);
  CHECK_EQ(sky.mSceneNode.z, 8.f);

  // 关闭天空:setSkyRenderingEnabled(false) 把 renderer 停用
  sky.setEnabled(false);
  CHECK(!sky.isEnabled());

  return lab::report("11-3 天空渲染实现");
}

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

小结

  • SkyRenderer : Listener 是三种天空的通用外壳,持有 mSceneNode 与 mEnabled。
  • SceneManager 只持一个 unique_ptr<SkyRenderer>,三种天空因此互斥。
  • setEnabled 即挂/摘监听器,天空更新完全复用监听器回调机制。
  • postFindVisibleObjects 把天空节点平移到相机派生位置——恒定距离制造无穷远错觉。
  • 天空材质强制 setDepthWriteEnabled(false);drawFirst 决定走 EARLY(5) 还是 LATE(90)。

阅读导航:上一节:11.2 雾模式 · 下一节:12.1 布告板集合 。

继续阅读

探索更多技术文章

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

全部文章 返回首页

「books」更多文章

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