5.1 阴影技术总览
前四节把光源本身讲完了,本节进入阴影。OGRE 的阴影技术不是一长串互相排斥的枚举值,而是一个位标志组合:低位 0x01/0x02/0x04 表示「怎么把阴影和场景合成」(叠加/调制/集成),高位 0x10/0x20 表示「阴影怎么产生」(模板体积/阴影纹理)。SceneManager 通过 setShadowTechnique 接受其中一个组合值,再用 isShadowTechnique* 系列按位与做分类判定。
本章与站内既有内容的分工
cg 三卷讲过阴影贴图与体积阴影的算法原理;5.2、5.3 分别展开相机设置与纹理阴影池。本节是总览:把 ShadowTechnique 位域讲清,为 5.2 的 ShadowCameraSetup 按光源类型构造相机、5.3 的 ShadowTextureManager 池化管理做铺垫。
ShadowTechnique:一个位标志枚举
OgreCommon.h 里把「基础掩码位」与「可直接使用的组合值」放在同一个枚举。前五个是掩码位,其中 ADDITIVE/MODULATIVE/INTEGRATED 是合成方式,STENCIL/TEXTURE 是产生方式:
// OgreMain/include/OgreCommon.h:enum ShadowTechnique(v14.6.3 源码摘录,已删减)
/** An enumeration of broad shadow techniques */
enum ShadowTechnique
{
/** No shadows */
SHADOWTYPE_NONE = 0x00,
/** Mask for additive shadows (not for direct use, use SHADOWTYPE_ enum instead)
*/
SHADOWDETAILTYPE_ADDITIVE = 0x01,
/** Mask for modulative shadows (not for direct use, use SHADOWTYPE_ enum instead)
*/
SHADOWDETAILTYPE_MODULATIVE = 0x02,
/** Mask for integrated shadows (not for direct use, use SHADOWTYPE_ enum instead)
*/
SHADOWDETAILTYPE_INTEGRATED = 0x04,
/** Mask for stencil shadows (not for direct use, use SHADOWTYPE_ enum instead)
*/
SHADOWDETAILTYPE_STENCIL = 0x10,
/** Mask for texture shadows (not for direct use, use SHADOWTYPE_ enum instead)
*/
SHADOWDETAILTYPE_TEXTURE = 0x20,
...
文档反复强调掩码位「not for direct use」,要用下边的组合值。组合值就是按位或:模板 × 调制、模板 × 叠加、纹理 × 调制、纹理 × 叠加,以及各自的集成版:
// OgreMain/include/OgreCommon.h:ShadowTechnique 组合值(v14.6.3 源码摘录,已删减)
SHADOWTYPE_STENCIL_MODULATIVE = SHADOWDETAILTYPE_STENCIL | SHADOWDETAILTYPE_MODULATIVE,
...
SHADOWTYPE_STENCIL_ADDITIVE = SHADOWDETAILTYPE_STENCIL | SHADOWDETAILTYPE_ADDITIVE,
...
SHADOWTYPE_TEXTURE_MODULATIVE = SHADOWDETAILTYPE_TEXTURE | SHADOWDETAILTYPE_MODULATIVE,
...
SHADOWTYPE_TEXTURE_ADDITIVE = SHADOWDETAILTYPE_TEXTURE | SHADOWDETAILTYPE_ADDITIVE,
...
SHADOWTYPE_TEXTURE_ADDITIVE_INTEGRATED = SHADOWTYPE_TEXTURE_ADDITIVE | SHADOWDETAILTYPE_INTEGRATED,
...
SHADOWTYPE_TEXTURE_MODULATIVE_INTEGRATED = SHADOWTYPE_TEXTURE_MODULATIVE | SHADOWDETAILTYPE_INTEGRATED
};
于是两个维度正交成一张表:
| 模板(0x10) | 纹理(0x20) | |
|---|---|---|
| 调制(0x02) | STENCIL_MODULATIVE = 0x12 | TEXTURE_MODULATIVE = 0x22 |
| 叠加(0x01) | STENCIL_ADDITIVE = 0x11 | TEXTURE_ADDITIVE = 0x21 |
| 集成(0x04) | — | TEXTURE_ADDITIVE_INTEGRATED = 0x25、TEXTURE_MODULATIVE_INTEGRATED = 0x26 |
组合的好处是:引擎里到处是 (technique & mask) 的分类测试,新增维度只需再占一个位,不用改枚举形状。
分类判定:isShadowTechnique* 系列
SceneManager 提供六个查询方法,全部是常量表达式级别的按位与:
// OgreMain/include/OgreSceneManager.h:isShadowTechnique* 系列(v14.6.3 源码摘录,已删减)
/** Is there a stencil shadow based shadowing technique in use? */
bool isShadowTechniqueStencilBased(void) const
{ return (mShadowTechnique & SHADOWDETAILTYPE_STENCIL) != 0; }
/** Is there a texture shadow based shadowing technique in use? */
bool isShadowTechniqueTextureBased(void) const
{ return (mShadowTechnique & SHADOWDETAILTYPE_TEXTURE) != 0; }
/** Is there a modulative shadowing technique in use? */
bool isShadowTechniqueModulative(void) const
{ return (mShadowTechnique & SHADOWDETAILTYPE_MODULATIVE) != 0; }
/** Is there an additive shadowing technique in use? */
bool isShadowTechniqueAdditive(void) const
{ return (mShadowTechnique & SHADOWDETAILTYPE_ADDITIVE) != 0; }
/** Is the shadow technique integrated into primary materials? */
bool isShadowTechniqueIntegrated(void) const
{ return (mShadowTechnique & SHADOWDETAILTYPE_INTEGRATED) != 0; }
/** Is there any shadowing technique in use? */
bool isShadowTechniqueInUse(void) const
{ return mShadowTechnique != SHADOWTYPE_NONE; }
几个典型用法:
SHADOWTYPE_STENCIL_MODULATIVE→isShadowTechniqueStencilBased()真、isShadowTechniqueTextureBased()假、isShadowTechniqueModulative()真、isShadowTechniqueAdditive()假。SHADOWTYPE_TEXTURE_ADDITIVE→ 反过来:纹理真、模板假、叠加真、调制假。- 集成两种 →
isShadowTechniqueIntegrated()为真,5.3 的纹理阴影渲染器会据此决定阴影纹理默认是黑(additive)还是阴影色(modulative)。
配合 setShadowColour 设置的调制色,OgreTextureShadowRenderer 在渲染时判断:additive 用 ColourValue::Black 作为纹理底色,modulative 用 getShadowColour()。方向光体积的挤出距离另有 setShadowDirectionalLightExtrusionDistance 配置(默认 10000 世界单位),5.2 会用到。
源码定位
OgreMain/include/OgreCommon.h:enum ShadowTechnique(掩码位与组合值)OgreMain/include/OgreSceneManager.h:isShadowTechnique*系列、setShadowTechniqueOgreMain/src/OgreSceneManager.cpp:setShadowColour、setShadowDirectionalLightExtrusionDistance
上游引用固定到 OGRE v14.6.3 源码 。
可运行产物:C++ 最小验证
下面复现 ShadowTechnique 位域:组合值的按位或结果、两个维度的掩码互不相交、isShadowTechnique* 系列对 NONE/模板调制/纹理叠加/集成纹理的判定。它与 src/05-1-shadow-technique.cpp 逐字节一致:
// file: src/05-1-shadow-technique.cpp
// tier: L1
// verify: clang++ -std=c++20 -I. src/05-1-shadow-technique.cpp -o bin/05-1-shadow-technique && ./bin/05-1-shadow-technique
//
// 复现 OgreCommon.h 的 ShadowTechnique 位标志枚举与
// OgreSceneManager.h 的分类判定:
// 低位 0x01/0x02/0x04 = ADDITIVE/MODULATIVE/INTEGRATED,
// 高位 0x10/0x20 = STENCIL/TEXTURE,组合值按位或得到;
// isShadowTechniqueStencilBased 等 = (technique & mask) != 0。
// 独立最小验证,非 OGRE 源码。
#include "verify.h"
#include <cstdint>
namespace ogre_repro {
// 对应 OgreCommon.h:enum ShadowTechnique(值逐位一致)
enum ShadowTechnique : uint32_t {
SHADOWTYPE_NONE = 0x00,
SHADOWDETAILTYPE_ADDITIVE = 0x01,
SHADOWDETAILTYPE_MODULATIVE = 0x02,
SHADOWDETAILTYPE_INTEGRATED = 0x04,
SHADOWDETAILTYPE_STENCIL = 0x10,
SHADOWDETAILTYPE_TEXTURE = 0x20,
SHADOWTYPE_STENCIL_MODULATIVE = SHADOWDETAILTYPE_STENCIL | SHADOWDETAILTYPE_MODULATIVE,
SHADOWTYPE_STENCIL_ADDITIVE = SHADOWDETAILTYPE_STENCIL | SHADOWDETAILTYPE_ADDITIVE,
SHADOWTYPE_TEXTURE_MODULATIVE = SHADOWDETAILTYPE_TEXTURE | SHADOWDETAILTYPE_MODULATIVE,
SHADOWTYPE_TEXTURE_ADDITIVE = SHADOWDETAILTYPE_TEXTURE | SHADOWDETAILTYPE_ADDITIVE,
SHADOWTYPE_TEXTURE_ADDITIVE_INTEGRATED =
SHADOWTYPE_TEXTURE_ADDITIVE | SHADOWDETAILTYPE_INTEGRATED,
SHADOWTYPE_TEXTURE_MODULATIVE_INTEGRATED =
SHADOWTYPE_TEXTURE_MODULATIVE | SHADOWDETAILTYPE_INTEGRATED
};
// 对应 OgreSceneManager.h 的 isShadowTechnique* 系列
bool isStencilBased(uint32_t t) { return (t & SHADOWDETAILTYPE_STENCIL) != 0; }
bool isTextureBased(uint32_t t) { return (t & SHADOWDETAILTYPE_TEXTURE) != 0; }
bool isModulative(uint32_t t) { return (t & SHADOWDETAILTYPE_MODULATIVE) != 0; }
bool isAdditive(uint32_t t) { return (t & SHADOWDETAILTYPE_ADDITIVE) != 0; }
bool isIntegrated(uint32_t t) { return (t & SHADOWDETAILTYPE_INTEGRATED) != 0; }
bool isInUse(uint32_t t) { return t != SHADOWTYPE_NONE; }
} // namespace ogre_repro
int main() {
using namespace ogre_repro;
// 组合值等于对应位相或
CHECK_EQ(static_cast<int>(SHADOWTYPE_STENCIL_MODULATIVE), 0x12);
CHECK_EQ(static_cast<int>(SHADOWTYPE_STENCIL_ADDITIVE), 0x11);
CHECK_EQ(static_cast<int>(SHADOWTYPE_TEXTURE_MODULATIVE), 0x22);
CHECK_EQ(static_cast<int>(SHADOWTYPE_TEXTURE_ADDITIVE), 0x21);
CHECK_EQ(static_cast<int>(SHADOWTYPE_TEXTURE_ADDITIVE_INTEGRATED), 0x25);
CHECK_EQ(static_cast<int>(SHADOWTYPE_TEXTURE_MODULATIVE_INTEGRATED), 0x26);
// 两个掩码位域不相交
CHECK_EQ(SHADOWDETAILTYPE_STENCIL & SHADOWDETAILTYPE_TEXTURE, 0u);
CHECK_EQ(SHADOWDETAILTYPE_ADDITIVE & SHADOWDETAILTYPE_MODULATIVE, 0u);
// NONE:不启用
CHECK(!isInUse(SHADOWTYPE_NONE));
CHECK(!isStencilBased(SHADOWTYPE_NONE));
CHECK(!isTextureBased(SHADOWTYPE_NONE));
// 模板调制阴影:模板位 + 调制位
CHECK(isStencilBased(SHADOWTYPE_STENCIL_MODULATIVE));
CHECK(!isTextureBased(SHADOWTYPE_STENCIL_MODULATIVE));
CHECK(isModulative(SHADOWTYPE_STENCIL_MODULATIVE));
CHECK(!isAdditive(SHADOWTYPE_STENCIL_MODULATIVE));
CHECK(isInUse(SHADOWTYPE_STENCIL_MODULATIVE));
// 纹理叠加阴影:纹理位 + 叠加位
CHECK(isTextureBased(SHADOWTYPE_TEXTURE_ADDITIVE));
CHECK(!isStencilBased(SHADOWTYPE_TEXTURE_ADDITIVE));
CHECK(isAdditive(SHADOWTYPE_TEXTURE_ADDITIVE));
CHECK(!isModulative(SHADOWTYPE_TEXTURE_ADDITIVE));
// 集成纹理阴影:额外带 INTEGRATED 位
CHECK(isIntegrated(SHADOWTYPE_TEXTURE_ADDITIVE_INTEGRATED));
CHECK(isTextureBased(SHADOWTYPE_TEXTURE_ADDITIVE_INTEGRATED));
CHECK(isAdditive(SHADOWTYPE_TEXTURE_ADDITIVE_INTEGRATED));
CHECK(isIntegrated(SHADOWTYPE_TEXTURE_MODULATIVE_INTEGRATED));
CHECK(isModulative(SHADOWTYPE_TEXTURE_MODULATIVE_INTEGRATED));
// 一种技术不同时是 additive 与 modulative
CHECK(!(isAdditive(SHADOWTYPE_STENCIL_MODULATIVE) &&
isModulative(SHADOWTYPE_STENCIL_MODULATIVE)));
CHECK(!(isAdditive(SHADOWTYPE_TEXTURE_MODULATIVE) &&
isModulative(SHADOWTYPE_TEXTURE_MODULATIVE)));
return lab::report("05-1 阴影技术总览:位标志枚举与分类判定");
}
本机实测(Apple clang 16,clang++ -std=c++20 -Wall):编译零警告,断言 27/27 通过。
小结
ShadowTechnique是位标志:低位 ADDITIVE/MODULATIVE/INTEGRATED 管合成,高位 STENCIL/TEXTURE 管产生。- 组合值 = 掩码位按位或,两个维度正交成 6 个可直接使用的技术。
isShadowTechnique*系列 =(technique & mask) != 0,一次按位与就能判出技术的每个维度。- 阴影色
setShadowColour供调制模式使用;additive 模式纹理底色用黑。
阅读导航:上一节:4.3 光照视觉参数 · 下一节:5.2 阴影相机设置 。
继续阅读
探索更多技术文章
浏览归档,发现更多关于系统设计、工具链和工程实践的内容。