Web 图形与 3D / 系统课时

释放几何材质与纹理资源

释放几何材质与纹理资源

角色从场景中移除后,Three.js 不会自动释放所有 GPU 资源。本课将动画混合器、骨骼、几何体、材质和纹理分别纳入清理流程,并实现两个共享 GLB 资源的角色实例:删除一个角色不影响另一个,最后一个退出时才释放共享资源。

学习目标

  • 区分场景节点、动画绑定、骨骼与 GPU 资源的生命周期。
  • 正确组合 stopAllAction()、uncacheRoot() 和各类 dispose() 接口。
  • 使用共享资源所有权与 renderer.info 验证清理效果,避免误释放和持续增长的显存占用。

区分实例与共享资源

Three.js 的 scene.remove(root) 只解除父子关系,不会自动销毁节点引用的几何体、材质和纹理。JavaScript 垃圾回收也不能代替 WebGL 资源释放,因此必须明确每种对象由谁拥有、什么时候不再使用。

对象 清理接口 推荐释放时机
场景节点 Object3D parent.remove(root) 角色退出场景时
动画混合器 AnimationMixer stopAllAction()、uncacheRoot(root) 角色退出且不再播放动画时
骨骼 Skeleton skeleton.dispose() 没有其他活动网格使用该骨骼时
几何体 BufferGeometry geometry.dispose() 最后一个使用者退出时
材质 Material material.dispose() 最后一个使用者退出时
纹理 Texture texture.dispose() 最后一个使用者退出时

材质的 dispose() 不会自动释放其中的 map、normalMap、roughnessMap 等纹理。纹理必须单独清理,因为多个材质可能引用同一个纹理对象。

使用 SkeletonUtils.clone(gltf.scene) 复制蒙皮角色时,角色节点、骨骼层级及其绑定关系会被安全克隆,但几何体和材质仍按引用共享。因此每个角色可以独立播放动画,却不能在单个角色退出时直接销毁共享几何体或贴图。

例如,两个角色 A、B 使用同一个 GLB:二者各有自己的 AnimationMixer 和克隆骨骼,但共享一套几何体、材质与纹理。删除 A 后,共享资源仍属于 B;只有 B 也退出且资产缓存不再保留时,才满足释放条件。

设计正确的释放顺序

角色销毁应先停止行为,再解除引用,最后检查共享资源是否能够销毁。按以下顺序处理可以避免渲染循环继续更新已经退出的角色。

  1. 将角色从活动实例集合中删除,使下一帧不再调用其 mixer.update(delta)。
  2. 执行 mixer.stopAllAction(),停止该混合器上的所有动作。
  3. 执行 mixer.uncacheRoot(root),移除该角色根节点关联的动画动作与属性绑定缓存。
  4. 执行 scene.remove(root),解除角色与场景的父子关系。
  5. 对该实例独占的骨骼执行 skeleton.dispose();同一骨骼被多个网格引用时只处理一次。
  6. 将共享资产的活动引用数减一;如果归零且不再保留缓存,才释放源资产的几何体、材质和纹理。

两个角色实例共享 GLB 资源并分阶段释放的生命周期

这里的引用数可以直接采用同一 GLB 资产对应的活动实例集合大小。实际项目如果还保留预加载缓存或其他场景引用,必须将它们计入所有权,不能仅根据当前场景中的角色数量决定是否释放。

在 Vite 项目中完整实现

下面实现一个可运行的双角色示例。前提是使用 Vite 原生 JavaScript 项目,安装 three,并将带骨骼动画的 GLB 文件放在 public/models/character.glb。项目通过 npm install three 安装依赖,执行 npm run dev 启动开发服务器;终端会显示本地访问地址,实际端口可能不同。

将以下代码保存为 src/main.js。示例假定这个 GLB 的几何体、材质、纹理没有被其他资产或全局场景共享,且仅使用 gltf.scene 作为源场景。

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

const scene = new THREE.Scene();
scene.background = new THREE.Color('#f5f7f9');

const camera = new THREE.PerspectiveCamera(45, 800 / 450, 0.1, 100);
camera.position.set(0, 1.5, 5);
camera.lookAt(0, 1, 0);

const renderer = new THREE.WebGLRenderer({ antialias: true });
renderer.setSize(800, 450);
document.body.appendChild(renderer.domElement);
scene.add(new THREE.HemisphereLight(0xffffff, 0x444444, 2));

const instances = new Map();
let source = await new GLTFLoader().loadAsync('/models/character.glb');
let nextId = 0;

function disposeSharedAsset(root) {
  const geometries = new Set();
  const materials = new Set();
  const textures = new Set();
  const skeletons = new Set();

  // 同一资源可能被多个网格引用,Set 保证每个对象只释放一次。
  root.traverse((node) => {
    if (node.geometry) geometries.add(node.geometry);
    if (node.isSkinnedMesh) skeletons.add(node.skeleton);

    const list = Array.isArray(node.material)
      ? node.material
      : node.material ? [node.material] : [];
    list.forEach((material) => materials.add(material));
  });

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

  skeletons.forEach((item) => item.dispose());
  geometries.forEach((item) => item.dispose());
  materials.forEach((item) => item.dispose());

  // GLTFLoader 可能使用 ImageBitmap;GPU 纹理与 CPU 图像分别释放。
  const bitmaps = new Set();
  for (const texture of textures) {
    const image = texture.source?.data;
    if (typeof ImageBitmap !== 'undefined' && image instanceof ImageBitmap) {
      bitmaps.add(image);
    }
    texture.dispose();
  }
  bitmaps.forEach((image) => image.close());
}

function removeCharacter(id) {
  const instance = instances.get(id);
  if (!instance) return;

  // 先停止动画并解除缓存,避免下一帧继续更新已移除节点。
  instances.delete(id);
  instance.mixer.stopAllAction();
  instance.mixer.uncacheRoot(instance.root);
  scene.remove(instance.root);

  const skeletons = new Set();
  instance.root.traverse((node) => {
    if (node.isSkinnedMesh) skeletons.add(node.skeleton);
  });
  skeletons.forEach((skeleton) => skeleton.dispose());

  console.log('剩余实例:', instances.size);

  // 最后一个实例退出后,整个源资产才失去所有使用者。
  if (instances.size === 0 && source) {
    disposeSharedAsset(source.scene);
    source = null;
    console.log('共享资源已释放');
  }
}

function createCharacter(label, x) {
  const root = SkeletonUtils.clone(source.scene);
  root.position.x = x;
  scene.add(root);

  const mixer = new THREE.AnimationMixer(root);
  if (source.animations.length > 0) {
    mixer.clipAction(source.animations[0]).play();
  }

  const id = ++nextId;
  instances.set(id, { root, mixer });

  const button = document.createElement('button');
  button.textContent = `移除${label}`;
  button.addEventListener('click', () => {
    removeCharacter(id);
    button.remove();
  }, { once: true });
  document.body.appendChild(button);
}

createCharacter('左侧角色', -1);
createCharacter('右侧角色', 1);
console.log('创建实例:', instances.size);

const clock = new THREE.Clock();
function animate() {
  requestAnimationFrame(animate);
  const delta = clock.getDelta();
  for (const { mixer } of instances.values()) {
    mixer.update(delta);
  }
  renderer.render(scene, camera);
}
animate();

预期结果:页面显示两个角色,以及“移除左侧角色”和“移除右侧角色”按钮。角色需要使用约 2 米高、原点接近脚底的测试模型,以适配示例相机;其他尺寸的模型应调整相机和位置。

依次点击两个移除按钮,控制台输出:

text
创建实例: 2
剩余实例: 1
剩余实例: 0
共享资源已释放

第一次点击后,另一个角色仍正常显示和播放动画;第二次点击后,两个角色都从场景中消失,共享资源释放逻辑只执行一次。控制台输出的实例数量是固定的,具体 GPU 对象数量则取决于 GLB 内容。

这里采用两个层次的清理:removeCharacter() 仅处理实例独占的动画与骨骼;disposeSharedAsset() 在最后一个实例退出后遍历源模型,集中销毁共享资源。用 Set 去重可以避免同一材质、纹理或骨骼因为多个网格引用而重复处理。

代码通过扫描材质直接属性收集常规贴图,适用于大多数标准 glTF PBR 材质。如果项目使用自定义 ShaderMaterial.uniforms、额外渲染目标、独立克隆的实例材质或外部共享纹理,还应在各自所有权记录中登记并释放这些对象,不能假设一次场景树遍历覆盖全部资源。

验证显存与避免误释放

先完成一次加载和首次渲染,再打开浏览器开发者工具,在控制台查看 renderer.info.memory。它提供几何体与纹理等资源数量,可用于检测进入和退出场景前后的变化。

在实际工程中,可以在渲染循环或开发调试接口中执行以下片段。片段示例依赖前文已经创建的 renderer,不应作为独立脚本运行。

js
// 在首次渲染后,以及两次角色移除后的下一帧分别执行。
console.log({
  geometries: renderer.info.memory.geometries,
  textures: renderer.info.memory.textures,
  programs: renderer.info.programs?.length ?? 0
});

预期结果:控制台输出包含 geometries、textures、programs 三个数值的对象。它们不是固定常量,不能根据某个测试模型编造统一的预期数量。

按以下顺序验证清理行为:

  1. 首次加载并渲染两个角色后记录基线,观察几何体与纹理数量。
  2. 移除第一个角色后再次记录。共享的几何体和纹理通常仍被第二个角色使用,不应因为第一个角色退出而全部消失。
  3. 移除第二个角色后再渲染一帧,观察不再使用的共享资源数量是否下降。
  4. 在实际具有重新进入场景能力的应用中,重复加载、进入、退出至少 10 次,记录每轮完全退出后的资源数量是否持续增加。

还需要特别检查以下三个容易遗漏的边界:

  • 材质与纹理的所有权不同:material.clone() 通常仍然引用原有纹理。释放某个实例独占的克隆材质,不代表它有权释放共享贴图。
  • CPU 图像与 GPU 纹理不同:texture.dispose() 释放 GPU 相关资源,但不会自动关闭 ImageBitmap。只有确定没有其他纹理或缓存继续使用同一个位图时,才能调用 ImageBitmap.close()。
  • 角色退出与整个渲染器退出不同:本例只退出角色,仍保留动画循环和渲染器。如果整个三维视图永久关闭,还要取消帧循环、解绑业务事件,并调用 renderer.dispose() 清理渲染器自身资源。

如果业务需要反复生成角色,不必在每个实例退出时销毁缓存的 GLB。可以继续保留源资产并统计活动引用,等关卡切换、缓存淘汰或资源管理器确认无人使用后再集中释放。具体对象释放规则可参考 Three.js 官方资源清理指南。

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

目录与阅读设置

阅读设置

17

记录一个想法

释放几何材质与纹理资源

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

登录哪都通