图形渲染与 Shader / 系统课时

加载三维模型

加载三维模型

本节解决“怎样把外部模型文件变成 OpenGL 可继续处理的数据”这一问题。你将用 Assimp 打开模型,检查场景节点,读取网格顶点、索引和材质贴图引用,并明确哪些数据必须在 Assimp::Importer 生命周期结束前复制出来。

学习目标

  • 使用 Assimp::Importer 导入常见三维模型并检查失败原因。
  • 从 aiScene 中读取节点、网格、顶点、索引与材质引用。
  • 将 Assimp 的 CPU 侧数据映射为后续创建 VBO、EBO 和纹理所需的数据。

从文件到可渲染数据

Assimp 不直接替你调用 OpenGL。它先把文件解析为 aiScene:节点 aiNode 组成层级树,节点通过网格索引引用 aiMesh,网格再通过 mMaterialIndex 引用 aiMaterial。因此导入后的关键任务是沿着“节点 → 网格 → 材质”关系把需要的数据复制到自己的模型结构中。

Assimp 模型导入后的数据关系

常用后处理标志中,aiProcess_Triangulate 把面转换为三角形,便于直接构造索引缓冲;aiProcess_GenSmoothNormals 可在模型缺少法线时生成平滑法线;aiProcess_FlipUVs 适合纹理坐标原点与图片加载约定相反的项目,但是否启用应与现有纹理流程一致。

读取节点、网格和材质

下面的完整控制台程序不会创建 OpenGL 上下文,它专门验证模型解析是否正确。运行前需要安装并链接 Assimp;程序会递归访问节点,对每个被引用的网格打印顶点数、三角形索引数、材质编号和第一张漫反射贴图路径。

cpp
#include <assimp/Importer.hpp>
#include <assimp/postprocess.h>
#include <assimp/scene.h>
#include <assimp/material.h>

#include <cstddef>
#include <filesystem>
#include <iostream>
#include <string>

std::string firstDiffuseTexture(const aiScene* scene,
                                const aiMesh* mesh,
                                const std::filesystem::path& modelDir) {
    if (mesh->mMaterialIndex >= scene->mNumMaterials) {
        return "<none>";
    }

    const aiMaterial* material = scene->mMaterials[mesh->mMaterialIndex];
    aiString texturePath;
    if (material->GetTexture(aiTextureType_DIFFUSE, 0, &texturePath) != AI_SUCCESS) {
        return "<none>";
    }

    std::string raw = texturePath.C_Str();
    if (!raw.empty() && raw.front() == '*') {
        return "<embedded>";
    }
    return (modelDir / std::filesystem::path(raw)).lexically_normal().string();
}

void inspectNode(const aiScene* scene,
                 const aiNode* node,
                 const std::filesystem::path& modelDir) {
    std::cout << "node=" << node->mName.C_Str()
              << " meshes=" << node->mNumMeshes
              << " children=" << node->mNumChildren << std::endl;

    for (unsigned int i = 0; i < node->mNumMeshes; ++i) {
        const unsigned int meshIndex = node->mMeshes[i];
        const aiMesh* mesh = scene->mMeshes[meshIndex];

        std::size_t indexCount = 0;
        for (unsigned int f = 0; f < mesh->mNumFaces; ++f) {
            indexCount += mesh->mFaces[f].mNumIndices;
        }

        std::cout << "  mesh=" << meshIndex
                  << " vertices=" << mesh->mNumVertices
                  << " indices=" << indexCount
                  << " material=" << mesh->mMaterialIndex
                  << " diffuseTexture="
                  << firstDiffuseTexture(scene, mesh, modelDir)
                  << std::endl;
    }

    for (unsigned int i = 0; i < node->mNumChildren; ++i) {
        inspectNode(scene, node->mChildren[i], modelDir);
    }
}

int main(int argc, char** argv) {
    if (argc != 2) {
        std::cerr << "usage: model_info <model-file>" << std::endl;
        return 1;
    }

    const std::filesystem::path modelPath = argv[1];
    Assimp::Importer importer;
    const aiScene* scene = importer.ReadFile(
        modelPath.string(),
        aiProcess_Triangulate |
        aiProcess_GenSmoothNormals |
        aiProcess_FlipUVs
    );

    if (scene == nullptr || scene->mRootNode == nullptr ||
        (scene->mFlags & AI_SCENE_FLAGS_INCOMPLETE) != 0) {
        std::cerr << "Assimp error: " << importer.GetErrorString() << std::endl;
        return 2;
    }

    std::cout << "model=" << modelPath.string()
              << " sceneMeshes=" << scene->mNumMeshes
              << " materials=" << scene->mNumMaterials << std::endl;

    inspectNode(scene, scene->mRootNode, modelPath.parent_path());
    return 0;
}

预期输出

text
model=<PATH> sceneMeshes=<VALUE> materials=<VALUE>
node=<VALUE> meshes=<VALUE> children=<VALUE>
  mesh=<ID> vertices=<VALUE> indices=<VALUE> material=<ID> diffuseTexture=<VALUE>

<PATH>、<ID> 和 <VALUE> 会随模型而变化。若导入失败,程序会输出 Assimp error: <VALUE> 并以非零状态结束;此时应先检查文件路径、格式支持和模型文件是否损坏。

映射到 OpenGL 资源

真正渲染时,不要把 aiMesh* 长期保存为自己的模型数据。aiScene 的内存由 Assimp::Importer 管理,Importer 析构后这些指针就失效。应在它仍存活时复制顶点属性和索引,并把材质信息转成自己的纹理或参数结构。

通常可按以下关系转换:mVertices 对应顶点位置;mNormals 在存在时对应法线;mTextureCoords[0] 是第一组 UV;每个 aiFace 的 mIndices 组成 EBO 索引;mMaterialIndex 用于找到材质,再由材质中的纹理路径加载图片并创建 OpenGL 纹理对象。

只要控制台检查得到合理的节点、网格和材质数据,下一步就可以把这些 CPU 侧数组上传为 VAO/VBO/EBO,并在绘制每个网格时绑定对应材质资源。

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

目录与阅读设置

阅读设置

17

记录一个想法

加载三维模型

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

登录哪都通