Web 图形与 3D / 系统课时

用 GPU 时间查询确认渲染瓶颈

用 GPU 时间查询确认渲染瓶颈

Three.js 场景掉帧时,JavaScript 调用 renderer.render() 的耗时不等于 GPU 真正执行绘制的耗时。本课用 WebGL2 定时查询测量 GPU 指令区间,通过异步读取和 disjoint 校验筛掉无效样本,判断掉帧是否值得从片元着色、阴影或后处理入手。

学习目标

  • 区分帧间隔、CPU 提交耗时和 GPU 渲染耗时。
  • 使用 EXT_disjoint_timer_query_webgl2 包围 Three.js 渲染并跨帧读取结果。
  • 在扩展不可用或发生 disjoint 时正确回退,避免错误结论。

先明确测量边界

60 FPS 对应的帧间隔约为 16.67 ms,但这不是单独分配给 GPU 的固定预算。requestAnimationFrame 相邻回调的时间差包括调度影响;performance.now() 包围 renderer.render() 测到的主要是主线程提交工作,GPU 命令通常仍在异步执行。

TIME_ELAPSED_EXT 查询返回两次标记之间的 GPU 耗时,单位为纳秒,换算为毫秒要除以 1e6。用它包围一次 renderer.render(scene, camera),得到的是这次调用提交的 GPU 工作区间;如果项目还用 EffectComposer,应包围实际的 composer.render(),否则后处理不在统计范围内。

查询为什么要跨帧读取

WebGL2 使用 gl.createQuery() 创建查询对象,并通过 gl.beginQuery(ext.TIME_ELAPSED_EXT, query) 与 gl.endQuery(ext.TIME_ELAPSED_EXT) 界定 GPU 指令区间。结束查询时结果通常尚未就绪,必须以后续动画帧轮询。

  1. 在帧 N 开始查询,执行场景渲染并结束查询。
  2. 从后续帧读取 gl.QUERY_RESULT_AVAILABLE;未就绪就继续正常渲染,不阻塞等待。
  3. 检查 ext.GPU_DISJOINT_EXT:为 true 时 GPU 计时可能不连续,该样本必须丢弃。
  4. 仅在结果就绪且未 disjoint 时读取 gl.QUERY_RESULT,最后调用 gl.deleteQuery()。

GPU 定时查询跨帧读取、校验与回收的时序

搭建 Three.js 测量示例

在支持 WebGL2 的桌面浏览器和 Node.js 环境中,新建 Vite 原生 JavaScript 项目。命令如下;已有 Vite + Three.js 项目可直接替换 src/main.js。

bash
npm create vite@latest gpu-timer-demo -- --template vanilla
cd gpu-timer-demo
npm install
npm install three
npm run dev

**预期结果:**终端出现 Vite 本地开发地址(如 http://localhost:<PORT>/),<PORT> 随环境变化。用浏览器打开该地址,将 src/main.js 完整替换为下列代码。

js
import * as THREE from 'three';

document.body.style.margin = '0';
const renderer = new THREE.WebGLRenderer({ antialias: true });
renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));
renderer.setSize(innerWidth, innerHeight);
document.body.appendChild(renderer.domElement);

const scene = new THREE.Scene();
scene.background = new THREE.Color(0x111827);
const camera = new THREE.PerspectiveCamera(60, innerWidth / innerHeight, 0.1, 100);
camera.position.z = 25;

const group = new THREE.Group();
scene.add(group);
const geometry = new THREE.BoxGeometry(0.7, 0.7, 0.7);
const material = new THREE.MeshNormalMaterial();
for (let y = -8; y <= 8; y++) {
  for (let x = -8; x <= 8; x++) {
    const mesh = new THREE.Mesh(geometry, material);
    mesh.position.set(x * 1.1, y * 1.1, 0);
    group.add(mesh);
  }
}

const gl = renderer.getContext();
const ext = gl.getExtension('EXT_disjoint_timer_query_webgl2');
const supported = !!ext &&
  gl.getQuery(ext.TIME_ELAPSED_EXT, ext.QUERY_COUNTER_BITS_EXT) > 0;
if (!supported) console.warn('GPU 计时不可用,场景仍可渲染');
if (supported) gl.getParameter(ext.GPU_DISJOINT_EXT); // 先读取并清除历史状态

let pending = null;
let frame = 0;

renderer.setAnimationLoop(() => {
  frame++;
  const disjoint = supported && gl.getParameter(ext.GPU_DISJOINT_EXT);

  // 只查询上一轮的状态,不调用 finish 或忙等
  if (pending) {
    const ready = gl.getQueryParameter(pending, gl.QUERY_RESULT_AVAILABLE);
    if (ready || disjoint) {
      if (ready && !disjoint) {
        const ns = gl.getQueryParameter(pending, gl.QUERY_RESULT);
        console.log(`GPU 渲染耗时: ${(ns / 1e6).toFixed(2)} ms`);
      } else if (disjoint) {
        console.warn('GPU disjoint,本次测量作废');
      }
      gl.deleteQuery(pending);
      pending = null;
    }
  }

  // 每 30 帧最多发起一次,避免未完成的查询叠加
  let query = null;
  if (supported && !disjoint && !pending && frame % 30 === 0) {
    query = gl.createQuery();
    if (query) gl.beginQuery(ext.TIME_ELAPSED_EXT, query);
  }

  group.rotation.y += 0.003;
  renderer.render(scene, camera);

  if (query) {
    gl.endQuery(ext.TIME_ELAPSED_EXT);
    pending = query;
  }
});

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

**预期结果:**页面出现旋转的方块阵列。按 F12 打开浏览器开发者工具的 Console;扩展可用时每隔约 30 帧出现一条类似记录:

text
GPU 渲染耗时: <TIME> ms

<TIME> 是设备相关的实际测量值,不应预设固定数字。扩展不可用时页面仍正常渲染,Console 提示“GPU 计时不可用,场景仍可渲染”。

读数如何指导优化

固定浏览器窗口、设备像素比、模型数量与相机运动,先预热几十帧,再收集约 30 个有效样本,比较中位数而非单帧最大值。下面是判读算例,不是上述示例的实测结果:

现象 GPU 耗时中位数 下一步
帧间隔约 25 ms,GPU 约 19 ms 19 ms 优先降低分辨率、阴影、透明叠加和后处理,再复测
帧间隔约 25 ms,GPU 约 3 ms 3 ms 转查 Performance 主线程长任务、JS 更新和资源上传
帧间隔约 16.7 ms,GPU 约 5 ms 5 ms 当前 GPU 余量较大,暂不为提升 FPS 盲目降画质

GPU 耗时高是定位线索,不能仅凭一次查询证明所有掉帧都由 GPU 引起。对比降低 renderer.setPixelRatio(1) 前后、关闭阴影或后处理前后的同场景有效样本;若 GPU 耗时明显下降且帧间隔同步改善,证据更强。

无效查询与采样陷阱

getExtension() 返回 null 或计时位数为 0 时不要硬调用扩展 API;这属于功能不可用,不等于 GPU 很快。若出现 GPU disjoint,丢弃该次结果并重新采样,不能把零值当作正常耗时。浏览器切换标签页、GPU 重置或 WebGL 上下文丢失后,也应暂停采样,并在上下文恢复后重新获取扩展及查询对象。

完成采样后停止动画循环并删除尚未回收的查询对象;集成到组件时应在卸载钩子中清理。更完整的接口语义可核对 Khronos WebGL2 定时查询规范。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 GPU 时间查询确认渲染瓶颈

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

登录哪都通