11.1 天空盒与天空平面
场景的背景通常不是几何体,而是天空——一个跟着相机走的「无穷远」外壳。OGRE 给三种选择:setSkyBox(六面盒子)、setSkyPlane(沿地面铺开的平面)、setSkyDome(五面立方体 + 曲率纹理)。这一节看三者的生成参数结构与其在 SceneManager 里的配置入口,11.3 再看真正的渲染实现。
本章与站内既有内容的分工
helio 四卷的背景是一张静态大贴图,没有可配置的天空体系;cg 三卷讲了天空穹顶纹理的数学原理。这里解析真实 OGRE 的 SkyBoxGenParameters/SkyPlaneGenParameters/SkyDomeGenParameters 三个参数结构,以及 SceneManager::setSkyBox/setSkyPlane/setSkyDome 的签名。11.2 讲雾,11.3 把天空放进渲染队列。
三种天空的生成参数
SceneManager 里三个结构分别描述三种天空。天空盒最简单——只有一个距离:
// OgreMain/include/OgreSceneManager.h:SkyBoxGenParameters(v14.6.3 源码摘录,已删减)
struct SkyBoxGenParameters
{
Real skyBoxDistance;
};
天空平面参数多:scale 决定平面单位尺寸、tiling 决定纹理重复、bow 决定下凹弧度(>0 生成弯曲天空平面)、xsegments/ysegments 决定细分:
// OgreMain/include/OgreSceneManager.h:SkyPlaneGenParameters(v14.6.3 源码摘录,已删减)
struct SkyPlaneGenParameters
{
Real skyPlaneScale;
Real skyPlaneTiling;
Real skyPlaneBow;
int skyPlaneXSegments;
int skyPlaneYSegments;
};
天空穹顶是「5 面立方体」的变体:curvature 控制纹理曲率错觉强度、tiling 控制纹理重复、distance 控制到相机距离,外加两档细分与一个保留段数:
// OgreMain/include/OgreSceneManager.h:SkyDomeGenParameters(v14.6.3 源码摘录,已删减)
struct SkyDomeGenParameters
{
Real skyDomeCurvature;
Real skyDomeTiling;
Real skyDomeDistance;
int skyDomeXSegments;
int skyDomeYSegments;
int skyDomeYSegments_keep;
};
| 参数 | 天空盒 | 天空平面 | 天空穹顶 |
|---|---|---|---|
| 距离/尺寸 | distance | scale | distance |
| 纹理 | — | tiling | tiling |
| 曲率 | — | bow | curvature |
| 细分 | — | x/ySegments | x/ySegments + ySegments_keep |
三个配置入口
SceneManager 暴露三个 setSky* 方法,每个都是「开关 + 材质 + 各自参数」的组合。天空平面需要额外给一个 Plane 描述平面方程:
// OgreMain/include/OgreSceneManager.h:setSkyPlane(v14.6.3 源码摘录,已删减)
void setSkyPlane(
bool enable,
const Plane& plane, const String& materialName, Real scale = 1000,
Real tiling = 10, bool drawFirst = true, Real bow = 0,
int xsegments = 1, int ysegments = 1,
const String& groupName = ResourceGroupManager::AUTODETECT_RESOURCE_GROUP_NAME);
天空盒与天空穹顶的入口类似,默认距离分别是 5000 与 4000:
// OgreMain/include/OgreSceneManager.h:setSkyBox/setSkyDome(v14.6.3 源码摘录,已删减)
void setSkyBox(
bool enable, const String& materialName, Real distance = 5000,
bool drawFirst = true, const Quaternion& orientation = Quaternion::IDENTITY,
const String& groupName = ResourceGroupManager::AUTODETECT_RESOURCE_GROUP_NAME);
...
void setSkyDome(
bool enable, const String& materialName, Real curvature = 10,
Real tiling = 8, Real distance = 4000, bool drawFirst = true,
const Quaternion& orientation = Quaternion::IDENTITY,
int xsegments = 16, int ysegments = 16, int ysegments_keep = -1,
const String& groupName = ResourceGroupManager::AUTODETECT_RESOURCE_GROUP_NAME);
drawFirst 决定天空进 RENDER_QUEUE_SKIES_EARLY(5) 还是 RENDER_QUEUE_SKIES_LATE(90)(11.3 展开);orientation 允许把天空整体旋转(改变星象方位)。三个入口最终都会创建对应的 Sky*Renderer,并保持互斥——同一时刻只有一个 renderer 生效。
源码定位
OgreMain/include/OgreSceneManager.h:SkyDomeGenParameters(288)、SkyPlaneGenParameters(298)、SkyBoxGenParameters(307)、setSkyPlane(1901)、setSkyBox(1974)、setSkyDome(2059)
上游引用固定到 OGRE v14.6.3 源码 。
可运行产物:C++ 最小验证
下面用纯 C++ 复现三种天空的生成参数结构与互斥切换。它与 src/11-1-sky-box-plane.cpp 逐字节一致:
// file: src/11-1-sky-box-plane.cpp
// tier: L1
// verify: clang++ -std=c++20 -I. src/11-1-sky-box-plane.cpp -o bin/11-1-sky-box-plane && ./bin/11-1-sky-box-plane
//
// 复现三种天空的生成参数(对应 OgreSceneManager.h 288/298/307/1901/1974/2059):
// SkyBoxGenParameters 只含 distance;SkyPlaneGenParameters 含 scale/tiling/bow/segments;
// SkyDomeGenParameters 含 curvature/tiling/distance/segments;
// setSkyBox / setSkyPlane / setSkyDome 分别把参数存进对应结构(三种天空互斥,后设覆盖前设)。
// 独立最小验证,非 OGRE 源码。
#include "verify.h"
#include <cstdint>
namespace ogre_repro {
// 对应 OgreSceneManager.h 307:SkyBoxGenParameters
struct SkyBoxGenParameters {
float skyBoxDistance;
};
// 对应 OgreSceneManager.h 298:SkyPlaneGenParameters
struct SkyPlaneGenParameters {
float skyPlaneScale;
float skyPlaneTiling;
float skyPlaneBow;
int skyPlaneXSegments;
int skyPlaneYSegments;
};
// 对应 OgreSceneManager.h 288:SkyDomeGenParameters
struct SkyDomeGenParameters {
float skyDomeCurvature;
float skyDomeTiling;
float skyDomeDistance;
int skyDomeXSegments;
int skyDomeYSegments;
int skyDomeYSegments_keep;
};
// 天空种类
enum class SkyKind { NONE, BOX, PLANE, DOME };
// 简化 SceneManager 天空状态:三种 renderer 各自持参,同一时刻只有一个激活
class SceneManagerSky {
public:
// 对应 setSkyBox(OgreSceneManager.h 1974)
void setSkyBox(float distance) {
mKind = SkyKind::BOX;
mBox.skyBoxDistance = distance;
}
// 对应 setSkyPlane(OgreSceneManager.h 1901)
void setSkyPlane(float scale, float tiling, float bow, int xsegments, int ysegments) {
mKind = SkyKind::PLANE;
mPlane.skyPlaneScale = scale;
mPlane.skyPlaneTiling = tiling;
mPlane.skyPlaneBow = bow;
mPlane.skyPlaneXSegments = xsegments;
mPlane.skyPlaneYSegments = ysegments;
}
// 对应 setSkyDome(OgreSceneManager.h 2059)
void setSkyDome(float curvature, float tiling, float distance, int xsegments, int ysegments) {
mKind = SkyKind::DOME;
mDome.skyDomeCurvature = curvature;
mDome.skyDomeTiling = tiling;
mDome.skyDomeDistance = distance;
mDome.skyDomeXSegments = xsegments;
mDome.skyDomeYSegments = ysegments;
}
SkyKind getKind() const { return mKind; }
const SkyBoxGenParameters& getBox() const { return mBox; }
const SkyPlaneGenParameters& getPlane() const { return mPlane; }
const SkyDomeGenParameters& getDome() const { return mDome; }
private:
SkyKind mKind = SkyKind::NONE;
SkyBoxGenParameters mBox{};
SkyPlaneGenParameters mPlane{};
SkyDomeGenParameters mDome{};
};
} // namespace ogre_repro
int main() {
using namespace ogre_repro;
SceneManagerSky sky;
// setSkyBox:材质 + 距离(默认 5000)
sky.setSkyBox(5000.f);
CHECK(sky.getKind() == SkyKind::BOX);
CHECK_EQ(sky.getBox().skyBoxDistance, 5000.f);
// setSkyPlane:平面方程 + scale / tiling / bow / segments
sky.setSkyPlane(1000.f, 10.f, 0.f, 1, 1);
CHECK(sky.getKind() == SkyKind::PLANE);
CHECK_EQ(sky.getPlane().skyPlaneScale, 1000.f);
CHECK_EQ(sky.getPlane().skyPlaneTiling, 10.f);
CHECK_EQ(sky.getPlane().skyPlaneBow, 0.f);
CHECK_EQ(sky.getPlane().skyPlaneXSegments, 1);
CHECK_EQ(sky.getPlane().skyPlaneYSegments, 1);
// setSkyDome:曲率 / tiling / distance / segments
sky.setSkyDome(10.f, 8.f, 4000.f, 16, 16);
CHECK(sky.getKind() == SkyKind::DOME);
CHECK_EQ(sky.getDome().skyDomeCurvature, 10.f);
CHECK_EQ(sky.getDome().skyDomeTiling, 8.f);
CHECK_EQ(sky.getDome().skyDomeDistance, 4000.f);
CHECK_EQ(sky.getDome().skyDomeXSegments, 16);
CHECK_EQ(sky.getDome().skyDomeYSegments, 16);
// 切换天空会替换之前的配置(结构与生成参数互斥)
sky.setSkyBox(3000.f);
CHECK(sky.getKind() == SkyKind::BOX);
CHECK_EQ(sky.getBox().skyBoxDistance, 3000.f);
return lab::report("11-1 天空盒与天空平面");
}
本机实测(Apple clang 16,clang++ -std=c++20 -Wall):编译通过(零警告),断言 16/16 通过。
小结
- 三种天空:天空盒(6 面)、天空平面(地面无限延伸)、天空穹顶(5 面 + 曲率)。
SkyBoxGenParameters只有distance;天空平面与穹顶各带 tiling、细分、曲率参数。setSkyBox/setSkyPlane/setSkyDome是三个配置入口,天空平面额外需要Plane。- 默认距离:盒 5000、穹顶 4000;
drawFirst决定进 early 还是 late 天空队列。 - 三种天空互斥,后设置覆盖前设置;真正渲染交给各自的
Sky*Renderer(11.3)。
阅读导航:上一节:10.3 顶点动画使用 · 下一节:11.2 雾模式 。
继续阅读
探索更多技术文章
浏览归档,发现更多关于系统设计、工具链和工程实践的内容。