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。
<!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 切换):
模式:普通 Mesh | 剔除:关 | Draw calls:1000 | 三角形:12000
模式:InstancedMesh | 剔除:关 | Draw calls:1 | 三角形:12000这里的两行是切换后 HUD 中的关键统计字段,前面还会显示快捷键提示。页面中可见 40 列、25 行旋转的箱体;两种模式外观相同。示例只更新当前显示的一组对象,避免隐藏组的逐帧计算干扰比较。
绘制减少为何不等于剔除更快
按 C 开启视锥剔除,再按 V 将相机视线向右平移 22 个世界单位。普通 Mesh 可以逐个判断是否进入视锥,屏外箱体不再提交,因此 draw call 和三角形数可能下降;一次实例绘制则按整个批次的包围球判断是否可见,只要包围球与视锥相交,仍会提交整个批次。具体计数随窗口宽高比改变,不应预设固定值。

示例中实例位置固定、仅箱体绕自身中心旋转,初始计算的包围球仍有效。若后续调用 setMatrixAt() 改变了实例位置或缩放,原边界可能失效,应按需要调用 computeBoundingSphere();涉及显式包围盒查询时还可调用 computeBoundingBox()。不要无条件每帧重新扫描千个实例来计算包围体。
什么时候应按空间拆批
假设 1000 棵树分布在很长的道路两侧,摄像机每次只能看见约 200 棵:把所有树塞进一个批次虽然仍是 1 次提交,却可能处理大量屏外顶点。可按道路区段划分为 10 个、每批约 100 棵 的 InstancedMesh,把“全部可见时最多 10 次绘制”换成“完全不可见的区段整批跳过”。分块大小应通过实际场景里的 draw call、三角形数、主线程与 GPU 耗时共同判断。
另外要守住三个实现边界:实例共享几何体和材质,单个实例只需不同颜色时可用 setColorAt() 并设置 instanceColor.needsUpdate = true;setMatrixAt() 接收相对于批次对象的局部矩阵,不支持负缩放矩阵;静态实例仅初始化一次矩阵,不应像示例动画一样每帧上传。对频繁移动且分布很广的物体,优先按空间分批,而非把所有对象合并成一个超大批次。
API 细节可核对 InstancedMesh 官方文档 和 WebGLRenderer 计数说明。