《OGRE 3D 渲染引擎原理与架构》5.1 阴影技术总览

OGRE 的阴影技术是位标志组合:低两位区分叠加/调制/集成,高两位区分模板/纹理;SceneManager 用按位与做分类判定。lab 复现 ShadowTechnique 枚举与 isShadowTechnique 系列。

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 = 0x12TEXTURE_MODULATIVE = 0x22
叠加(0x01)STENCIL_ADDITIVE = 0x11TEXTURE_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 会用到。

源码定位

上游引用固定到 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 阴影相机设置 。

继续阅读

探索更多技术文章

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

全部文章 返回首页

「books」更多文章

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