Web 图形与 3D / 系统课时

清点网格材质与动画清单

清点网格材质与动画清单

拿到 GLB 资产后,先核对它到底包含哪些可渲染与可动画资源。下面用 Three.js 读取场景树,分别列出网格、材质、纹理、骨骼、动画剪辑与形变目标,再把结果转成一份可复查的导入验收清单。

学习目标

  • 区分网格实例、共享材质与纹理、骨骼绑定、动画剪辑和形变目标。
  • 使用 GLTFLoader 自动清点 GLB 资产,并识别不同动画能力。
  • 根据实际清点结果填写验收表,发现缺失资源和异常绑定。

认清资源之间的关系

glTF 的场景由节点组成,节点可以带网格,也可以只是父级变换节点。Three.js 中通过 gltf.scenes 查看全部场景;网格对象的 geometry 表示几何数据,material 指向一个或多个材质,材质再引用颜色、法线或粗糙度等纹理。多个网格可能共用同一材质或纹理,不能简单地把网格数量当作材质数量。

检查对象 Three.js 对应项 需要记录的内容
网格 Mesh、SkinnedMesh 节点名、类型、数量
几何体 geometry 是否复用、是否带形变数据
材质与纹理 material、map 等 材质名、纹理槽、是否缺失
骨骼 SkinnedMesh.skeleton.bones 绑定骨骼数
形变目标 morphTargetInfluences 可调形变通道数
动画 gltf.animations 剪辑名、时长、轨道数

动画剪辑保存在 gltf.animations,其轨道可以驱动节点变换、骨骼或形变权重;它并不是某个网格的子对象。骨骼绑定存在,不代表文件一定附带可播放动作。

glTF 资源的网格、材质、骨骼和动画绑定关系

用脚本生成清单

准备 Node.js 20.19+ 或 22.12+,使用 Vite 的 Vanilla JavaScript 模板。这里通过浏览器选择 资源完整内嵌、未使用 Draco、Meshopt 或 KTX2 压缩的 .glb 文件,不依赖固定模型路径。

bash
npm create vite@latest asset-audit -- --template vanilla
cd asset-audit
npm install
npm install three

预期结果:创建 asset-audit 项目,package.json 中包含 vite 和 three 依赖;具体安装日志随版本变化。

将项目根目录的 main.js 替换为以下完整代码。脚本遍历全部场景,用 Set 对共享资源去重;骨骼数按网格记录,形变目标按通道数记录,避免把 position 和 normal 两组形变数据重复计算。

js
import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js';

const input = document.createElement('input');
input.type = 'file';
input.accept = '.glb';
document.body.replaceChildren(input);
const loader = new GLTFLoader();

input.addEventListener('change', async () => {
  const file = input.files?.[0];
  if (!file) return;

  try {
    const gltf = await loader.parseAsync(await file.arrayBuffer(), '');
    const seen = new Set();
    const geometries = new Set();
    const materials = new Set();
    const textures = new Set();
    const meshes = [];

    // 检查所有场景,避免遗漏非默认场景中的对象。
    for (const scene of gltf.scenes) {
      scene.traverse((node) => {
        if (!node.isMesh || seen.has(node)) return;
        seen.add(node);
        geometries.add(node.geometry);
        const mats = Array.isArray(node.material) ? node.material : [node.material];

        for (const material of mats) {
          if (!material) continue;
          materials.add(material);
          for (const value of Object.values(material)) {
            if (value?.isTexture) textures.add(value);
          }
        }

        meshes.push({
          name: node.name || `(未命名-${meshes.length + 1})`,
          type: node.isSkinnedMesh ? 'SkinnedMesh' : 'Mesh',
          material: mats.map((m) => m?.name || '(未命名)').join(', '),
          bones: node.isSkinnedMesh ? node.skeleton.bones.length : 0,
          morphs: node.morphTargetInfluences?.length ?? 0
        });
      });
    }

    console.table(meshes);
    console.table([...materials].map((m) => ({
      material: m.name || '(未命名)',
      textureSlots: Object.entries(m)
        .filter(([, v]) => v?.isTexture)
        .map(([slot, t]) => `${slot}:${t.name || '(未命名)'}`).join(', ')
    })));
    console.table(gltf.animations.map((clip) => ({
      clip: clip.name || '(未命名)',
      seconds: Number(clip.duration.toFixed(2)),
      tracks: clip.tracks.length
    })));
    console.log(`验收统计:${gltf.scenes.length} 场景,${meshes.length} 网格,${geometries.size} 几何体,${materials.size} 材质,${textures.size} 纹理,${gltf.animations.length} 剪辑`);
  } catch (error) {
    console.error('GLB 读取失败:', error);
  }
});

预期结果:成功读取文件后,浏览器控制台依次出现网格表、材质纹理槽表、动画剪辑表和一行“验收统计”。数量与名称来自所选 GLB,静态模型的剪辑数可以为 0。其中纹理数是 Three.js 纹理对象去重数,不等于原始图片文件数。

启动开发服务器:

bash
npm run dev

预期结果:终端显示本地预览地址,通常为 http://localhost:<PORT>/;实际端口可能不同。打开页面选择 GLB,按 F12 进入浏览器开发者工具的 Console 查看三张表和统计行。

根据清单判定动画能力

清点现象 判定 还要验证什么
无骨骼、无形变、无剪辑 静态展示资产 仍可由程序旋转、移动整个对象
无骨骼、有节点变换轨道 刚体动画资产 轨道是否指向实际节点
有 SkinnedMesh 和骨骼 已绑定蒙皮 是否有驱动骨骼的剪辑
形变通道数大于 0 支持形变 是否有表情权重动画或运行时控制
有剪辑但轨道为 0 动画信息异常 检查导出动作是否为空

例如一个角色显示 bones=48、morphs=12,同时包含 Idle、Walk、Talk 三个剪辑,它具有骨骼与表情控制数据;但仍要用 AnimationMixer 实际播放,才能确认轨道绑定正确。仅有剪辑名或骨骼数不能算动作验收通过。

整理验收记录与异常

为每个交付文件保留一行汇总,再附脚本生成的网格与剪辑明细。下面的数字是填写示例,并非脚本固定输出:

文件 网格 材质/纹理 骨骼/形变 剪辑 验收状态
display.glb 3 2/4 0/0 0 静态清单通过
hero.glb 7 3/5 48/12 3 待播放验证

交付前按以下顺序复核:

  1. 核对文件名、来源版本、网格及材质名称;重名或未命名节点应记录并回源文件处理。
  2. 逐项检查材质的纹理槽。脚本只能证明纹理对象存在,颜色空间、贴图方向和实际外观仍需渲染检查。
  3. 对每个必需动作确认剪辑时长大于 0、轨道数大于 0,并进行播放验证;没有附带剪辑的蒙皮角色标记为“仅骨骼绑定”。
  4. 对形变资产逐个测试权重 0 和 1 的外观,确认没有破面或不合理位移。

验收表记录的是当前文件真实可用的资源能力,而不是根据“角色”“静态”这样的文件名推测用途。下一次模型更新后重跑脚本,对照数量、名称和动作时长的变化,就能快速发现遗漏。

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

目录与阅读设置

阅读设置

17

记录一个想法

清点网格材质与动画清单

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

登录哪都通