图形渲染与 Shader / 系统课时

加载模型材质纹理

加载模型材质纹理

模型网格通常只保存材质索引,真正的漫反射、镜面和法线纹理路径位于材质中。本课把材质纹理解析成可加载路径,并处理相对路径、缺失纹理与法线纹理类型差异,让模型导入后能正确找到资源。

学习目标

  • 从 Assimp 的 aiMaterial 读取漫反射、镜面和法线纹理。
  • 以模型文件所在目录为基准解析材质中的相对路径。
  • 识别纹理语义差异,并为缺失或异常路径建立清晰的降级策略。

先看清模型、材质与纹理的关系

一个网格通过 mMaterialIndex 指向场景中的 aiMaterial。材质再保存若干纹理槽,槽内通常是相对模型文件或材质文件的路径。加载器不能把这个字符串直接交给图片库,而要先和模型目录组合并规范化。

模型材质纹理路径解析关系

常用映射是 aiTextureType_DIFFUSE 对应漫反射贴图,aiTextureType_SPECULAR 对应镜面贴图,aiTextureType_NORMALS 对应法线贴图。部分格式或导入器会把凹凸/法线资源暴露为 aiTextureType_HEIGHT,因此工程中常把它作为法线纹理的兼容回退。

读取纹理并解析相对路径

下面是片段示例,依赖已完成 Assimp 场景导入,并假定 modelPath 是当前模型文件路径。函数只负责把材质中的纹理条目转换成规范化文件路径,真正的 GPU 上传可在后续纹理加载器中完成。

cpp
#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;
}

预期输出

text
texture_diffuse: <PATH>/textures/body_albedo.png
texture_specular: <PATH>/textures/body_specular.png
texture_normal: <PATH>/textures/body_normal.png

<PATH> 会随模型所在目录变化。代码会先统一路径分隔符,再区分绝对路径和相对路径;相对路径以模型目录为基准,绝对路径则直接规范化。

为三类纹理建立统一入口

调用时可以先读取三类主要纹理,再对法线纹理做兼容回退。这样材质处理逻辑集中在一个位置,Mesh 只接收已经标记好用途的纹理引用。

cpp
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);
}

预期结果

text
材质中的各纹理槽被转换为统一的 texture_* 语义,并得到以模型目录为基准的规范化路径;没有 NORMALS 条目时再尝试 HEIGHT。

处理路径和纹理语义的边界

跨平台时建议统一用 std::filesystem::path 处理目录组合,不要手工拼接分隔符。导入外部资源时还要警惕路径大小写差异、纹理文件被移动,以及 Assimp 的嵌入纹理标识;当路径以 * 开头时,它不是普通磁盘路径,应保留索引并转到 aiScene::mTextures 读取。

加载完成后,最关键的验收不是“路径字符串看起来正确”,而是确认每个 Mesh 的材质索引能得到正确纹理集合,且纹理文件实际存在或能从内嵌资源中取得。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

加载模型材质纹理

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通