Web 图形与 3D / 系统课时

用 glTF Transform 清除冗余资源

用 glTF Transform 清除冗余资源

从 Blender 导出的 GLB 可能包含重复材质、纹理和已失去引用的网格。这里用 glTF Transform 先检查、再去重和清理,留下可回退的中间文件,并用结构报表与 Three.js 实际加载结果确认动画和材质没有损坏。

学习目标

  • 区分 dedup 可合并的重复数据与 prune 可删除的无引用数据。
  • 使用 CLI 对 GLB 分步清理,比较文件大小及资源数量。
  • 验证节点名称、蒙皮、材质和动画仍满足运行时需求。

识别冗余与引用边界

glTF 资源之间存在引用关系:场景引用节点,节点引用网格或骨架,网格图元引用顶点 Accessor 和材质,材质再引用纹理;动画通道则指向节点。判断资源能否清理,必须沿引用关系检查,而不能只看名称。

  • dedup 比较 Accessor、纹理、材质、网格和 Skin 等资源的内容,尽可能把相同资源改为共享引用;它不会把两个形状不同的网格强行合并。
  • prune 移除不再被场景引用的属性及资源。例如删除模型上的装饰节点后,原网格与材质可能成为可清理对象。
  • 如果某段动画只作用于场景树之外的节点,prune 可能把它视为未使用;计划运行时重定向的动画,不应未经检查就直接清理。

GLB 去重与无引用资源清理前后的引用结构

分步执行可回退的清理

以下适用于 glTF Transform CLI 4.5.1、Node.js LTS 和 Bash 环境。在已有 package.json 的项目根目录执行,并准备有效的 assets/character.glb。本轮只做重复资源合并与无引用资源清理,不启用会改变几何精度或纹理格式的压缩。

bash
set -e
npm install --save-dev @gltf-transform/cli@4.5.1
mkdir -p dist

# 清理前先记录资源表,原始文件始终不覆盖
npx gltf-transform inspect assets/character.glb --format md > dist/before.md
npx gltf-transform dedup assets/character.glb dist/character-dedup.glb

# 保留自定义顶点数据、空挂点和纯色纹理的原始形式
npx gltf-transform prune dist/character-dedup.glb dist/character-clean.glb --keep-attributes true --keep-leaves true --keep-solid-textures true
npx gltf-transform inspect dist/character-clean.glb --format md > dist/after.md
npx gltf-transform validate dist/character-clean.glb
wc -c assets/character.glb dist/character-clean.glb
test -s dist/character-clean.glb
printf 'PASS: clean GLB exists\n'

预期结果:两份 Markdown 资源报表及 dist/character-clean.glb 均已生成;wc 显示实际字节数,随输入文件而变化。输入合法且全部命令成功时,终端最后一行为:

text
PASS: clean GLB exists

三个保留选项用于降低误删风险:--keep-attributes true 避免剔除运行时可能读取的额外顶点通道(例如用于光照贴图的 TEXCOORD_1);--keep-leaves true 保留空叶节点挂点;--keep-solid-textures true 避免把纯色纹理替换为材质常量。它们不保证保留所有场景外资源。

对比文件体积与资源表

打开 dist/before.md 与 dist/after.md,按 Scene、Mesh、Material、Texture、Animation 表逐项比对。dedup 后材质或网格数量下降,并不代表可见物体数量应该下降;多处节点可能开始共享同一底层资源。

例如,原文件 14 MiB、清理后 11 MiB,减少 3 MiB,体积下降约 21.4%。这是计算示例,不是上一段命令的固定输出。实际以 wc -c 的字节数计算:(原始字节数 - 清理后字节数) / 原始字节数 × 100%。

检查时优先确认动画片段的名称和数量、可见网格的结构、使用中的材质及贴图是否符合预期。只要文件变小却丢了动画或贴图,就不能视为成功。若大小几乎不变,通常意味着原文件冗余较少;不必为了追求压缩率继续删除资源。

在 Three.js 中完成回归验证

GLB 通过 validate 只说明格式检查结果,不能证明业务脚本依赖的名称、挂点和外观都未变。将清理后的文件复制到 Vite 项目的 public/models/character-clean.glb,用原场景的相机、灯光和动画逻辑做并排测试。

  1. 分别用 GLTFLoader.loadAsync() 加载原版与清理版,比较 gltf.animations.map(clip => clip.name);预期使用中的动作名称与数量一致。
  2. 用 gltf.scene.getObjectByName('实际节点名') 检查代码依赖的骨骼、武器挂点和碰撞辅助节点;不存在时停止替换正式资源。
  3. 播放 Idle、Walk 等实际使用的动作至少各一个循环,检查蒙皮拉伸、Morph Target、材质颜色、透明度与纹理朝向。
  4. 在同一设备、相同相机位置下记录加载字节数、加载耗时和帧时间。dedup、prune 主要减少冗余数据,并不保证 Draw Call 或帧时间降低。

清理版只有同时通过格式检查、资源表核对和实际动画渲染测试,才适合替换上线资产。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 glTF Transform 清除冗余资源

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

登录哪都通