指南 / GLB 检查

TO3D GLB 里面有什么

下面四个固定样例与公开 Examples 页面使用的资源相同。它们能证明文件结构,但不能保证引擎兼容性或动画质量。

已于 2026 年 9 月 27 日核验

交互式预览

四个固定样例

这些是 Examples 页面使用的同一组公开文件。你可以下载它们或旋转内嵌预览。

正在加载交互模型 —

Fantasy Knight

1 张内嵌 PNG、UV、蒙皮权重和 1 个 idle 动画。

下载 GLB
正在加载交互模型 —

Sci-fi Scout

1 张内嵌 PNG、UV、蒙皮权重和 1 个 idle 动画。

下载 GLB
正在加载交互模型 —

Robot Companion

1 张内嵌 PNG、UV、蒙皮权重和 5 个动画片段。

下载 GLB
正在加载交互模型 —

Hooded Ranger

1 张内嵌 PNG、UV、蒙皮权重和 1 个 idle 动画。

下载 GLB

四个文件,一组固定样例

上面的下载链接适合用作查看器或导入测试的确定性 fixture。文件名和路径在各语言之间保持不变。

  • gen-knight-idle.glb 有 37 个关节。
  • gen-scout-idle.glb 有 34 个关节。
  • herobot-char.glb 和 gen-ranger-idle.glb 各有 22 个关节。
curl -fL https://to3d.app/showcase/gen-knight-idle.glb -o knight.glb
公开样例文件
文件字节关节蒙皮顶点蒙皮UV纹理动画
gen-knight-idle.glb780998037118054JOINTS_0 + WEIGHTS_0是内嵌 PNG1 个待机
gen-scout-idle.glb35439003439980JOINTS_0 + WEIGHTS_0是内嵌 PNG1 个待机
herobot-char.glb65044562291328JOINTS_0 + WEIGHTS_0是内嵌 PNG5 个片段
gen-ranger-idle.glb45683522262363JOINTS_0 + WEIGHTS_0是内嵌 PNG1 个待机

检查字段

使用 glTF 检查器可以在不打开游戏引擎的情况下查看相同数据。寻找引用 joints 的 skin、JOINTS_0 与 WEIGHTS_0 属性、UV 坐标,以及 GLB 容器中的图片。

  • 关节数就是 skin 引用的节点数量。
  • 权重表示每个关节对顶点的影响程度;仍需检查姿势和变形。
  • 内嵌 PNG 表示样例自带纹理,不依赖单独的图片 URL。
npx @gltf-transform/cli inspect https://to3d.app/showcase/gen-knight-idle.glb

如何理解结果

这些字段说明样例包含蒙皮网格和可用的纹理坐标,能帮助你选择流水线测试 fixture,也解释了 Examples 查看器为何能显示骨架。

  • GLB 是容器;文件存在并不保证特定渲染器或导入设置。
  • 动画片段是样例数据,不代表所有目标工具都能对其重定向。
  • 使用内嵌预览和目标工具检查缩放、姿势、材质与播放效果。
# Record the file, viewer, importer, and result when comparing a target tool
printf '%s\n' 'fixture=gen-knight-idle.glb'

验证范围

结构读回比完整集成测试更窄。面部 blendshape、口型同步、VRM、视觉质量以及 Unity/Unreal 重定向都需要在目标工具中单独验证。

  • 这里没有证据表明四个样例包含 morph targets。
  • 在计划使用模型的工具、引擎或查看器中进行检查。
  • 需要新生成而不是固定 fixture 时,请使用 API 指南。
# Structural evidence is not an engine acceptance test
printf '%s\n' 'inspect -> import -> pose -> playback'