《OGRE 3D 渲染引擎原理与架构》8.2 TextureUnitState 与纹理单元

纹理单元是 Pass 里的一次纹理采样:纹理名、类型、坐标集、过滤与变换。纹理类型用 TEX_TYPE_2D/CUBE_MAP 等枚举区分,立方体贴图固定 6 面。TFO_TRILINEAR 这类高级过滤选项展开成 min/mag/mip 三个基础过滤选项。纹理效果枚举支持环境映射、滚动、旋转等程序化变换。lab 用 C++ 复现类型、过滤展开与坐标集。

8.2 TextureUnitState 与纹理单元

一个 Pass 要贴几张纹理、怎么采样,由纹理单元描述。TextureUnitState(简称 TUS)封装一次纹理采样的全部状态:纹理是哪个、什么类型、用哪组 UV、怎么过滤、怎么变换。

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

cg 卷二的纹理与采样讲采样理论的数学;本系列 8.2 讲 OGRE 里纹理采样状态的 C++ 表达:纹理类型、坐标集、过滤枚举与程序化变换。

纹理类型:TextureType

纹理不只有 2D。OGRE 的 TextureType 枚举覆盖了全部形态:

// OgreMain/include/OgreTexture.h:TextureType(v14.6.3 源码摘录,已删减)
    enum TextureType : uint8
    {
        TEX_TYPE_1D = 1,
        TEX_TYPE_2D = 2,
        TEX_TYPE_3D = 3,
        TEX_TYPE_CUBE_MAP = 4,
        TEX_TYPE_2D_ARRAY = 5,
        TEX_TYPE_2D_MULTISAMPLE = 6,
        ...
    };

类型不是装饰——它直接决定内存布局与采样方式:立方体贴图固定 6 个面(getNumFaces 返回 6),3D 纹理按深度寻址,数组纹理按层索引。

纹理坐标集:多组 UV 的编号

一个网格可以有不止一组 UV(漫反射一组、法线贴图一组)。setTextureCoordSet 选择用哪组:

// OgreMain/include/OgreTextureUnitState.h:setTextureCoordSet(v14.6.3 源码摘录,已删减)
        void setTextureCoordSet(uint8 set);

这个编号与 7.2 顶点声明的 VES_TEXTURE_COORDINATES 的 index 对应——顶点里第 0 组 UV 喂给坐标集 0 的 TUS,第 1 组喂给坐标集 1。顶点声明与纹理单元通过「坐标集编号」握手。

过滤:一个选项,三组设定

纹理过滤分三档:缩小时(min)、放大时(mag)、mip 间(mip)。TextureFilterOptions 是高层快捷方式,展开成三个 FilterOptions:

// OgreMain/include/OgreCommon.h:TextureFilterOptions(v14.6.3 源码摘录,已删减)
    enum TextureFilterOptions
    {
        /// No filtering or mipmapping is used. 
        /// Equal to: min=Ogre::FO_POINT, mag=Ogre::FO_POINT, mip=Ogre::FO_NONE
        TFO_NONE,
        /// Equal to: min=Ogre::FO_LINEAR, mag=Ogre::FO_LINEAR, mip=Ogre::FO_POINT
        TFO_BILINEAR,
        /// Equal to: min=Ogre::FO_LINEAR, mag=Ogre::FO_LINEAR, mip=Ogre::FO_LINEAR
        TFO_TRILINEAR,
        /// Equal to: min=Ogre::FO_ANISOTROPIC, max=Ogre::FO_ANISOTROPIC, mip=Ogre::FO_LINEAR
        TFO_ANISOTROPIC
    };

FilterType(FT_MIN/FT_MAG/FT_MIP)标「哪一档」,FilterOptions(FO_NONE/FO_POINT/FO_LINEAR/FO_ANISOTROPIC)标「怎么滤」。TUS::setTextureFiltering(TFO_TRILINEAR) 一次设置就把三档都展开填好——这是「高层快捷方式 + 底层三档独立」的典型 API 设计。

变换:滚动、缩放与旋转

TUS 还能做程序化纹理变换,不靠改 UV 数据:

// OgreMain/include/OgreTextureUnitState.h:纹理效果类型(v14.6.3 源码摘录,已删减)
        enum TextureEffectType
        {
            /// Generate all texture coords based on angle between camera and vertex.
            ET_ENVIRONMENT_MAP,
            /// Generate texture coords based on a frustum.
            ET_PROJECTIVE_TEXTURE,
            /// Constant u/v scrolling effect.
            ET_UVSCROLL,
            /// Constant u scrolling effect.
            ET_USCROLL,
            /// Constant u/v scrolling effect.
            ET_VSCROLL,
            /// Constant rotation.
            ET_ROTATE,
            /// More complex transform.
            ET_TRANSFORM
        };

setTextureScroll/setTextureScale/setTextureRotate 把 UV 的平移/缩放/旋转存成变换参数;ET_ENVIRONMENT_MAP 按相机与顶点夹角生成纹理坐标(球面/平面反射)。这就是水面滚动、反射球、投影纹理这些效果在源码里的落脚点。

源码定位

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

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

下面复现纹理类型、立方体贴图面数、坐标集、过滤展开与变换记录。它与 src/08-2-texture-unit-state.cpp 逐字节一致:

// file: src/08-2-texture-unit-state.cpp
// tier: L1
// verify: clang++ -std=c++20 -I. src/08-2-texture-unit-state.cpp -o bin/08-2-texture-unit-state && ./bin/08-2-texture-unit-state
//
// 复现 OgreTextureUnitState 的纹理单元状态:纹理名/类型/坐标集/过滤/变换。
//   TFO_TRILINEAR 展开为 min/mag/mip 三个过滤选项;立方体贴图 6 面。
// 独立最小验证,非 OGRE 源码。
#include "verify.h"

#include <cstdint>
#include <string>

namespace ogre_repro {

// 对应 OgreTexture.h 的 TextureType(真实枚举值)
enum TextureType : uint8_t {
  TEX_TYPE_1D = 1,
  TEX_TYPE_2D = 2,
  TEX_TYPE_3D = 3,
  TEX_TYPE_CUBE_MAP = 4,
  TEX_TYPE_2D_ARRAY = 5
};

// 对应 OgreCommon.h 的过滤枚举
enum FilterType { FT_MIN, FT_MAG, FT_MIP };
enum FilterOptions : uint8_t {
  FO_NONE,
  FO_POINT,
  FO_LINEAR,
  FO_ANISOTROPIC
};
enum TextureFilterOptions { TFO_NONE, TFO_BILINEAR, TFO_TRILINEAR, TFO_ANISOTROPIC };

// 对应 TextureUnitState::getNumFaces 的立方体语义
uint32_t getNumFaces(TextureType t) {
  return t == TEX_TYPE_CUBE_MAP ? 6 : 1;
}

// 对应 OgreTextureUnitState 的简化:状态成员 + 关键 setter
class TextureUnitState {
 public:
  std::string mTextureName;
  TextureType mTextureType = TEX_TYPE_2D;
  uint8_t mTextureCoordSetIndex = 0;
  FilterOptions mMinFilter = FO_LINEAR;
  FilterOptions mMagFilter = FO_LINEAR;
  FilterOptions mMipFilter = FO_POINT;
  float mUScroll = 0, mVScroll = 0;
  float mUScale = 1, mVScale = 1;

  // 对应 setTextureName(name, ttype)
  void setTextureName(const std::string& name, TextureType ttype) {
    mTextureName = name;
    mTextureType = ttype;
  }

  // 对应 setTextureCoordSet
  void setTextureCoordSet(uint8_t set) { mTextureCoordSetIndex = set; }

  // 对应 setTextureFiltering(TextureFilterOptions):展开为三个过滤选项
  void setTextureFiltering(TextureFilterOptions filterType) {
    switch (filterType) {
      case TFO_NONE:
        mMinFilter = mMagFilter = FO_POINT; mipFilter(FO_NONE); break;
      case TFO_BILINEAR:
        mMinFilter = mMagFilter = FO_LINEAR; mipFilter(FO_POINT); break;
      case TFO_TRILINEAR:
        mMinFilter = mMagFilter = FO_LINEAR; mipFilter(FO_LINEAR); break;
      case TFO_ANISOTROPIC:
        mMinFilter = mMagFilter = FO_ANISOTROPIC; mipFilter(FO_LINEAR); break;
    }
  }

  void mipFilter(FilterOptions o) { mMipFilter = o; }

  // 对应 setTextureScroll
  void setTextureScroll(float u, float v) { mUScroll = u; mVScroll = v; }
  // 对应 setTextureScale
  void setTextureScale(float u, float v) { mUScale = u; mVScale = v; }
};

}  // namespace ogre_repro

int main() {
  using namespace ogre_repro;

  // 纹理类型枚举(真实值)
  CHECK(TEX_TYPE_1D == 1);
  CHECK(TEX_TYPE_2D == 2);
  CHECK(TEX_TYPE_3D == 3);
  CHECK(TEX_TYPE_CUBE_MAP == 4);
  CHECK(TEX_TYPE_2D_ARRAY == 5);

  // 立方体贴图 6 面,2D 1 面
  CHECK(getNumFaces(TEX_TYPE_CUBE_MAP) == 6u);
  CHECK(getNumFaces(TEX_TYPE_2D) == 1u);

  TextureUnitState tus;
  CHECK(tus.mTextureType == TEX_TYPE_2D);  // 默认 2D

  // 设纹理名与类型
  tus.setTextureName("sky_cube.png", TEX_TYPE_CUBE_MAP);
  CHECK(tus.mTextureName == "sky_cube.png");
  CHECK(tus.mTextureType == TEX_TYPE_CUBE_MAP);

  // 纹理坐标集:选第 1 组 UV
  tus.setTextureCoordSet(1);
  CHECK(tus.mTextureCoordSetIndex == 1);

  // 过滤展开:TRILINEAR = min/mag 线性 + mip 线性
  tus.setTextureFiltering(TFO_TRILINEAR);
  CHECK(tus.mMinFilter == FO_LINEAR);
  CHECK(tus.mMagFilter == FO_LINEAR);
  CHECK(tus.mMipFilter == FO_LINEAR);

  // NONE = 无过滤无 mip
  tus.setTextureFiltering(TFO_NONE);
  CHECK(tus.mMinFilter == FO_POINT);
  CHECK(tus.mMipFilter == FO_NONE);

  // 变换:滚动与缩放
  tus.setTextureScroll(0.25f, 0.5f);
  tus.setTextureScale(2.0f, 1.0f);
  CHECK(tus.mUScroll == 0.25f);
  CHECK(tus.mVScroll == 0.5f);
  CHECK(tus.mUScale == 2.0f);
  CHECK(tus.mVScale == 1.0f);

  return lab::report("08-2 材质:TextureUnitState 与纹理单元");
}

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

小结

  • 纹理类型 TEX_TYPE_2D/CUBE_MAP/3D 等决定布局与采样方式,立方体贴图 6 面。
  • setTextureCoordSet 用编号选择顶点里的哪组 UV。
  • TextureFilterOptions 是高层快捷方式,展开成 min/mag/mip 三个过滤选项。
  • TextureEffectType 支持环境映射、滚动、旋转等程序化 UV 变换。

阅读导航:上一节:8.1 Material、Technique 与 Pass · 下一节:8.3 材质脚本与状态合并 。

继续阅读

探索更多技术文章

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

全部文章 返回首页

「books」更多文章

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