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 的差别。

创建可切换的对照场景
示例适用于 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 模块。
<!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 个方块,切换按钮后统计文本分别接近以下值;本例场景全部处于视野内,正常情况下应恰好得到这两个数字。
普通 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 官方文档。