《OGRE 3D 渲染引擎原理与架构》11.1 天空盒与天空平面

OGRE 提供三种天空:天空盒(6 面包裹相机)、天空平面(沿地面无限延伸的带弧平面)、天空穹顶(5 面立方体加纹理曲率错觉)。三种各有生成参数结构,SceneManager 的 setSkyBox/setSkyPlane/setSkyDome 分别配置。lab 复现三种参数结构与互斥切换。

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;
        };
参数天空盒天空平面天空穹顶
距离/尺寸distancescaledistance
纹理—tilingtiling
曲率—bowcurvature
细分—x/ySegmentsx/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 雾模式 。

继续阅读

探索更多技术文章

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

全部文章 返回首页

「books」更多文章

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