Web 图形与 3D / 系统课时

识别 Morph Targets 形变通道

识别 Morph Targets 形变通道

带表情的 GLB 加载成功后,仍可能不知道哪些网格有形变通道、通道名称对应哪个权重。这里用 Three.js 检查导入结果,列出名称、索引和当前值,手动测试一个形变,并确认它能与骨骼数据同时存在于同一角色上。

学习目标

  • 读取 morphTargetDictionary 和 morphTargetInfluences,定位名称与索引。
  • 用 0、0.5、1 验证形变,并理解常用权重范围。
  • 区分 SkinnedMesh、骨骼和形变动画轨道,定位导出缺失。

对齐名称、索引与权重

Morph Target(Blender 中的 Shape Key)记录网格顶点相对基础形状的变化。加载后要检查具体的 Mesh,不是只检查 gltf.scene:mesh.morphTargetDictionary 把名称映射到数组下标,mesh.morphTargetInfluences 在相同下标存储权重,mesh.geometry.morphAttributes 则保存顶点形变数据。

例如字典是 { Smile: 0, Blink: 1 }、权重是 [0.25, 0],表示 Smile 以 25% 权重生效,Blink 未启用。名称不是 Three.js 内置枚举;原始资产若未提供名称,导入器可能使用通用名称,因此应以实际读到的字典为准。

同一个 SkinnedMesh 可以同时引用 Morph Targets 和 Skeleton:先按权重改变网格顶点,再进行骨骼蒙皮。动画片段中的权重轨道与骨骼变换轨道负责改变不同数据,不能把 gltf.animations 的片段名当作形变名称。

形变字典、权重数组与骨骼蒙皮的映射

加载 GLB 并列出通道

从空目录依次执行 npm create vite@latest morph-check -- --template vanilla、cd morph-check、npm install 和 npm install three,建立 Vite 的 JavaScript 项目。将含有 Smile、Blink 形变键和骨骼的角色文件放在 public/models/character.glb,把以下内容保存为 src/main.js,然后执行 npm run dev,打开页面和浏览器控制台。

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

const scene = new THREE.Scene();
scene.background = new THREE.Color(0xf5f7fa);
scene.add(new THREE.HemisphereLight(0xffffff, 0x667788, 2));

const camera = new THREE.PerspectiveCamera(
  45, window.innerWidth / window.innerHeight, 0.01, 1000
);
const renderer = new THREE.WebGLRenderer({ antialias: true });
renderer.setSize(window.innerWidth, window.innerHeight);
document.body.style.margin = '0';
document.body.appendChild(renderer.domElement);

// GLB 中的网格可能嵌套在多个 Group 下,必须递归遍历。
const gltf = await new GLTFLoader().loadAsync('/models/character.glb');
scene.add(gltf.scene);
const morphMeshes = [];
gltf.scene.traverse((obj) => {
  if (obj.isMesh && Array.isArray(obj.morphTargetInfluences)
      && obj.morphTargetInfluences.length > 0) morphMeshes.push(obj);
});

// 未播放动画时,直接改变首个通道,便于观察形变是否有效。
if (morphMeshes.length) morphMeshes[0].morphTargetInfluences[0] = 0.5;
const rows = morphMeshes.flatMap((mesh) => {
  const names = Object.entries(mesh.morphTargetDictionary ?? {});
  return mesh.morphTargetInfluences.map((weight, index) => ({
    mesh: mesh.name || '(未命名)',
    target: names.find(([, i]) => i === index)?.[0] ?? `target_${index}`,
    index, weight,
    positionTargets: mesh.geometry.morphAttributes.position?.length ?? 0,
    skinned: !!mesh.isSkinnedMesh,
    bones: mesh.isSkinnedMesh ? mesh.skeleton.bones.length : 0
  }));
});
console.table(rows);
console.log('Morph 网格数:', morphMeshes.length);
console.log('骨骼与 Morph 共存数:', morphMeshes.filter(m => m.isSkinnedMesh).length);
const skinned = morphMeshes.find(m => m.isSkinnedMesh);
if (skinned) console.log('骨骼名称:', skinned.skeleton.bones.map(b => b.name));
console.table(gltf.animations.flatMap(clip =>
  clip.tracks.map(track => ({ clip: clip.name, track: track.name }))
));

const box = new THREE.Box3().setFromObject(gltf.scene);
const center = box.getCenter(new THREE.Vector3());
const distance = Math.max(1, box.getSize(new THREE.Vector3()).length() * 1.5);
camera.position.copy(center).add(new THREE.Vector3(0, 0, distance));
camera.lookAt(center);
renderer.setAnimationLoop(() => renderer.render(scene, camera));

预期输出(示例资产只有一个带形变的 SkinnedMesh):

text
Morph 网格数: 1
骨骼与 Morph 共存数: 1

此外,第一张控制台表格应出现 Smile、Blink 及各自索引,首个通道的 weight 是 0.5,positionTargets 是网格的顶点形变目标数量;第二张表格列出实际导出的动画轨道。网格数、形变名称和轨道数量以你的 GLB 为准。网页应显示模型;若请求 /models/character.glb 返回 404,应先核对 public 下的相对路径。

手动验证权重及可用范围

在示例代码中,把 morphMeshes[0].morphTargetInfluences[0] = 0.5 依次改为 0、0.5、1,每次保存并刷新页面,比较同一部位的轮廓。0 表示基础形状,1 表示该目标的完整顶点偏移,0.5 为线性中间状态。修改前确认索引 0 对应你要测试的名称;不能假定每个模型的 Smile 都是第一个通道。

Three.js 文档把常用权重写作 [0,1],但 glTF 允许超出这个区间,例如 1.5 会外推,可能造成穿模。产品 UI 通常把滑块限制在 0~1;检测资产时应先记录导入的原始权重,不要悄悄钳制。多个形变可以同时生效,但相互叠加可能使嘴角或眼睑过度偏移。关于默认行为和权重定义,可核对 Three.js Mesh 文档 与 glTF 2.0 规范。

判断骨骼与形变是否共存

控制台第一张表的 skinned: true 表示该形变网格是 SkinnedMesh;bones 给出所关联骨骼的数量。只有 morphTargetInfluences 并不代表文件含骨骼,只有 skeleton 也不代表含形变。两者出现在同一个网格上,才能确定结构共存。

继续查看第二张动画轨道表:名称包含 morphTargetInfluences 的轨道驱动形变权重;类似 Jaw.quaternion、Head.position 的轨道驱动节点变换,是否属于骨骼应与控制台输出的骨骼名称对应检查。gltf.animations 为空,只能说明没有导入动画片段,不能据此断定没有静态形变目标。

导入后缺少通道怎么查

若控制台显示 Morph 网格数: 0,先在 Blender 4.x 选中实际网格,进入「对象数据属性(绿色三角形)→ Shape Keys」,确认除 Basis 外有 Smile、Blink,并且改变 Value 能产生可见形变。随后执行「文件 → 导出 → glTF 2.0」,在导出选项中检查 Data → Shape Keys 已启用;若还需要形变关键帧,确认动画导出设置中的 Shape Keys Animations 已启用。不同 Blender 4.x 小版本的面板分组可能有差异,但选项名称相同。

若有数值但名称变为 target_0 一类通用标签,应检查原始 GLB 是否携带形变名称信息(常见约定为 mesh.extras.targetNames),不要靠固定下标绑定业务表情。若脸、牙齿各自存在形变目标,需用“网格名 + 目标名”共同定位,不能只使用第一张网格。若字典有键而设为 1 仍看不到变化,检查是不是改错了网格、目标顶点位移本身为零,或骨骼姿态及其他形变抵消了视觉效果。

验收通过的最低标准是:控制台能列出每个目标的名称与索引,0/0.5/1 能得到预期的三档形状;对需要骨骼的角色,同一网格还应报告 skinned: true 且 bones 大于零。

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

目录与阅读设置

阅读设置

17

记录一个想法

识别 Morph Targets 形变通道

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

登录哪都通