Web 图形与 3D / 系统课时
错峰解码上传并预热材质
错峰解码上传并预热材质
模型已经下载,进入镜头的第一帧却仍然卡顿,往往是纹理首次上传和 Shader 编译集中发生。本课把图片解码、GPU 上传与材质编译拆开,安排在模型可见之前,并用冷启动与预热对照确认优化是否有效。
学习目标
- 区分图片解码、GPU 纹理上传和 Shader 编译的耗时位置。
- 使用
renderer.initTexture()和renderer.compileAsync()提前准备资源。 - 通过冷热对照判断首帧卡顿是否减少,以及还剩哪些未预热成本。
识别首次使用的三个关口
资源的网络请求结束,不等于 GPU 已经能直接绘制。以一张 2048×2048 的 RGBA8 贴图为例,未压缩的基础层约占 16 MiB;启用完整 mipmap 后理论纹理存储约为 21.3 MiB(不含对齐等额外开销)。因此,首次上传可能产生明显尖峰。
- 图片解码:
createImageBitmap()或ImageBitmapLoader将图像资源准备为位图;它不代表纹理已上传到显存。 - GPU 纹理初始化:
renderer.initTexture(texture)可在首次渲染前初始化并上传已就绪的纹理;这是同步调用,仍可能阻塞所在帧。 - 材质编译:
await renderer.compileAsync(scene, camera)提前准备对应 Shader 程序;支持KHR_parallel_shader_compile的环境更可能避免同步等待,但它不会替你上传贴图。

安排不可见阶段的工作
假设角色在距离相机 5 米时开始准备、2 米以内才显示:先完成图片解码,再把可预热的纹理上传分散到若干准备帧,最后等待材质编译结束。可从每帧最多处理 1 张大贴图开始测量,不能把 20 张贴图连续放进一个 requestAnimationFrame 回调。
调用前要保证 texture.image 已有有效图像、texture.needsUpdate = true,材质已挂好 map,场景的灯光、雾和环境贴图配置已确定。compileAsync() 使用这些配置生成对应程序;之后更改材质特性、灯光或环境,仍可能产生新 Shader 变体。
initTexture() 不是后台传输器:单张高分辨率纹理的上传依然会占用当前帧。真正的错峰来自提前触发和控制每帧处理量,而不是把同步调用包进 async 函数。
用同一页面比较冷启动和预热
下面的独立 HTML 示例适用于支持 WebGL2 的现代浏览器,使用 Three.js 0.186.1。保存为 index.html,在文件所在目录运行 python -m http.server 8000,随后分别打开 http://localhost:8000/?warm=0 和 http://localhost:8000/?warm=1。首次加载需联网获取 Three.js 模块。两组都先渲染空场景并完成图片解码,以隔离纹理上传与 Shader 编译的差异。
<!doctype html>
<html lang="zh-CN">
<meta charset="utf-8">
<title>Three.js 首帧预热对照</title>
<pre id="result">准备中...</pre>
<script type="module">
import * as THREE from 'https://cdn.jsdelivr.net/npm/three@0.186.1/build/three.module.js';
const warm = new URLSearchParams(location.search).get('warm') === '1';
const scene = new THREE.Scene();
scene.background = new THREE.Color(0xf3f6f7);
scene.add(new THREE.HemisphereLight(0xffffff, 0x445566, 2));
const camera = new THREE.PerspectiveCamera(45, 16 / 9, 0.1, 100);
camera.position.set(3, 2, 4);
camera.lookAt(0, 0, 0);
const renderer = new THREE.WebGLRenderer({ antialias: true });
renderer.setSize(800, 450);
document.body.appendChild(renderer.domElement);
renderer.render(scene, camera); // 两组都先初始化空场景,排除 WebGL 冷启动。
// 自制同一张 PNG,避免外部图片的下载波动。
const source = document.createElement('canvas');
source.width = source.height = 2048;
const ctx = source.getContext('2d');
ctx.fillStyle = '#147d8a';
ctx.fillRect(0, 0, 2048, 2048);
ctx.fillStyle = '#ffad74';
ctx.fillRect(0, 0, 1024, 1024);
const blob = await new Promise((resolve, reject) =>
source.toBlob(b => b ? resolve(b) : reject(new Error('PNG 编码失败')), 'image/png')
);
// 两组均先完成解码,只比较首次显示时的 GPU 资源准备。
const d0 = performance.now();
const bitmap = await createImageBitmap(blob);
const decodeMs = performance.now() - d0;
const texture = new THREE.Texture(bitmap);
texture.colorSpace = THREE.SRGBColorSpace;
texture.needsUpdate = true;
const material = new THREE.MeshStandardMaterial({ map: texture, roughness: 0.7 });
const mesh = new THREE.Mesh(new THREE.BoxGeometry(2, 2, 2), material);
scene.add(mesh);
let uploadMs = 0;
let compileMs = 0;
if (warm) {
// 错开准备工作与首次可见绘制;每次只上传一张贴图。
await new Promise(resolve => requestAnimationFrame(resolve));
let t = performance.now();
renderer.initTexture(texture);
uploadMs = performance.now() - t;
await new Promise(resolve => requestAnimationFrame(resolve));
t = performance.now();
await renderer.compileAsync(scene, camera);
compileMs = performance.now() - t;
}
// 此处测的是 render() JS 返回时间,不是 GPU 完成时间。
const t0 = performance.now();
renderer.render(scene, camera);
const firstRenderMs = performance.now() - t0;
const extension = renderer.extensions.has('KHR_parallel_shader_compile')
? '支持' : '不支持';
document.querySelector('#result').textContent =
`模式:${warm ? '预热' : '冷启动'}\n` +
`解码:${decodeMs.toFixed(1)} ms\n` +
`initTexture:${warm ? uploadMs.toFixed(1) + ' ms' : '跳过'}\n` +
`compileAsync:${warm ? compileMs.toFixed(1) + ' ms' : '跳过'}\n` +
`首次 render() JS 耗时:${firstRenderMs.toFixed(1)} ms\n` +
`KHR_parallel_shader_compile:${extension}`;
</script>
</html>预期结果:两种模式都会显示带双色贴图的立方体。预热模式的页面文字如下,时间以 <TIME> 代替实际测量值:
模式:预热
解码:<TIME> ms
initTexture:<TIME> ms
compileAsync:<TIME> ms
首次 render() JS 耗时:<TIME> ms
KHR_parallel_shader_compile:<支持或不支持>冷启动模式对应的 initTexture、compileAsync 字段均为“跳过”。<TIME> 是运行时测量值,可能随设备变化;两种模式的几何缓冲仍在首次绘制时准备,因此预热不会使该耗时归零。
验收首帧并识别残余尖峰
用相同浏览器、窗口尺寸与贴图规格,冷热模式各进行至少 10 次刷新页面后的首次展示;排除第一次 CDN 下载的噪声。记录 render() 的 JS 调用耗时,再用 Chrome DevTools → Performance 录制并查看首次可见附近的主线程长任务与帧时间。在 60 Hz 下,完整帧预算约为 16.7 ms,不能把 render() 返回所需时间误当成 GPU 完成绘制的时间。
如果预热后仍掉帧,依次检查:首次几何缓冲上传、纹理重新设置 needsUpdate 导致再上传、材质变体变化、阴影贴图或渲染目标首次分配。Shader 预热必须在实际灯光和环境配置下执行;资源释放后重新创建、WebGL 上下文丢失或切换材质特性,都可能让预热收益失效。
生产环境还需在对象销毁时调用对应的 geometry.dispose()、material.dispose()、texture.dispose();本例使用的 ImageBitmap 在不再被引用且 GPU 已完成所需上传后,还应由应用调用 bitmap.close() 释放 CPU 侧资源。参考 WebGLRenderer API 中的 initTexture 与 compileAsync 说明。