《OGRE 3D 渲染引擎原理与架构》8.1 Material、Technique 与 Pass

材质是三层结构:Material 是视觉效果的完整描述,Technique 是适配硬件的不同实现方案,Pass 是具体一次绘制。透明判定逐级下推到第一 Pass 的混合状态。OGRE 的 SceneBlendFactor 枚举 SBF_ONE=0、SBF_ZERO=1,与 D3D 相反。lab 用 C++ 复现三层结构与透明判定下推。

8.1 Material、Technique 与 Pass

材质是网格「看起来什么样」的全部描述。OGRE 的材质不是一张贴图,而是一个完整的状态集合——Material 持有若干 Technique,每个 Technique 持有若干 Pass。这一节拆解这个三层结构。

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

cg 卷三的着色讲材质的光学与 PBR 原理;本系列 8.1~8.3 讲 OGRE 材质在源码里的组织:三层结构、纹理单元、脚本与状态合并。helio 卷一的渲染器讲 TypeScript 实现,这里对照真实 C++ 实现。

Material ≈ Shader:类注释的定位

OgreMaterial.h 的类注释把 OGRE 的材质观讲得很清楚——它不同于 D3D 的「材质只是颜色」,OGRE 的 Material 更像一个 Shader:

// OgreMain/include/OgreMaterial.h:Material 类注释(v14.6.3 教学示意,参照上游同名实现,已删减)
    ...This is
    different to Direct3D which treats a material as just the colour
    components (diffuse, specular) and not texture maps etc. An Ogre
    Material can be thought of as equivalent to a 'Shader'.

    A Material can be rendered in multiple different ways depending on the
    hardware available. You may configure a Material to use high-complexity
    fragment shaders, but these won't work on every card; therefore a Technique
    is an approach to creating the visual effect you are looking for. You are advised
    to create fallback techniques with lower hardware requirements if you decide to
    use advanced features.

两个要点:

  1. Material 是「视觉效果的完整描述」:颜色、贴图、混合、深度、着色器全在一个对象里;
  2. Technique 是「同一效果的不同硬件方案」:高端卡用复杂着色器,低端卡用降级技术;引擎自动挑硬件能跑的,全都不行就渲染成白(注释明说的兜底行为)。

三层结构

// OgreMain/include/OgreTechnique.h:Technique 持有 Pass(v14.6.3 源码摘录,已删减)
        Passes mPasses;
        ...
        Pass* createPass(void);
        Pass* getPass(size_t index) const { return mPasses.at(index); }
        size_t getNumPasses(void) const { return mPasses.size(); }

Pass 是一次实际绘制所需的全部渲染状态。OgrePass.h 里它的颜色与混合状态是核心成员:

// OgreMain/include/OgrePass.h:Pass 状态成员(v14.6.3 源码摘录,已删减)
        // Colour properties, only applicable in fixed-function passes
        ColourValue mAmbient;
        ColourValue mDiffuse;
        ColourValue mSpecular;
        ColourValue mEmissive;
        float mShininess;
        ...
        ColourBlendState mBlendState;

四色(环境/漫反射/高光/自发光)+ 光泽度 + 混合状态,构成 Pass 的「怎么画」。多 Pass 场景:例如先画一次物体、再画一次轮廓,或者半透明物体需要分多遍合成。Pass 还有一个 HashFunc——用 32 位哈希给 Pass 排序,减少渲染状态切换(卷二的渲染队列会细讲)。

透明判定:逐级下推到第一 Pass

「这个材质是不是透明的」决定它进不透明的还是透明的渲染队列。判定是逐级下推的:Material 问第一个 Technique,Technique 问第一个 Pass,Pass 看混合状态:

// OgreMain/src/OgreTechnique.cpp:Technique::isTransparent(v14.6.3 源码摘录,已删减)
    bool Technique::isTransparent(void) const
    {
        if (mPasses.empty())
        {
            return false;
        }
        else
        {
            // Base decision on the transparency of the first pass
            return mPasses[0]->isTransparent();
        }
    }

Pass 层的判定逻辑依赖混合状态。OGRE 的混合因子枚举有个值得注意的坑——SBF_ONE = 0、SBF_ZERO = 1,与 D3D 的约定相反:

// OgreMain/include/OgreBlendMode.h:SceneBlendFactor(v14.6.3 源码摘录,已删减)
    enum SceneBlendFactor
    {
        SBF_ONE, //!< Constant value of 1.0
        SBF_ZERO, //!< Constant value of 0.0
        SBF_DEST_COLOUR, //!< The existing pixel colour
        SBF_SOURCE_COLOUR, //!< The texture pixel (texel) colour
        SBF_ONE_MINUS_DEST_COLOUR, //!< 1 - SBF_DEST_COLOUR
        SBF_ONE_MINUS_SOURCE_COLOUR, //!< 1 - SBF_SOURCE_COLOUR
        SBF_DEST_ALPHA, //!< The existing pixel alpha value
        SBF_SOURCE_ALPHA, //!< The texel alpha value
        SBF_ONE_MINUS_DEST_ALPHA, //!< 1 - SBF_DEST_ALPHA
        SBF_ONE_MINUS_SOURCE_ALPHA //!< 1 - SBF_SOURCE_ALPHA
    };

Pass::isTransparent 的判据是:destFactor == SBF_ZERO 且 sourceFactor 不依赖目标颜色/alpha → 不透明,否则透明。默认的 source=SBF_ONE, dest=SBF_ZERO(不混合,直接覆盖)就是不透明。一旦设置标准 alpha 混合 source=SBF_SOURCE_ALPHA, dest=SBF_ONE_MINUS_SOURCE_ALPHA,就变透明,进透明渲染队列、按距离排序。

材质定义何时变成可用的绘制方案

资源组初始化能登记 Material。Technique 的支持检查还依赖当前 RenderSystem,方案选择再考虑 scheme 和 LOD。选中的 Technique 可以含多个 Pass,每个 Pass 有独立的状态和绑定。

从同一材质记录定义、支持的 Technique 和入队时的方案,逐层诊断“材质能找到但方案不可用”。原生场景中的 Default 方案可作为单 Pass 基线。

材质方案的选择过程

flowchart TD
  A["资源脚本登记 Material"] --> B["加载时检查 Technique 支持条件"]
  B --> C["结合 scheme 和 LOD 查找支持的 Technique"]
  C --> D{"找到适用方案?"}
  D -->|"是"| E["取其 Pass 参与绘制"]
  D -->|"否"| F["按当前方案尝试监听器或回退"]
  F --> G{"得到可用方案?"}
  G -->|"是"| E
  G -->|"否"| H["按调用路径使用后备材质或报告不可用"]

源码定位

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

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

下面复现三层结构、混合因子枚举与透明判定下推。它与 src/08-1-material-technique-pass.cpp 逐字节一致:

// file: src/08-1-material-technique-pass.cpp
// tier: L1
// verify: clang++ -std=c++20 -I. src/08-1-material-technique-pass.cpp -o bin/08-1-material-technique-pass && ./bin/08-1-material-technique-pass
//
// 复现 OgreMaterial/Technique/Pass 三层材质结构与透明判定:
//   Material 持 Technique 列表,Technique 持 Pass 列表;
//   Pass 有颜色状态与混合状态,isTransparent 基于混合状态判定;
//   Technique/Material 的透明判定逐级下推到第一 Pass。
// 独立最小验证,非 OGRE 源码。
#include "verify.h"

#include <string>
#include <vector>

namespace ogre_repro {

// 对应 OgreBlendMode.h 的 SceneBlendFactor(注意 SBF_ONE=0、SBF_ZERO=1)
enum SceneBlendFactor {
  SBF_ONE,
  SBF_ZERO,
  SBF_DEST_COLOUR,
  SBF_SOURCE_COLOUR,
  SBF_ONE_MINUS_DEST_COLOUR,
  SBF_ONE_MINUS_SOURCE_COLOUR,
  SBF_DEST_ALPHA,
  SBF_SOURCE_ALPHA,
  SBF_ONE_MINUS_DEST_ALPHA,
  SBF_ONE_MINUS_SOURCE_ALPHA
};

struct ColourValue { float r = 1, g = 1, b = 1, a = 1; };

// 对应 Pass::mBlendState(简化,只留判断所需的因子)
struct BlendState {
  SceneBlendFactor sourceFactor = SBF_ONE;
  SceneBlendFactor destFactor = SBF_ZERO;
};

// 对应 TextureUnitState 的占位(纹理单元细节见 8.2)
struct TextureUnitState {
  std::string mTextureName;
  unsigned short mTextureCoordSet;
};

class Pass {
 public:
  std::string mName;
  ColourValue mAmbient, mDiffuse, mSpecular, mEmissive;
  float mShininess = 0;
  BlendState mBlendState;
  std::vector<TextureUnitState*> mTextureUnitStates;

  ~Pass() {
    for (auto t : mTextureUnitStates) delete t;
  }

  TextureUnitState* createTextureUnitState(const std::string& textureName) {
    TextureUnitState* t = new TextureUnitState;
    t->mTextureName = textureName;
    mTextureUnitStates.push_back(t);
    return t;
  }

  size_t getNumTextureUnitStates() const { return mTextureUnitStates.size(); }

  // 对应 Pass::isTransparent:dest 非零或源依赖目标 → 透明
  bool isTransparent() const {
    if (mBlendState.destFactor == SBF_ZERO &&
        mBlendState.sourceFactor != SBF_DEST_COLOUR &&
        mBlendState.sourceFactor != SBF_ONE_MINUS_DEST_COLOUR &&
        mBlendState.sourceFactor != SBF_DEST_ALPHA &&
        mBlendState.sourceFactor != SBF_ONE_MINUS_DEST_ALPHA)
      return false;
    return true;
  }
};

// 对应 OgreTechnique:Pass 列表,透明判定下推第一 Pass
class Technique {
 public:
  std::vector<Pass*> mPasses;

  ~Technique() {
    for (auto p : mPasses) delete p;
  }

  Pass* createPass() {
    Pass* p = new Pass;
    mPasses.push_back(p);
    return p;
  }

  size_t getNumPasses() const { return mPasses.size(); }

  bool isTransparent() const {
    if (mPasses.empty()) return false;
    return mPasses[0]->isTransparent();  // 基于第一 Pass
  }
};

// 对应 OgreMaterial:Technique 列表,透明判定下推第一 Technique
class Material {
 public:
  std::vector<Technique*> mTechniques;

  ~Material() {
    for (auto t : mTechniques) delete t;
  }

  Technique* createTechnique() {
    Technique* t = new Technique;
    mTechniques.push_back(t);
    return t;
  }

  size_t getNumTechniques() const { return mTechniques.size(); }

  bool isTransparent() const {
    if (mTechniques.empty()) return false;
    return mTechniques[0]->isTransparent();
  }
};

}  // namespace ogre_repro

int main() {
  using namespace ogre_repro;

  // 枚举值:SBF_ONE=0、SBF_ZERO=1(OGRE 与 D3D 相反)
  CHECK(SBF_ONE == 0);
  CHECK(SBF_ZERO == 1);

  // 三层结构:Material → Technique → Pass
  Material mat;
  Technique* tech = mat.createTechnique();
  Pass* pass = tech->createPass();
  CHECK_EQ(mat.getNumTechniques(), 1u);
  CHECK_EQ(tech->getNumPasses(), 1u);

  // 默认 Pass 不透明(dest==SBF_ZERO 且源不依赖目标)
  CHECK(!pass->isTransparent());
  CHECK(!tech->isTransparent());
  CHECK(!mat.isTransparent());

  // Pass 颜色状态
  pass->mDiffuse.r = 0.8f;
  pass->mShininess = 32.0f;
  CHECK(pass->mDiffuse.r == 0.8f);
  CHECK(pass->mShininess == 32.0f);

  // 纹理单元挂到 Pass
  TextureUnitState* tus = pass->createTextureUnitState("rock.jpg");
  CHECK_EQ(pass->getNumTextureUnitStates(), 1u);
  CHECK(tus->mTextureName == "rock.jpg");

  // 设置 alpha 混合 → 透明判定翻转
  pass->mBlendState.sourceFactor = SBF_SOURCE_ALPHA;
  pass->mBlendState.destFactor = SBF_ONE_MINUS_SOURCE_ALPHA;
  CHECK(pass->isTransparent());
  CHECK(tech->isTransparent());  // 下推第一 Pass
  CHECK(mat.isTransparent());

  // 多技术:透明判定只看第一个 Technique 的第一个 Pass
  Technique* fallback = mat.createTechnique();
  Pass* opaquePass = fallback->createPass();  // 默认不透明
  CHECK(!opaquePass->isTransparent());
  CHECK(mat.isTransparent());  // 仍由第一 Technique 决定

  return lab::report("08-1 材质:Material/Technique/Pass 三层结构");
}

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

小结

  • Material 是「视觉效果的完整描述」,相当于一个 Shader;Technique 是不同硬件下的实现方案。
  • Pass 是一次绘制的状态集合:四色 + 光泽度 + 混合 + 纹理单元。
  • 透明判定逐级下推:Material → 第一 Technique → 第一 Pass → 混合状态。
  • OGRE 的 SceneBlendFactor 是 SBF_ONE=0、SBF_ZERO=1,与 D3D 相反。

阅读导航:上一节:7.3 IndexData 与索引缓冲 · 下一节:8.2 TextureUnitState 与纹理单元 。

继续阅读

探索更多技术文章

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

全部文章 返回首页

「books」更多文章

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