Web 图形与 3D / 系统课时

InstancedMesh 合并绘制

InstancedMesh 合并绘制

场景里有 1000 个相同箱体时,即使它们共享几何体和材质,普通 Mesh 也通常要分别提交绘制。本篇用可切换的示例把它们合并为一个 InstancedMesh,逐帧更新实例矩阵,再用绘制计数和视锥剔除实验判断优化是否值得。

学习目标

  • 使用 InstancedMesh 和 setMatrixAt() 绘制、更新 1000 个实例。
  • 通过 renderer.info.render.calls 对比绘制调用数。
  • 解释实例批次的整体剔除限制,并决定何时按空间拆批。

为什么共享几何体仍会产生千次调用

每个普通 Mesh 都有独立的变换和一次绘制提交;共享 BoxGeometry 与 MeshNormalMaterial 只能避免重复创建资源,不能自动合并绘制。对于单材质、无额外渲染通道的 1000 个箱体,关闭视锥剔除后通常是 1000 次 draw call。

InstancedMesh(geometry, material, 1000) 将公共顶点和材质保留一份,用 instanceMatrix 提供每个箱体的局部变换;相同条件下整个批次只需 1 次 draw call。但 GPU 仍要处理 1000 个箱体的顶点,不能把“调用减少”理解成“三角形减少”。

每个实例矩阵有 16 个 32 位浮点数,占 64 字节;1000 个实例的矩阵缓冲区约 62.5 KiB。实例位置或旋转频繁变化时,还要计算并上传新矩阵。

用一个页面切换普通绘制和实例绘制

以下示例适用于 Three.js r180、支持 WebGL2 的现代浏览器。保存为 index.html,在文件所在目录使用 VS Code Live Server,或运行 python3 -m http.server 8000 后打开 http://localhost:8000/。首次加载需要访问 CDN。

html
<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width,initial-scale=1">
  <title>InstancedMesh 绘制对照</title>
  <style>
    body { margin: 0; overflow: hidden; }
    #hud { position: fixed; top: 10px; left: 10px; padding: 10px;
           color: white; background: #16202bcc; font: 14px sans-serif; }
  </style>
</head>
<body>
<div id="hud"></div>
<script type="module">
import * as THREE from 'https://cdn.jsdelivr.net/npm/three@0.180.0/build/three.module.js';

const scene = new THREE.Scene();
scene.background = new THREE.Color(0x182331);
const camera = new THREE.PerspectiveCamera(45, innerWidth / innerHeight, 0.1, 200);
camera.position.set(0, 24, 46);
camera.lookAt(0, 0, 0);
const renderer = new THREE.WebGLRenderer({ antialias: true });
renderer.setSize(innerWidth, innerHeight);
document.body.appendChild(renderer.domElement);

const count = 1000;
const columns = 40;
const geometry = new THREE.BoxGeometry(0.8, 0.8, 0.8);
const material = new THREE.MeshNormalMaterial();
const ordinary = new THREE.Group();
const batch = new THREE.InstancedMesh(geometry, material, count);
batch.instanceMatrix.setUsage(THREE.DynamicDrawUsage);
const positions = new Float32Array(count * 2);
const dummy = new THREE.Object3D();

for (let i = 0; i < count; i++) {
  const x = (i % columns - 19.5) * 1.2;
  const z = (Math.floor(i / columns) - 12) * 1.2;
  positions[i * 2] = x;
  positions[i * 2 + 1] = z;
  const mesh = new THREE.Mesh(geometry, material);
  mesh.position.set(x, 0, z);
  ordinary.add(mesh);
  dummy.position.set(x, 0, z);
  dummy.updateMatrix();
  batch.setMatrixAt(i, dummy.matrix);
}
batch.instanceMatrix.needsUpdate = true;
batch.computeBoundingSphere(); // 实例中心固定,旋转箱体不会增大球半径
scene.add(ordinary, batch);

let useInstances = true;
let culling = false;
let shifted = false;
function applyMode() {
  ordinary.visible = !useInstances;
  batch.visible = useInstances;
  batch.frustumCulled = culling;
  for (const mesh of ordinary.children) mesh.frustumCulled = culling;
}
applyMode();

window.addEventListener('keydown', (event) => {
  const key = event.key.toLowerCase();
  if (key === '1') useInstances = false;
  else if (key === '2') useInstances = true;
  else if (key === 'c') culling = !culling;
  else if (key === 'v') {
    shifted = !shifted;
    const targetX = shifted ? 22 : 0;
    camera.position.set(targetX, 24, 46);
    camera.lookAt(targetX, 0, 0);
  } else return;
  applyMode();
});

window.addEventListener('resize', () => {
  camera.aspect = innerWidth / innerHeight;
  camera.updateProjectionMatrix();
  renderer.setSize(innerWidth, innerHeight);
});

const hud = document.getElementById('hud');
function frame(time) {
  const angle = time * 0.0005;
  if (useInstances) {
    // 复用一个 Object3D 计算矩阵,不在循环里创建临时对象。
    for (let i = 0; i < count; i++) {
      dummy.position.set(positions[i * 2], 0, positions[i * 2 + 1]);
      dummy.rotation.y = angle;
      dummy.updateMatrix();
      batch.setMatrixAt(i, dummy.matrix);
    }
    batch.instanceMatrix.needsUpdate = true; // 一批写完后通知 GPU
  } else {
    for (const mesh of ordinary.children) mesh.rotation.y = angle;
  }
  renderer.render(scene, camera);
  hud.textContent = `1 普通 / 2 实例 / C 剔除 / V 偏移视角 | ` +
    `模式:${useInstances ? 'InstancedMesh' : '普通 Mesh'} | ` +
    `剔除:${culling ? '开' : '关'} | ` +
    `Draw calls:${renderer.info.render.calls} | ` +
    `三角形:${renderer.info.render.triangles}`;
  requestAnimationFrame(frame);
}
requestAnimationFrame(frame);
</script>
</body>
</html>

预期结果(页面左上角,默认关闭剔除;按 1 和 2 切换):

text
模式:普通 Mesh | 剔除:关 | Draw calls:1000 | 三角形:12000
模式:InstancedMesh | 剔除:关 | Draw calls:1 | 三角形:12000

这里的两行是切换后 HUD 中的关键统计字段,前面还会显示快捷键提示。页面中可见 40 列、25 行旋转的箱体;两种模式外观相同。示例只更新当前显示的一组对象,避免隐藏组的逐帧计算干扰比较。

绘制减少为何不等于剔除更快

按 C 开启视锥剔除,再按 V 将相机视线向右平移 22 个世界单位。普通 Mesh 可以逐个判断是否进入视锥,屏外箱体不再提交,因此 draw call 和三角形数可能下降;一次实例绘制则按整个批次的包围球判断是否可见,只要包围球与视锥相交,仍会提交整个批次。具体计数随窗口宽高比改变,不应预设固定值。

普通 Mesh 与 InstancedMesh 的绘制提交及视锥剔除粒度对比

示例中实例位置固定、仅箱体绕自身中心旋转,初始计算的包围球仍有效。若后续调用 setMatrixAt() 改变了实例位置或缩放,原边界可能失效,应按需要调用 computeBoundingSphere();涉及显式包围盒查询时还可调用 computeBoundingBox()。不要无条件每帧重新扫描千个实例来计算包围体。

什么时候应按空间拆批

假设 1000 棵树分布在很长的道路两侧,摄像机每次只能看见约 200 棵:把所有树塞进一个批次虽然仍是 1 次提交,却可能处理大量屏外顶点。可按道路区段划分为 10 个、每批约 100 棵 的 InstancedMesh,把“全部可见时最多 10 次绘制”换成“完全不可见的区段整批跳过”。分块大小应通过实际场景里的 draw call、三角形数、主线程与 GPU 耗时共同判断。

另外要守住三个实现边界:实例共享几何体和材质,单个实例只需不同颜色时可用 setColorAt() 并设置 instanceColor.needsUpdate = true;setMatrixAt() 接收相对于批次对象的局部矩阵,不支持负缩放矩阵;静态实例仅初始化一次矩阵,不应像示例动画一样每帧上传。对频繁移动且分布很广的物体,优先按空间分批,而非把所有对象合并成一个超大批次。

API 细节可核对 InstancedMesh 官方文档 和 WebGLRenderer 计数说明。

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

目录与阅读设置

阅读设置

17

记录一个想法

InstancedMesh 合并绘制

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

登录哪都通