c++ gltf模型加载 c++如何使用tinygltf加载3d模型-C++-PHP中文网

tinygltf加载失败主因有四：未实现buffer/image loader导致.bin和纹理缺失；bufferview/accessor索引错乱致顶点数据错误；windows中文路径因fopen不支持utf-8而静默失败；扩展如khr_skinning未在extensionsused声明致动画/蒙皮丢失。

c++ gltf模型加载 c++如何使用tinygltf加载3d模型

tinygltf 加载失败：找不到 `model.bin` 或纹理路径不对

tinygltf 默认只解析 glTF JSON（.gltf）本身，不会自动读取外部 .bin 文件或图片——它把路径当字符串存着，读不读、怎么读全靠你自己。

常见错误是直接调用 LoadASCIIFromFile() 后就以为模型“加载完了”，结果 model.buffers 为空，或者 model.images 里全是空数据。

必须手动实现 TinyGLTF::SetImageLoader() 和 TinyGLTF::SetBufferLoader()，否则所有二进制和图片都跳过
buffer loader 要按 model.buffers[i].uri 拼出完整路径（比如 "scene.bin" 得拼成 "assets/scene.bin"），然后用 fread 或 std::ifstream 读进 buffer->data
image loader 同理，但注意：glTF 允许 base64 内联图片（data:image/png;base64,...），URI 以 data: 开头就得走 base64 解码，不能当文件读

顶点数据没对上：`bufferView` 和 `accessor` 索引错乱

tinygltf 把原始 buffer 数据、视图切片（bufferView）、语义解释（accessor）三层分开存，不是直接给你一个 std::vector<:vec3></:vec3>。手抖写错索引，轻则黑屏，重则越界崩溃。

典型表现：网格显示为一团乱线，或 accessor.count 明明是 1000，但读出来的顶点只有前 10 个有值。

先确认 accessor.bufferView 不是 -1（-1 表示数据内联在 accessor 的 min/max 里，仅限极小量元数据）
再查 model.bufferViews[accessor.bufferView] 的 buffer 索引是否有效，再查 model.buffers[bufferView.buffer] 是否已成功加载
最后算偏移：顶点起始位置 = bufferView.byteOffset + accessor.byteOffset，每个顶点字节数由 accessor.type（如 VEC3）和 accessor.componentType（如 FLOAT）共同决定，别硬编码为 sizeof(float) * 3

Windows 下中文路径加载失败：`LoadASCIIFromFile()` 返回 false

tinygltf 内部用 fopen() 打开文件，而 Windows 上 fopen() 不支持 UTF-8 路径（哪怕你的源文件名是中文）。编译器没报错，但函数默默返回 false，err 里只写 “Unable to open file”，非常误导。

C++14

C++14 对 C++11 的修正与增强版本，适合旧系统维护和较老工具链兼容。

下载

这不是 tinygltf 的 bug，是 C 标准库限制。你得绕开它。

Linux/macOS 一般没事；Windows 必须把路径转成宽字符，用 _wfopen() 替换底层逻辑，或改用内存加载（先把文件用 std::ifstream 读到 std::vector<char></char>，再调 LoadASCIIFromString()）
更稳妥的做法：统一用资源 ID 或相对路径，避免在路径里出现中文；如果必须支持，提前把 glTF 文件所在目录设为当前工作目录，再用纯文件名传入
别依赖 err 字符串判断原因——它常为空，优先检查返回值和 model.errors 容器

动画和皮肤数据存在但 `model.skins` 为空？检查 `extensionsUsed`

有些导出器（比如 Blender 的某些插件）会把 skin 或 morph target 存在 KHR_animation_pointer 或 EXT_mesh_gpu_instancing 这类扩展里，而不是标准字段。tinygltf 默认不解析未声明的扩展。

现象是：模型静止不动，model.animations.size() 非零，但 model.skins.size() == 0，且节点 skin 索引是 -1。

先看 model.extensionsUsed 里有没有 "KHR_skinning"；没有的话，说明导出时没勾选“导出蒙皮”，或者用了非标准方式绑定骨骼
即使有，也要确认 model.skins 是不是空——有些模型把 joints 放在 node 的 extensions.KHR_lights_punctual 里（误配），tinygltf 就不管
建议用 glTF Validator 检查模型合规性，比对着代码猜快得多

事情说清了就结束。最麻烦的永远不是加载，而是验证每一步的数据是否真被正确提取出来——尤其是 bufferView 的 byteLength 和 accessor 的 count 对不上时，得一层层打印索引和 size，别信直觉。