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 按相机与顶点夹角生成纹理坐标(球面/平面反射)。这就是水面滚动、反射球、投影纹理这些效果在源码里的落脚点。
源码定位
OgreMain/include/OgreTexture.h:TextureType(TEX_TYPE_1D/2D/3D/CUBE_MAP 等)OgreMain/include/OgreCommon.h:TextureFilterOptions/FilterType/FilterOptionsOgreMain/include/OgreTextureUnitState.h:TextureUnitState(setTextureName/setTextureCoordSet/setTextureFiltering/setTextureScroll/TextureEffectType)
上游引用固定到 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 材质脚本与状态合并 。
继续阅读
探索更多技术文章
浏览归档,发现更多关于系统设计、工具链和工程实践的内容。