@jyostudio/model-loader

一个用于加载和解析 .obj 或 .fbx 模型文件的 JavaScript 库，适用于浏览器和 Node.js 环境。

v1.0 TypedArray 输出

从 v1.0 起，parse() 返回的网格数据改为紧凑的 TypedArray，以降低大模型的解析耗时与内存占用：

• mesh.vertices / parameterVertices：Float32Array，每顶点 4 个 float（xyzw）
• mesh.textureCoordinates：Float32Array，每项 2 个 float（uv）
• mesh.normals / colors：Float32Array，每项 3 个 float
• mesh.tangents：Float32Array，每项 4 个 float（xyzw）
• face.vertexIndices 等索引数组：Uint32Array
• mesh.skin：扁平化 jointOffsets（每顶点偏移）+ jointIndices + jointWeights
• skinningData.bindPose / inverseBindPose：Float32Array，每骨骼 16 个 float（行主序）
• skinningData.skeletonHierarchy：Int32Array；inheritTypes：Uint8Array

没有对应图层时，法线/UV/颜色/切线字段为 undefined（v0.x 的空数组已被移除）。

FBX 兼容性

仓库测试覆盖 FBX 6.1 以及部分 FBX 7.1-7.7 的 ASCII/二进制核心网格、材质纹理、蒙皮和单层骨骼动画路径。该加载器不是完整的 FBX SDK 实现；详细的已验证能力、部分支持项和未支持项见 test/FBX_COMPATIBILITY.md。

许可证

MIT License

Copyright (c) 2025 nivk

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.