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),无论先后都不污染深度缓冲。
天空跟随视点但仍有队列顺序
天空的渲染位置与当前相机有关,从而在观察者移动时维持远景效果。早绘制与晚绘制需要连同深度和队列阶段一起解释,雾是否作用还取决于材质和渲染方式。
移动相机并固定观察方向,观察天空位置。切换队列时记录清理、天空、普通几何的相对顺序,并单独测试雾。
源码定位
OgreMain/include/OgreSceneManager.h:SkyRenderer(471)、mSceneNode(490)、mEnabled(491)、mSkyRenderer(497)、SkyPlaneRenderer(499)、SkyBoxRenderer(511)、SkyDomeRenderer(524)OgreMain/src/OgreSkyRenderer.cpp:SkyRenderer构造(36)、setEnabled(48)、_updateRenderQueue(349-373)、postFindVisibleObjects(375)OgreMain/include/OgreRenderQueue.h:RENDER_QUEUE_SKIES_EARLY(57)、RENDER_QUEUE_SKIES_LATE(70)
上游引用固定到 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 布告板集合 。
继续阅读
探索更多技术文章
浏览归档,发现更多关于系统设计、工具链和工程实践的内容。