图形渲染与 Shader / 系统课时
加载模型材质纹理
加载模型材质纹理
模型网格通常只保存材质索引,真正的漫反射、镜面和法线纹理路径位于材质中。本课把材质纹理解析成可加载路径,并处理相对路径、缺失纹理与法线纹理类型差异,让模型导入后能正确找到资源。
学习目标
- 从 Assimp 的
aiMaterial读取漫反射、镜面和法线纹理。 - 以模型文件所在目录为基准解析材质中的相对路径。
- 识别纹理语义差异,并为缺失或异常路径建立清晰的降级策略。
先看清模型、材质与纹理的关系
一个网格通过 mMaterialIndex 指向场景中的 aiMaterial。材质再保存若干纹理槽,槽内通常是相对模型文件或材质文件的路径。加载器不能把这个字符串直接交给图片库,而要先和模型目录组合并规范化。

常用映射是 aiTextureType_DIFFUSE 对应漫反射贴图,aiTextureType_SPECULAR 对应镜面贴图,aiTextureType_NORMALS 对应法线贴图。部分格式或导入器会把凹凸/法线资源暴露为 aiTextureType_HEIGHT,因此工程中常把它作为法线纹理的兼容回退。
读取纹理并解析相对路径
下面是片段示例,依赖已完成 Assimp 场景导入,并假定 modelPath 是当前模型文件路径。函数只负责把材质中的纹理条目转换成规范化文件路径,真正的 GPU 上传可在后续纹理加载器中完成。
#include <assimp/material.h>
#include <algorithm>
#include <filesystem>
#include <iostream>
#include <string>
#include <vector>
struct MaterialTextureRef {
std::string type;
std::string source;
bool embedded;
};
std::vector<MaterialTextureRef> collectTextures(
aiMaterial* material,
aiTextureType assimpType,
const std::string& typeName,
const std::filesystem::path& modelPath) {
std::vector<MaterialTextureRef> result;
const auto baseDir = modelPath.parent_path();
for (unsigned int i = 0; i < material->GetTextureCount(assimpType); ++i) {
aiString rawPath;
if (material->GetTexture(assimpType, i, &rawPath) != AI_SUCCESS) {
continue;
}
std::string source = rawPath.C_Str();
if (!source.empty() && source.front() == '*') {
// *0、*1 等表示场景内嵌纹理,后续应从 aiScene::mTextures 读取。
result.push_back({typeName, source, true});
std::cout << typeName << ": embedded " << source << "\n";
continue;
}
// 兼容由 Windows 工具写出的反斜杠路径,再以模型目录解析相对路径。
std::replace(source.begin(), source.end(), '\\', '/');
std::filesystem::path texturePath(source);
std::filesystem::path resolved = texturePath.is_absolute()
? texturePath.lexically_normal()
: (baseDir / texturePath).lexically_normal();
result.push_back({typeName, resolved.generic_string(), false});
std::cout << typeName << ": " << resolved.generic_string() << "\n";
}
return result;
}预期输出
texture_diffuse: <PATH>/textures/body_albedo.png
texture_specular: <PATH>/textures/body_specular.png
texture_normal: <PATH>/textures/body_normal.png<PATH> 会随模型所在目录变化。代码会先统一路径分隔符,再区分绝对路径和相对路径;相对路径以模型目录为基准,绝对路径则直接规范化。
为三类纹理建立统一入口
调用时可以先读取三类主要纹理,再对法线纹理做兼容回退。这样材质处理逻辑集中在一个位置,Mesh 只接收已经标记好用途的纹理引用。
auto diffuse = collectTextures(
material, aiTextureType_DIFFUSE, "texture_diffuse", modelPath);
auto specular = collectTextures(
material, aiTextureType_SPECULAR, "texture_specular", modelPath);
auto normal = collectTextures(
material, aiTextureType_NORMALS, "texture_normal", modelPath);
if (normal.empty()) {
normal = collectTextures(
material, aiTextureType_HEIGHT, "texture_normal", modelPath);
}预期结果
材质中的各纹理槽被转换为统一的 texture_* 语义,并得到以模型目录为基准的规范化路径;没有 NORMALS 条目时再尝试 HEIGHT。处理路径和纹理语义的边界
跨平台时建议统一用 std::filesystem::path 处理目录组合,不要手工拼接分隔符。导入外部资源时还要警惕路径大小写差异、纹理文件被移动,以及 Assimp 的嵌入纹理标识;当路径以 * 开头时,它不是普通磁盘路径,应保留索引并转到 aiScene::mTextures 读取。
加载完成后,最关键的验收不是“路径字符串看起来正确”,而是确认每个 Mesh 的材质索引能得到正确纹理集合,且纹理文件实际存在或能从内嵌资源中取得。