渲染器配置与性能基础

配置 WebGLRenderer 的清晰度、颜色空间、阴影和像素比,并掌握三维场景的常用性能检查方法。

🎯 引言

学完这篇文章,你能正确配置 WebGLRenderer,处理高分屏清晰度和颜色空间,理解阴影、像素比、几何体数量对性能的影响,并建立一套排查卡顿的顺序。

🧱 一组实用的 renderer 配置

const renderer = new THREE.WebGLRenderer({
    antialias: true,
    alpha: true,
});

renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));
renderer.setSize(width, height, false);
renderer.outputColorSpace = THREE.SRGBColorSpace;
renderer.shadowMap.enabled = true;
  • antialias 让边缘更平滑,但会增加初始化和绘制成本。
  • alpha 允许 canvas 背景透明,方便和页面背景融合。
  • setPixelRatio 让 Retina 屏更清晰,但像素比过高会显著增加像素数量。
  • outputColorSpace 把 GPU 上运行的着色程序(shader)的计算结果转换成适合显示器的颜色输出方式。
  • shadowMap.enabled 只在确实需要阴影时打开。

画布尺寸通常由 CSS 决定,renderer 的绘制尺寸由 JS 决定。用 setSize(width, height, false) 可以改变绘制尺寸而不覆盖 CSS 布局。

下面的演示把像素比、sRGB 输出和阴影配置放在同一个最小场景中,你可以直接看到球体、地面和阴影的渲染结果:

SRGB + 阴影

📊 常见性能来源

三维性能通常受三类数量影响:

  • 绘制调用数量:大量独立 Mesh 会让 CPU 频繁提交绘制命令。
  • 顶点与纹理数量:高分段几何体和大尺寸纹理会增加 GPU 工作量。
  • 屏幕像素数量:画布越大、像素比越高,每帧需要处理的像素越多。

优先做这些简单检查:减少不必要的分段和纹理尺寸、合并静态对象、复用几何体和材质、只给关键物体开启阴影、把不需要显示的对象设为 visible = false。

不要为了“看起来更真实”无限增加光源、阴影贴图和后处理效果。性能要结合目标设备和实际场景验证。

🪤 资源释放和调试顺序

组件离开页面时至少清理这些内容:

cancelAnimationFrame(frameId);
controls?.dispose();

scene.traverse((object) => {
    if (!object.isMesh) return;
    object.geometry.dispose();
    const materials = Array.isArray(object.material)
        ? object.material
        : [object.material];
    materials.forEach((material) => material.dispose());
});

renderer.dispose();

纹理由材质引用时,也要在确认不再复用后调用 texture.dispose()。资源清理时不要把正在被其他场景共享的几何体、材质或纹理提前释放。

排查画面问题时按这个顺序:先确认 renderer 和 canvas 存在,再确认 scene 中有对象,然后检查相机位置与裁剪面,最后检查材质、灯光、纹理和颜色空间。

🧾 小节总结

  • renderer 的绘制尺寸和 canvas 的 CSS 尺寸是两回事。
  • 高分屏清晰度和渲染成本要通过像素比平衡。
  • 颜色输出和颜色贴图要使用匹配的颜色空间设置。
  • 阴影、灯光、顶点数、纹理尺寸和绘制调用都会影响性能。
  • 组件销毁时要停止循环、移除控制器监听并释放 GPU 资源。

❓ 知识问答

Q1:renderer.setPixelRatio(window.devicePixelRatio) 一定要照写吗?

它能提升高分屏清晰度,但设备像素比可能较高。使用 Math.min(..., 2) 是常见的折中起点,实际项目仍应按目标设备验证。

Q2:为什么 CSS 放大 canvas 后画面变模糊?

canvas 的绘制尺寸没有同步变大。要读取容器尺寸并调用 renderer.setSize,同时更新相机宽高比。

Q3:释放材质后为什么其他物体也变黑?

因为多个 Mesh 共用了同一个材质。资源需要按共享关系管理,确认没有其他使用者后再 dispose。

🧪 小练习

实现一个 resize 函数,同时更新容器、相机和 renderer;再把场景中所有小物体改为共享一个几何体和材质。

// 请在这里编写代码

🎉 现在你不仅能让场景显示出来,也能让它在真实页面里保持清晰、稳定和可维护。