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 通常只反映最后一个通道,容易将总开销低估。

自动重置与手动重置的多通道统计窗口对比

多通道项目可将统计规则固定为三个动作:

  1. 初始化时设置 renderer.info.autoReset = false。
  2. 每个业务帧开始调用 renderer.info.reset(),然后依次执行需要计入的渲染通道。
  3. 最后一次渲染结束后,先复制 render.calls、render.triangles 等数值,再进入下一帧;不要在读取前清零。

reset() 只清空 calls、triangles、points 和 lines 等绘制计数,不会清空 memory 和 programs。同一个 renderer.info 引用也不会自动保存历史值,应读取数字形成独立快照。

用一个立方体验证单通道与双通道

将下列内容保存为 index.html,用支持 WebGL 2 的浏览器打开,并在开发者工具的 Console 查看日志。示例固定使用 Three.js r186,需要能够访问代码中的 CDN;连续两次绘制同一场景用于模拟同一业务帧的两个通道,并非真实后处理效果。

html
<!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>

预期输出(控制台,两行日志;不计浏览器附加的来源信息):

text
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 连续趋势,而不是孤立的一次读数。

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

目录与阅读设置

阅读设置

17

记录一个想法

renderer.info 绘制计数

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

登录哪都通