Web 图形与 3D / 系统课时
renderer.info 绘制计数
renderer.info 绘制计数
同一场景的帧率下降,可能来自绘制次数增加,也可能来自资源持续累积。使用 WebGLRenderer.info 可以把每帧的 draw call、三角形提交量和已分配资源分开观察;关键是先确定统计覆盖一次渲染还是完整业务帧。
学习目标
- 读懂
render.calls、render.triangles、memory和programs的实际含义。 - 正确设置单通道与多通道渲染的统计和重置时机。
- 通过可运行示例验证计数,并识别资源统计中的常见误判。
按指标区分绘制开销与资源占用
以下接口适用于 Three.js r186 的 WebGLRenderer,不应直接套用到 WebGPURenderer 的统计结构。
| 字段 | 统计内容 | 判断时的边界 |
|---|---|---|
info.render.calls |
本次统计窗口内的 draw call 次数 | 不是 renderer.render() 的调用次数;一次调用可产生多个 draw call |
info.render.triangles |
已提交绘制的三角形数量 | 多次通道绘制、实例绘制会重复计入;不等于模型独有面数 |
info.memory.geometries / textures |
渲染器跟踪的几何体、纹理对象数量 | 不是显存字节数,也不等于 JavaScript 堆内存 |
info.programs.length |
当前缓存的 WebGL 着色器程序数 | 不等于材质数,也不表示每帧程序切换次数 |
例如,一个 12 三角形的立方体只提交一次绘制时,通常得到 calls=1、triangles=12;相同对象在两个渲染通道中各绘制一次,则会累计为 calls=2、triangles=24。增加绘制次数未必增加 geometries 或 programs。
把重置放在业务帧边界
默认 info.autoReset=true,每次执行 renderer.render() 时重置绘制计数。若一帧先绘制深度通道,再绘制主画面,最终读取的 calls 和 triangles 通常只反映最后一个通道,容易将总开销低估。

多通道项目可将统计规则固定为三个动作:
- 初始化时设置
renderer.info.autoReset = false。 - 每个业务帧开始调用
renderer.info.reset(),然后依次执行需要计入的渲染通道。 - 最后一次渲染结束后,先复制
render.calls、render.triangles等数值,再进入下一帧;不要在读取前清零。
reset() 只清空 calls、triangles、points 和 lines 等绘制计数,不会清空 memory 和 programs。同一个 renderer.info 引用也不会自动保存历史值,应读取数字形成独立快照。
用一个立方体验证单通道与双通道
将下列内容保存为 index.html,用支持 WebGL 2 的浏览器打开,并在开发者工具的 Console 查看日志。示例固定使用 Three.js r186,需要能够访问代码中的 CDN;连续两次绘制同一场景用于模拟同一业务帧的两个通道,并非真实后处理效果。
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<title>renderer.info 计数</title>
</head>
<body>
<script type="module">
import * as THREE from 'https://cdn.jsdelivr.net/npm/three@0.186.0/build/three.module.js';
const renderer = new THREE.WebGLRenderer({ antialias: false });
renderer.setSize(480, 300);
document.body.appendChild(renderer.domElement);
const scene = new THREE.Scene();
const camera = new THREE.PerspectiveCamera(60, 480 / 300, 0.1, 20);
camera.position.z = 3;
const mesh = new THREE.Mesh(
new THREE.BoxGeometry(1, 1, 1),
new THREE.MeshBasicMaterial({ color: 0x20a59b })
);
scene.add(mesh);
// 禁止每次 render 自动清零,改由业务帧控制统计窗口。
renderer.info.autoReset = false;
function sample(passes) {
renderer.info.reset();
for (let i = 0; i < passes; i++) {
renderer.render(scene, camera);
}
// 在下一次 reset 前,把实时计数复制成独立快照。
const info = renderer.info;
const snapshot = {
calls: info.render.calls,
triangles: info.render.triangles,
geometries: info.memory.geometries,
textures: info.memory.textures,
programs: info.programs.length
};
console.log(`${passes} 通道:${JSON.stringify(snapshot)}`);
}
sample(1);
sample(2);
</script>
</body>
</html>预期输出(控制台,两行日志;不计浏览器附加的来源信息):
1 通道:{"calls":1,"triangles":12,"geometries":1,"textures":0,"programs":1}
2 通道:{"calls":2,"triangles":24,"geometries":1,"textures":0,"programs":1}页面会显示一个绿色立方体。两个通道各提交一次立方体绘制,因而三角形和 draw call 数都翻倍,但没有新增几何体、纹理或着色器程序;若改为开启后处理、阴影或不同材质,计数可能增加,需以实际日志为准。
避免把计数当作耗时或泄漏证据
calls 偏高时,先核对一帧包含多少次 render()、阴影更新、透明对象和后处理通道,再考虑合并材质或使用 InstancedMesh。triangles 是提交量,不是片元着色量;即使三角形很少,大面积透明覆盖也可能让 GPU 忙碌。
排查资源增长时,记录加载前、加载后、移除对象并调用 geometry.dispose()、material.dispose() 或 texture.dispose() 后的 memory 和 programs.length。不要只从场景树移除对象就断言 GPU 资源已释放;渲染器也可能保留少量内部资源,判断应比较重复加载卸载后是否持续攀升。
对真实项目,最有解释力的记录是同一场景、同一渲染通道组合下的 calls、triangles、geometries、textures 和 programs.length 连续趋势,而不是孤立的一次读数。