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_NONE | 0 | 关闭雾 |
FOG_EXP | 1 − e^(−density·dist) | 从相机指数增长 |
FOG_EXP2 | 1 − e^(−(density·dist)²) | 比 EXP 更快封顶 |
FOG_LINEAR | clamp((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 会把天空放进渲染队列,让雾因子只作用于场景几何而非天空本身。
源码定位
OgreMain/include/OgreCommon.h:FogMode(150)OgreMain/include/OgreSceneManager.h:setFog(2119)、getFogMode(2125)、getFogStart(2133)、getFogEnd(2137)、getFogDensity(2141)、雾成员(545-549)OgreMain/src/OgreSceneManager.cpp:setFog实现(1987)
上游引用固定到 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 天空渲染实现 。
继续阅读
探索更多技术文章
浏览归档,发现更多关于系统设计、工具链和工程实践的内容。