《OGRE 3D 渲染引擎原理与架构》7.3 地形材质

地形材质由 TerrainMaterialGenerator 按硬件能力动态生成:图层声明固定为 albedo_specular 与 normal_height 两个 RGBA 采样器;SM2Profile::getMaxLayers 用 16 纹理单元预算扣掉固定开销后除以每层 2.25 单元;getRequiredLayers 统计实际贴图需求。lab 复现两者。

7.3 地形材质

地形的高度有了,但渲染时它得「长得像地面」:多层纹理按高度/陡峭度混合、远处变模糊、近处有法线细节。OGRE 把这件事交给 TerrainMaterialGenerator——它不是一串预设材质,而是一个按硬件与地形状态动态生成材质的工厂。这一节讲它的骨架与两个核心计数函数。

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

helio 四卷没有地形材质生成器;rt 卷讲过材质/着色器基础。这里解析真实 OGRE 的 TerrainMaterialGenerator:图层声明结构、SM2Profile::getMaxLayers 的纹理单元预算、getRequiredLayers 的需求统计。

图层声明:每个图层长什么样

TerrainLayerSampler 描述「一层」里每种信息的别名与像素格式,多个采样器组成一个 TerrainLayerDeclaration:

// Components/Terrain/include/OgreTerrainMaterialGenerator.h:TerrainLayerSampler(v14.6.3 源码摘录,已删减)
        }
        TerrainLayerSampler(const String& aliasName, PixelFormat fmt)
            : alias(aliasName), format(fmt)
        {
        }
    };
    /** The definition of the information each layer will contain in this terrain.
    All layers must contain the same structure of information, although the
    input textures can be different per layer instance.
    */
    typedef std::vector<TerrainLayerSampler> TerrainLayerDeclaration;

生成器 A(TerrainMaterialGeneratorA)在构造函数里固定默认声明——每个图层由两张贴图构成,都是 RGBA:

// Components/Terrain/src/OgreTerrainMaterialGeneratorA.cpp:构造函数(v14.6.3 源码摘录)
        mLayerDecl = {{"albedo_specular", PF_BYTE_RGBA}, {"normal_height", PF_BYTE_RGBA}};
  • albedo_specular:漫反射颜色 + 高光(RGBA 两个用途装进一张图)。
  • normal_height:法线 + 高度(RGBA 装法线 XYZ 与高度)。
  • 混合贴图(blend textures)单独走 getBlendTextures(),不计入图层声明。

getMaxLayers:纹理单元预算

Shader Model 2 档位(SM2Profile)的 getMaxLayers 回答「当前地形最多支持几层」。它从 16 个纹理单元里扣固定开销,再除以每个图层占用的 2.25 个单元:

// Components/Terrain/src/OgreTerrainMaterialGeneratorA.cpp:SM2Profile::getMaxLayers(v14.6.3 源码摘录)
    uint8 TerrainMaterialGeneratorA::SM2Profile::getMaxLayers(const Terrain* terrain) const
    {
        // count the texture units free
        uint8 freeTextureUnits = 16;
        // lightmap
        --freeTextureUnits;
        // normalmap
        --freeTextureUnits;
        // colourmap
        if (terrain->getGlobalColourMapEnabled())
            --freeTextureUnits;
        if (isShadowingEnabled(HIGH_LOD, terrain))
        {
            uint8 numShadowTextures = 1;
            if (getReceiveDynamicShadowsPSSM())
            {
                numShadowTextures = (uint8)getReceiveDynamicShadowsPSSM()->getSplitCount();
            }
            freeTextureUnits -= numShadowTextures;
        }

        // each layer needs 2.25 units (1xdiffusespec, 1xnormalheight, 0.25xblend)
        return static_cast<uint8>(freeTextureUnits / 2.25f);
        

    }
开销单元数
lightmap1(固定)
normalmap1(固定)
global colour map1(可选)
阴影纹理1,PSSM 下取 split 数
每个图层2.25 = 1×diffusespec + 1×normalheight + 0.25×blend

典型数值:无颜色图无阴影时 14 / 2.25 = 6.22 → 6 层;启用颜色图或阴影减到 5 层。

getRequiredLayers:实际需求统计

getRequiredLayers 是同一个 .cpp 里的静态函数,统计这个地形实际需要几张贴图:

// Components/Terrain/src/OgreTerrainMaterialGeneratorA.cpp:getRequiredLayers(v14.6.3 源码摘录)
    static int getRequiredLayers(const Terrain* terrain, uint8 numShadowTextures)
    {
        int layers = terrain->getLayerCount(); // layer diffusespec
        if (!terrain->getLayerTextureName(0, 1).empty())
            layers *= 2; // per layer normalheight
        layers += 1; // global normal
        layers += bool(terrain->getGlobalColourMap());
        layers += bool(terrain->getLightmap());
        layers += terrain->getBlendTextures().size();

        // PSSM uses one texture unit per split. This must match the count
        // used by SM2Profile::getMaxLayers().
        layers += numShadowTextures;

        return layers;
    }

构成:layerCount 张 diffusespec(每层带法线高度图则 ×2)+ 1 张全局法线 + 可选颜色图/光照图 + 混合贴图张数 + 阴影纹理数。注释特别强调 PSSM 的单元数必须与 getMaxLayers 里的口径一致——两个函数对「阴影占多少单元」的约定要同步。

三种 TechniqueType

SM2Profile 内部用一个私有枚举区分三种技术路径:

// Components/Terrain/include/OgreTerrainMaterialGeneratorA.h:SM2Profile::TechniqueType(v14.6.3 源码摘录,已删减)
        private:
            enum TechniqueType
            {
                HIGH_LOD,
                LOW_LOD,
                RENDER_COMPOSITE_MAP
            };
  • HIGH_LOD:近处全细节,动态阴影、法线/视差映射全开。
  • LOW_LOD:远处用合成图(composite map),走更便宜的着色路径。
  • RENDER_COMPOSITE_MAP:离屏把地形渲染到合成纹理,供 LOW_LOD 采样。

generate(const Terrain*) 先生成/复用材质,再按 TechniqueType 与硬件能力生成对应的技术,isShadowingEnabled(tt, terrain) 决定某档是否开阴影。

源码定位

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

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

下面用纯 C++ 复现图层声明与两个计数函数。它与 src/07-3-terrain-material.cpp 逐字节一致:

// file: src/07-3-terrain-material.cpp
// tier: L1
// verify: clang++ -std=c++20 -I. src/07-3-terrain-material.cpp -o bin/07-3-terrain-material && ./bin/07-3-terrain-material
//
// 复现地形材质生成器(对应 OgreTerrainMaterialGenerator.h 的 TerrainLayerDeclaration、
//   OgreTerrainMaterialGeneratorA.cpp 208- 的 getMaxLayers 与 235- 的 getRequiredLayers):
//   TerrainLayerDeclaration 是采样器别名/格式列表,生成器 A 默认
//     {"albedo_specular", PF_BYTE_RGBA}, {"normal_height", PF_BYTE_RGBA};
//   getMaxLayers() 从 16 个纹理单元扣掉 lightmap/normalmap(各 1)、global colour map(可选)
//     和阴影纹理数,再除以每个图层占用的 2.25 个单元(1xdiffusespec + 1xnormalheight + 0.25xblend);
//   getRequiredLayers() 统计实际需要贴图数量:每层 diffusespec(有逐层法线则 *2)+
//     1 全局法线 + colourmap/lightmap 各 1 + 混合贴图数 + 阴影纹理数。
// 独立最小验证,非 OGRE 源码。
#include "verify.h"

#include <cstdint>
#include <string>
#include <vector>

namespace ogre_repro {

// 对应 PixelFormat 的极小枚举(PF_BYTE_RGBA=3 与 OGRE 一致)
enum PixelFormat { PF_BYTE_RGBA = 3 };

// 对应 TerrainLayerSampler(OgreTerrainMaterialGenerator.h 60-)
struct TerrainLayerSampler {
  std::string alias;
  PixelFormat format;
  TerrainLayerSampler(const std::string& a, PixelFormat f) : alias(a), format(f) {}
};

// 对应 TerrainLayerDeclaration:typedef std::vector<TerrainLayerSampler>
using TerrainLayerDeclaration = std::vector<TerrainLayerSampler>;

// 对应 SM2Profile::TechniqueType
enum TechniqueType { HIGH_LOD, LOW_LOD, RENDER_COMPOSITE_MAP };

// 地形现状的简化结构(对应 Terrain 相关 getter)
struct TerrainInfo {
  int layerCount = 0;
  bool hasLayerNormalHeight = false;  // layerTextureName(0,1) 非空
  bool globalColourMap = false;
  bool lightmap = false;
  int blendTextures = 0;              // getBlendTextures().size()
};

// 对应 SM2Profile::getMaxLayers(OgreTerrainMaterialGeneratorA.cpp 208-)
uint8_t getMaxLayers(const TerrainInfo& t, uint8_t numShadowTextures) {
  uint8_t free = 16;
  --free;  // lightmap
  --free;  // normalmap
  if (t.globalColourMap) --free;
  free -= numShadowTextures;
  return static_cast<uint8_t>(float(free) / 2.25f);  // 每个图层 2.25 单元
}

// 对应 getRequiredLayers(OgreTerrainMaterialGeneratorA.cpp 235-)
int getRequiredLayers(const TerrainInfo& t, uint8_t numShadowTextures) {
  int layers = t.layerCount;  // layer diffusespec
  if (t.hasLayerNormalHeight) layers *= 2;  // per layer normalheight
  layers += 1;                // global normal
  layers += t.globalColourMap ? 1 : 0;
  layers += t.lightmap ? 1 : 0;
  layers += t.blendTextures;  // 混合贴图
  layers += numShadowTextures;
  return layers;
}

}  // namespace ogre_repro

int main() {
  using namespace ogre_repro;

  // 默认图层声明:albedo_specular + normal_height,均 RGBA
  TerrainLayerDeclaration decl;
  decl.emplace_back("albedo_specular", PF_BYTE_RGBA);
  decl.emplace_back("normal_height", PF_BYTE_RGBA);
  CHECK_EQ(decl.size(), 2u);
  CHECK_EQ(decl[0].alias, "albedo_specular");
  CHECK_EQ(decl[1].alias, "normal_height");
  CHECK_EQ(decl[0].format, PF_BYTE_RGBA);
  CHECK_EQ(decl[1].format, PF_BYTE_RGBA);

  // 基本地形:16 - lightmap(1) - normalmap(1) = 14 -> 14/2.25 = 6.22 -> 6
  TerrainInfo basic;
  basic.layerCount = 4;
  CHECK_EQ(getMaxLayers(basic, 0), 6u);

  // 启用 global colour map:13/2.25 = 5.77 -> 5
  TerrainInfo withColour = basic;
  withColour.globalColourMap = true;
  CHECK_EQ(getMaxLayers(withColour, 0), 5u);

  // 1 张阴影纹理:16-2-1 = 13 -> 5
  CHECK_EQ(getMaxLayers(basic, 1), 5u);

  // PSSM 3 个 split:16-2-3 = 11 -> 4.88 -> 4
  CHECK_EQ(getMaxLayers(basic, 3), 4u);

  // 颜色图 + PSSM 2 个 split:16-2-1-2 = 11 -> 4
  CHECK_EQ(getMaxLayers(withColour, 2), 4u);

  // getRequiredLayers:4 层 diffusespec + 1 全局法线 = 5
  CHECK_EQ(getRequiredLayers(basic, 0), 5);

  // 每层带法线高度图:4*2 + 1 = 9
  TerrainInfo withNormal = basic;
  withNormal.hasLayerNormalHeight = true;
  CHECK_EQ(getRequiredLayers(withNormal, 0), 9);

  // 再加 colour map 与 lightmap:9 + 1 + 1 = 11
  TerrainInfo rich = withNormal;
  rich.globalColourMap = true;
  rich.lightmap = true;
  CHECK_EQ(getRequiredLayers(rich, 0), 11);

  // 3 张混合贴图 + 2 张阴影:11 + 3 + 2 = 16
  TerrainInfo veryRich = rich;
  veryRich.blendTextures = 3;
  CHECK_EQ(getRequiredLayers(veryRich, 2), 16);

  // 6 层基础地形:6 + 1 = 7
  TerrainInfo big;
  big.layerCount = 6;
  CHECK_EQ(getRequiredLayers(big, 0), 7);

  // 三种技术(HIGH_LOD/LOW_LOD/RENDER_COMPOSITE_MAP)枚举递增
  CHECK(HIGH_LOD < LOW_LOD && LOW_LOD < RENDER_COMPOSITE_MAP);

  return lab::report("07-3 地形材质");
}

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

小结

  • TerrainLayerDeclaration 定义每个图层的采样器集合;生成器 A 固定 albedo_specular + normal_height 两张 RGBA。
  • getMaxLayers 从 16 个纹理单元扣 lightmap/normalmap/颜色图/阴影,再除每层 2.25 单元。
  • getRequiredLayers 统计 diffusespec(含逐层法线 ×2)、全局法线、颜色图/光照图、混合贴图与阴影。
  • PSSM 的阴影单元口径必须两个函数一致。
  • TechniqueType(HIGH_LOD / LOW_LOD / RENDER_COMPOSITE_MAP)决定近处细节、远处合成图与离屏烘焙三条渲染路径。

阅读导航:上一节:7.2 高度图与 LOD · 下一节:8.1 分页概述 。

继续阅读

探索更多技术文章

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

全部文章 返回首页

「books」更多文章

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