Web 图形与 3D / 系统课时

利用 Spector.js 截帧检查调用

利用 Spector.js 截帧检查调用

当 Three.js 场景掉帧、Draw Call 突然增加或后处理异常时,单看 FPS 很难知道 GPU 收到了什么指令。本篇用 Spector.js 捕获一帧,追查绘制调用、Shader、帧缓冲与渲染状态,并通过前后对比验证修复是否有效。

学习目标

  • 在 WebGL 场景中启用 Spector.js,捕获可复现的问题帧。
  • 从 WebGL 命令和渲染目标区分阴影、主场景与后处理调用。
  • 检查 Shader 与深度、混合状态,依据同条件截帧验证优化。

安装扩展并截取问题帧

以下步骤适用于 Chrome 中使用 THREE.WebGLRenderer 的 WebGL 场景。先从 Chrome 扩展商店 安装 Spector.js;它捕获的是 WebGL/WebGL2 指令,不是 WebGPU 指令。

  1. 打开待测页面,固定浏览器窗口、相机位置和渲染分辨率;让资源加载完成后再测稳态帧。
  2. 点击工具栏的 Spector.js 图标启用捕获。首次启用可能自动刷新页面;启用后再次点击图标打开捕获菜单。
  3. 页面有多个 Canvas 时,选择 Three.js 所在的 WebGL Canvas;点击红色捕获按钮,并重现掉帧时的相机角度或交互。
  4. 等待结果面板出现,先记录 Canvas 尺寸、命令总数及 drawElements、drawArrays 等绘制命令的数量。

Spector.js 截帧菜单、命令列表和单条绘制调用详情的对应位置

按绘制调用识别重复工作

进入结果面板的 Commands 列表,先检索 drawElements、drawArrays、drawElementsInstanced 或 drawArraysInstanced。这些是绘制提交;其中一次 Instanced 绘制可以包含多个实例,不能把实例数当成调用数。

沿命令顺序回看 bindFramebuffer、clear 和绘制命令的分组。阴影贴图常绘制到离屏深度目标,主场景可能绘制到默认帧缓冲或中间目标,后处理通常再用全屏三角形等绘制到其他目标;不同项目的通道数量与顺序并不固定。

假设固定场景中数到如下绘制提交:

阶段(按渲染目标与内容人工归类) Draw Call
阴影贴图 260
主场景 260
后处理 8
合计 528

此时不要直接认定 528 次都无效。若一个灯光产生 260 次阴影绘制,关闭这盏灯的投影用于诊断后,假设同条件截帧降到 268 次,就能确认额外调用来自阴影通道;正式修复可考虑缩小投影物体集合、减少投影灯或复用静态阴影,而非一律禁用阴影。

检查 Shader、帧缓冲与状态

选中一条可疑绘制命令,查看它关联的 Program、Vertex/Fragment Shader、纹理绑定以及帧缓冲附件或 Visual State。关注的是该调用向哪里画、使用什么程序、启用了什么状态,不要只靠命令名称猜测用途。

  • Shader / Program:相似网格频繁切换程序时,核对是否因为材质定义、透明属性或编译宏不一致产生多套变体;先在 Three.js 中核实材质配置,不能单凭 useProgram 数量断言 Shader 编译卡顿。
  • Framebuffer / Attachment:反复切换到同尺寸的离屏目标并绘制完整画面,检查 EffectComposer 中是否串入重复 Pass,或是否同时手动调用 renderer.render() 与合成器渲染。
  • Depth / Blend / Cull:不透明物体意外启用混合,或深度写入被关闭,可能增加过度绘制;结合材质的 transparent、depthWrite、side 设置和画面实际需求判断。

用控制台稳定触发捕获

如果点击按钮时容易错过问题帧,可在启用 Spector.js 后,进入 Chrome 开发者工具 Console 执行以下完整脚本。它适用于页面中的普通 DOM Canvas;若有多个 Canvas,请改用明确的选择器,并确保 Console 选中了正确的页面上下文。

js
(() => {
  const canvas = document.querySelector('canvas');
  const inspector = window.spector;

  // 扩展须已注入页面,且目标是 WebGL Canvas
  if (!(canvas instanceof HTMLCanvasElement) ||
      typeof inspector?.captureNextFrame !== 'function') {
    console.error('未找到 Canvas 或 Spector.js 未启用');
    return;
  }

  // 从下一次 WebGL 帧提交开始捕获
  inspector.captureNextFrame(canvas);
  console.log('已请求捕获下一帧,请触发一次渲染');
})();

满足前置条件时的预期输出:

text
已请求捕获下一帧,请触发一次渲染

随后在页面中触发有问题的相机移动或动画;有新帧提交后,检查 Spector.js 的捕获结果。此脚本只发起请求,不保证下一帧恰好是掉帧帧;需要精确定位事件时,应在项目的开发调试逻辑中于目标交互前调用同一 API。

对照修复前后的调用

保持视角、Canvas 像素尺寸、设备像素比、阴影设置和后处理链不变,每次只修改一个因素,再分别捕获基线帧与修复帧。把相同渲染目标上的绘制数、Program 切换与最终画面一起核对,而不是只比较命令总数。

例如发现 EffectComposer 重复注册了同一个全屏 Pass:移除重复项后,应在命令序列中少一组相应的离屏绘制及相关帧缓冲切换,且画面效果保持符合预期。如果调用减少但 FPS 没改善,说明此次改动尚未证实解决主要瓶颈;回到主线程、GPU 像素开销或资源上传等方向继续定位。

捕获完成后关闭扩展的注入与捕获功能,再测实际帧率,避免调试拦截本身干扰基准测试。

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

目录与阅读设置

阅读设置

17

记录一个想法

利用 Spector.js 截帧检查调用

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

登录哪都通