Web 图形与 3D / 系统课时

InstancedMesh 合批重复物体

InstancedMesh 合批重复物体

数字展厅里摆放数百盏相同射灯、货架零件或装饰方块时,逐个创建 Mesh 往往产生大量绘制调用。本篇使用 400 个方块做对照:先保留普通 Mesh,再用 InstancedMesh 共享几何体和材质、分别设置变换矩阵,最后直接读取每帧 draw calls 验证效果。

学习目标

  • 判断何时适合把重复物体改为 InstancedMesh。
  • 使用 setMatrixAt() 给 400 个实例设置独立位置与旋转。
  • 用 renderer.info.render.calls 比较调用数量,识别实例化的边界。

为什么重复 Mesh 仍然昂贵

即使 400 个 Mesh 引用同一份 BoxGeometry 和 MeshNormalMaterial,它们通常仍各自提交一次绘制调用。实例化将共享的几何体、材质和 400 份局部变换矩阵交给一个 InstancedMesh,由 GPU 在一次实例化绘制中处理这些变换。

这里选用 20 × 20 的方块阵列,间距 1.1 个世界单位、边长 0.7。两种模式的模型数量和材质一致,比较时只切换可见性。该对照不含阴影、后处理或其他可绘制对象,因而便于观察约 400 次与 1 次 draw call 的差别。

普通 Mesh 与 InstancedMesh 绘制调用对比

创建可切换的对照场景

示例适用于 Three.js 0.186.1,需要支持 WebGL 2 的浏览器。新建 index.html 并粘贴以下完整代码;在该文件所在目录运行 python3 -m http.server 8000(Windows 可用 py -m http.server 8000),再打开 http://localhost:8000。首次加载需要联网读取固定版本的 Three.js 模块。

html
<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="utf-8">
  <title>InstancedMesh 对照</title>
  <style>
    body { margin: 0; font-family: sans-serif; background: #f4f7fa; }
    header { padding: 12px; }
    button { padding: 8px 12px; margin-right: 8px; }
    canvas { display: block; }
  </style>
</head>
<body>
  <header>
    <button id="normal">普通 Mesh</button>
    <button id="instanced">InstancedMesh</button>
    <span id="stats"></span>
  </header>
  <script type="module">
    import * as THREE from 'https://cdn.jsdelivr.net/npm/three@0.186.1/build/three.module.js';

    const scene = new THREE.Scene();
    scene.background = new THREE.Color('#f4f7fa');
    const camera = new THREE.PerspectiveCamera(60, 960 / 540, 0.1, 100);
    camera.position.set(0, 26, 32);
    camera.lookAt(0, 0, 0);

    const renderer = new THREE.WebGLRenderer({ antialias: true });
    renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));
    renderer.setSize(960, 540);
    document.body.appendChild(renderer.domElement);

    const geometry = new THREE.BoxGeometry(0.7, 0.7, 0.7);
    const material = new THREE.MeshNormalMaterial();
    const normalGroup = new THREE.Group();
    const total = 20 * 20;
    const instanced = new THREE.InstancedMesh(geometry, material, total);
    const dummy = new THREE.Object3D();

    for (let i = 0; i < total; i++) {
      const x = (i % 20 - 9.5) * 1.1;
      const z = (Math.floor(i / 20) - 9.5) * 1.1;

      // 每份实例矩阵独立;几何体和材质始终共享。
      dummy.position.set(x, 0, z);
      dummy.rotation.set(0, i * 0.03, 0);
      dummy.updateMatrix();
      instanced.setMatrixAt(i, dummy.matrix);

      const mesh = new THREE.Mesh(geometry, material);
      mesh.position.copy(dummy.position);
      mesh.rotation.copy(dummy.rotation);
      normalGroup.add(mesh);
    }

    // 批量写入后上传矩阵,并更新用于视锥裁剪的边界。
    instanced.instanceMatrix.needsUpdate = true;
    instanced.computeBoundingSphere();
    scene.add(normalGroup, instanced);
    instanced.visible = false;

    let mode = '普通 Mesh';
    document.querySelector('#normal').addEventListener('click', () => {
      mode = '普通 Mesh';
      normalGroup.visible = true;
      instanced.visible = false;
    });
    document.querySelector('#instanced').addEventListener('click', () => {
      mode = 'InstancedMesh';
      normalGroup.visible = false;
      instanced.visible = true;
    });

    renderer.setAnimationLoop(() => {
      renderer.render(scene, camera);
      document.querySelector('#stats').textContent =
        `${mode}:draw calls = ${renderer.info.render.calls}`;
    });
  </script>
</body>
</html>

预期结果:画面始终显示相同的 400 个方块,切换按钮后统计文本分别接近以下值;本例场景全部处于视野内,正常情况下应恰好得到这两个数字。

text
普通 Mesh:draw calls = 400
InstancedMesh:draw calls = 1

读懂矩阵与性能数据

setMatrixAt(i, matrix) 将第 i 个实例的局部变换写入缓冲区;示例通过 Object3D.updateMatrix() 把位置与旋转组合为 Matrix4。循环完成后设置 instanceMatrix.needsUpdate = true,否则 GPU 可能继续使用旧矩阵。实例位置范围变化后调用 computeBoundingSphere(),避免沿用过时的整体裁剪边界。

验收时要看 draw calls,不要仅凭 FPS 下结论:400 个方块仍各自占用顶点处理与像素绘制工作,实例化并不会把几何面数压成原来的四百分之一。这里每个 BoxGeometry 有 12 个三角形,两种模式理论上均绘制约 4800 个三角形;下降的是调用次数,而非几何复杂度。

若接入阴影贴图、多个材质组或后处理,额外渲染通道也会增加调用。renderer.info.render.calls 默认按渲染调用重置;多通道统计应按完整帧统一复位与采样,不能直接套用本例的 400∶1 数字。

更新、拆组与释放资源

当第 0 个实例需要移动时,先通过 getMatrixAt(0, matrix) 取回矩阵,修改其平移,再执行 setMatrixAt(0, matrix);更新后设置 instanceMatrix.needsUpdate = true,并在空间范围改变时重算 computeBoundingSphere()。实例不是独立的 Mesh,拾取时应使用命中结果的 instanceId 定位具体对象。

实际展厅若把相距很远的所有陈列品放在一个实例组中,视锥裁剪通常以整个 InstancedMesh 为单位,不会自动逐个剔除。可按展区或楼层分成多个实例组,例如每区 100~300 个,同组坚持共享几何体和材质,再实测 draw calls 与 GPU 时间。

页面不再需要这批模型时,先从场景移除普通组和实例组,再执行 instanced.dispose(),并在确认没有其他对象引用后各调用一次 geometry.dispose()、material.dispose()。不要让仍在使用的共享资源提前释放,也不要每一帧创建新的 InstancedMesh。更多接口边界可查阅 Three.js InstancedMesh 官方文档。

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

目录与阅读设置

阅读设置

17

记录一个想法

InstancedMesh 合批重复物体

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

登录哪都通