《OGRE 3D 渲染引擎原理与架构》11.2 雾模式

雾是场景级的深度衰减效果,FogMode 枚举定义四种模式:FOG_NONE/EXP/EXP2/LINEAR。SceneManager::setFog 存下模式、颜色、密度与起止距离,材质可覆盖场景级雾。lab 复现三种雾公式的因子计算与大小关系。

11.2 雾模式

雾是给场景加「大气深度」的廉价手段:远处的物体被染成雾色,视觉上消除地平线的硬边。OGRE 的雾是场景级参数——SceneManager::setFog 一次设置,全场景的几何都受影响(除非材质自带雾设置)。这一节解析 FogMode 枚举与四种模式的因子公式,为 11.3 天空与雾的配合做铺垫。

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

helio 四卷没有场景雾;cg 三卷讲过深度衰减的数学公式。这里解析真实 OGRE 的 FogMode(OgreCommon.h)与 SceneManager::setFog(OgreSceneManager.h/.cpp):四种模式怎么枚举、setFog 存哪些参数、指数雾与线性雾在渲染管线里怎么算因子。

FogMode:四种模式

FogMode 是 uint8 枚举,定义在公共头文件里,注释直接给出每种模式的公式意图:

// OgreMain/include/OgreCommon.h:FogMode(v14.6.3 源码摘录,已删减)
    /** Fog modes. */
    enum FogMode : uint8
    {
        /// No fog. Duh.
        FOG_NONE,
        /// Fog density increases  exponentially from the camera (fog = 1/e^(distance * density))
        FOG_EXP,
        /// Fog density increases at the square of FOG_EXP, i.e. even quicker (fog = 1/e^(distance * density)^2)
        FOG_EXP2,
        /// Fog density increases linearly between the start and end distances
        FOG_LINEAR
    };

四种模式分别是:无雾、指数雾、指数平方雾、线性雾。因子值语义是「0 完全清晰、1 完全被雾覆盖」。把注释里的公式翻译成因子:

模式雾因子 f(dist)特点
FOG_NONE0关闭雾
FOG_EXP1 − e^(−density·dist)从相机指数增长
FOG_EXP21 − e^(−(density·dist)²)比 EXP 更快封顶
FOG_LINEARclamp((dist − start)/(end − start), 0, 1)起止距离间线性

注意 FOG_EXP 与 FOG_EXP2 在 density·dist == 1 时因子恰好相等;要让 EXP2 严格大于 EXP,需要距离足够大使 density·dist > 1。lab 正是用这个关系验证两种指数雾的差异。

setFog:场景级参数

SceneManager::setFog 一次性收下模式、颜色与三类参数,默认值见签名:

// OgreMain/include/OgreSceneManager.h:setFog/getFog*(v14.6.3 源码摘录,已删减)
        void setFog(
            FogMode mode = FOG_NONE, const ColourValue& colour = ColourValue::White,
            Real expDensity = 0.001f, Real linearStart = 0.0f, Real linearEnd = 1.0f);

        /** Returns the fog mode for the scene.
        */
        FogMode getFogMode(void) const;

        /** Returns the fog start distance for the scene.
        */
        Real getFogStart(void) const;

        /** Returns the fog end distance for the scene.
        */
        Real getFogEnd(void) const;

        /** Returns the fog density for the scene.
        */
        Real getFogDensity(void) const;

实现里这些参数被直接存进成员(mFogMode/mFogColour/mFogStart/mFogEnd/mFogDensity,见 OgreSceneManager.h:545-549)。注意线性雾的参数 linearStart/linearEnd 与指数雾的 expDensity 是三选二的关系:某模式用不到的参数在计算时被忽略。材质可以在 Material::setFog 里覆盖场景级雾——文档明确这是唯一的例外路径。

雾与天空的配合

雾色通常配成与天空色一致(或与 viewport 背景色一致),否则地平线处物体会从雾里「探」出来穿帮。这正是 11.1 三种天空都要带 materialName 的原因之一:天空材质与雾色联动,11.3 会把天空放进渲染队列,让雾因子只作用于场景几何而非天空本身。

源码定位

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

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

下面用纯 C++ 复现三种雾公式的因子计算与大小关系。它与 src/11-2-fog-modes.cpp 逐字节一致:

// file: src/11-2-fog-modes.cpp
// tier: L1
// verify: clang++ -std=c++20 -I. src/11-2-fog-modes.cpp -o bin/11-2-fog-modes && ./bin/11-2-fog-modes
//
// 复现雾模式与雾因子计算(对应 OgreCommon.h 150、OgreSceneManager.h 2119/2125、OgreSceneManager.cpp 1987):
//   FogMode 是 uint8 枚举:FOG_NONE / FOG_EXP / FOG_EXP2 / FOG_LINEAR;
//   setFog 保存 mode/colour/density/start/end;
//   EXP 因子 = 1 - e^(-density·dist),EXP2 = 1 - e^(-(density·dist)^2),LINEAR 在 start/end 间线性插值。
// 独立最小验证,非 OGRE 源码。
#include "verify.h"

#include <cmath>
#include <cstdint>

namespace ogre_repro {

// 对应 OgreCommon.h 150:FogMode
enum FogMode : uint8_t {
  FOG_NONE,    // OgreCommon.h 153
  FOG_EXP,     // OgreCommon.h 154
  FOG_EXP2,    // OgreCommon.h 156
  FOG_LINEAR   // OgreCommon.h 158
};

// 对应 OgreSceneManager.cpp 1987 的 setFog 参数集
struct FogParams {
  FogMode mode = FOG_NONE;
  float density = 0.001f;
  float start = 0.f;
  float end = 1.f;
};

// 雾因子:0 完全清晰,1 完全被雾覆盖(fog factor)
float fogFactor(const FogParams& fog, float dist) {
  switch (fog.mode) {
    case FOG_EXP:
      return 1.f - std::exp(-fog.density * dist);
    case FOG_EXP2: {
      float d = fog.density * dist;
      return 1.f - std::exp(-d * d);
    }
    case FOG_LINEAR:
      if (dist <= fog.start) return 0.f;
      if (dist >= fog.end) return 1.f;
      return (dist - fog.start) / (fog.end - fog.start);
    default:
      return 0.f;
  }
}

}  // namespace ogre_repro

int main() {
  using namespace ogre_repro;

  // 枚举值
  CHECK_EQ(FOG_NONE, 0);
  CHECK_EQ(FOG_EXP, 1);
  CHECK_EQ(FOG_EXP2, 2);
  CHECK_EQ(FOG_LINEAR, 3);

  // 无雾:任何距离都清晰
  FogParams none;
  CHECK_EQ(fogFactor(none, 100.f), 0.f);

  // EXP:距离越远雾越重,但不会立刻封顶
  FogParams exp;
  exp.mode = FOG_EXP;
  exp.density = 0.01f;
  float f100 = fogFactor(exp, 100.f);
  float f200 = fogFactor(exp, 200.f);
  CHECK(f100 > 0.f && f100 < 1.f);
  CHECK(f200 > f100);

  // EXP2:衰减比 EXP 更快(同 density 同距离因子更高;d>1 时严格大于)
  FogParams exp2;
  exp2.mode = FOG_EXP2;
  exp2.density = 0.01f;
  CHECK(fogFactor(exp2, 200.f) > fogFactor(exp, 200.f));

  // LINEAR:start 前清晰、end 后全雾、之间线性
  FogParams lin;
  lin.mode = FOG_LINEAR;
  lin.start = 50.f;
  lin.end = 150.f;
  CHECK_EQ(fogFactor(lin, 30.f), 0.f);
  CHECK_EQ(fogFactor(lin, 100.f), 0.5f);
  CHECK_EQ(fogFactor(lin, 200.f), 1.f);

  return lab::report("11-2 雾模式");
}

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

小结

  • FogMode 是 uint8 枚举,四值:FOG_NONE/FOG_EXP/FOG_EXP2/FOG_LINEAR。
  • setFog 一次收下模式、颜色、指数密度、线性起止;未用的参数在计算中被忽略。
  • EXP 因子 = 1 − e^(−density·dist);EXP2 = 1 − e^(−(density·dist)²);LINEAR 在 start/end 间线性。
  • 指数雾在 density·dist > 1 后 EXP2 才严格快于 EXP。
  • 雾是场景级设置,材质可覆盖;雾色通常与天空色/背景色一致防穿帮。

阅读导航:上一节:11.1 天空盒与天空平面 · 下一节:11.3 天空渲染实现 。

继续阅读

探索更多技术文章

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

全部文章 返回首页

「books」更多文章

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