Web 图形与 3D / 系统课时
统一像素比与视口测试条件
统一像素比与视口测试条件
同一个 Three.js 场景在两台电脑上出现不同帧率,可能只是渲染分辨率不同。本课通过固定视口和渲染像素比,记录浏览器设备像素比与实际绘制缓冲区尺寸,建立可复现的测试条件,避免把像素工作量差异误判为性能优化效果。
学习目标
- 区分 CSS 视口尺寸、设备像素比、渲染器像素比和绘制缓冲区尺寸。
- 使用 Three.js API 固定渲染条件,输出能够直接核对的测试记录。
- 在相同场景下对比不同渲染像素比的像素工作量,并识别常见测试偏差。
区分视口与实际渲染分辨率
浏览器中的 CSS 像素不一定对应一个物理像素。系统显示缩放、浏览器缩放和高分辨率屏幕都会影响设备像素比,进而影响实际需要绘制的像素数量。
测试时需要区分以下数值:
| 指标 | 获取方式 | 表示什么 |
|---|---|---|
| CSS 视口宽高 | window.innerWidth、window.innerHeight |
页面视口的逻辑尺寸,单位为 CSS px |
| 设备像素比 | window.devicePixelRatio |
浏览器当前报告的 CSS 像素与设备像素比例 |
| 渲染器像素比 | renderer.getPixelRatio() |
Three.js 当前采用的绘制分辨率倍率 |
| Canvas 显示尺寸 | canvas.getBoundingClientRect() |
画布在页面中实际显示的 CSS 尺寸 |
| 渲染器逻辑尺寸 | renderer.getSize(target) |
传入渲染器的逻辑宽高,不包含像素比 |
| 绘制缓冲区尺寸 | renderer.getDrawingBufferSize(target) |
实际分配的绘制宽高,以物理像素计 |
renderer.setPixelRatio(1) 表示每个逻辑像素按一个绘制像素处理。它不会修改 window.devicePixelRatio,也不会改变操作系统的显示缩放。
以 1280×720 的 CSS 视口为例:
| 渲染器像素比 | 绘制缓冲区 | 总绘制像素 |
|---|---|---|
| 1 | 1280×720 | 921,600 |
| 1.5 | 1920×1080 | 2,073,600 |
| 2 | 2560×1440 | 3,686,400 |
在逻辑视口不变时,像素比从 1 增至 2,绘制像素总数变为原来的 4 倍。这会增加像素着色、颜色与深度缓冲区等方面的工作量,但不意味着 GPU 耗时必然增加 4 倍,因为实际瓶颈也可能来自顶点处理、CPU 或其他资源。
固定条件并输出测试记录
使用 Vite 和 Three.js 建立一个最小场景。示例采用 WebGLRenderer,关闭抗锯齿,将渲染器像素比固定为 1,并在页面初始化和视口尺寸变化时记录实际配置。
先确认本机安装的 Node.js 满足当前 Vite 的版本要求,在终端执行:
npm create vite@latest pixel-baseline -- --template vanilla
cd pixel-baseline
npm install
npm install three
npm run dev预期结果:终端启动 Vite 开发服务器并显示本地访问地址,实际端口可能不同。
Local: http://localhost:<PORT>/打开该地址,将项目中的 src/main.js 完整替换为以下代码:
import * as THREE from 'three';
document.body.style.margin = '0';
document.body.style.overflow = 'hidden';
const renderer = new THREE.WebGLRenderer({ antialias: false });
// 固定渲染倍率,避免不同设备自动产生不同像素工作量。
renderer.setPixelRatio(1);
renderer.domElement.style.display = 'block';
renderer.domElement.style.width = '100vw';
renderer.domElement.style.height = '100vh';
document.body.replaceChildren(renderer.domElement);
const scene = new THREE.Scene();
scene.background = new THREE.Color(0x18212f);
const camera = new THREE.PerspectiveCamera(60, 1, 0.1, 100);
camera.position.z = 3;
const cube = new THREE.Mesh(
new THREE.BoxGeometry(1, 1, 1),
new THREE.MeshNormalMaterial()
);
scene.add(cube);
function syncViewport() {
const width = window.innerWidth;
const height = window.innerHeight;
// false 表示不覆盖已经设定的 Canvas CSS 宽高。
renderer.setSize(width, height, false);
camera.aspect = width / height;
camera.updateProjectionMatrix();
const rect = renderer.domElement.getBoundingClientRect();
const logical = renderer.getSize(new THREE.Vector2());
const buffer = renderer.getDrawingBufferSize(new THREE.Vector2());
// 以真实缓冲区尺寸为准,而不是直接用设备 DPR 推算。
console.log(
`viewport=${width}x${height} CSS px; ` +
`deviceDPR=${window.devicePixelRatio}; ` +
`rendererDPR=${renderer.getPixelRatio()}; ` +
`canvasCSS=${Math.round(rect.width)}x${Math.round(rect.height)}; ` +
`logical=${logical.x}x${logical.y}; ` +
`buffer=${buffer.x}x${buffer.y}; ` +
`pixels=${buffer.x * buffer.y}`
);
}
window.addEventListener('resize', syncViewport);
syncViewport();
renderer.setAnimationLoop((time) => {
cube.rotation.x = time * 0.0002;
cube.rotation.y = time * 0.00035;
renderer.render(scene, camera);
});预期结果:页面显示一个持续旋转的彩色立方体。假设浏览器 CSS 视口恰好为 1280×720、设备像素比为 2,控制台将输出以下内容。实际视口与设备像素比可能不同。
viewport=1280x720 CSS px; deviceDPR=2; rendererDPR=1; canvasCSS=1280x720; logical=1280x720; buffer=1280x720; pixels=921600注意,即使此时 deviceDPR=2,实际绘制缓冲区仍是 1280×720,因为代码明确调用了 renderer.setPixelRatio(1)。
setSize(width, height, false) 的第三个参数禁止方法修改 Canvas 的 CSS 样式;此例通过 100vw 和 100vh 控制显示尺寸。页面大小变化时,代码同时更新渲染器逻辑尺寸和相机宽高比,防止画面拉伸。
这里使用的 getSize()、getPixelRatio() 与 getDrawingBufferSize() 均为 Three.js WebGLRenderer 的正式接口,具体定义可查阅 WebGLRenderer 官方文档。
对照验证不同像素比
为了证明像素比设置确实生效,保持场景、浏览器和 CSS 视口不变,仅修改 setPixelRatio() 的参数。
- 在 Chrome DevTools 中打开设备工具栏,选择 Responsive,设置视口宽高为 1280×720,并用控制台日志核实实际
window.innerWidth和window.innerHeight。 - 保持
renderer.setPixelRatio(1),刷新页面,记录buffer和pixels。 - 将代码改为
renderer.setPixelRatio(2),刷新页面,再次记录相同字段。 - 比较两次结果。若两次 CSS 视口都为 1280×720,绘制像素数应从 921,600 增加到 3,686,400。
- 恢复像素比 1,并确认记录恢复为初始值。
这组实验只改变绘制分辨率,不改变几何体、材质、相机视角和 Canvas 的 CSS 显示尺寸。两次实验还应保持 antialias: false 不变,避免同时引入抗锯齿成本。
需要特别注意:开发者工具中的设备模拟用于统一逻辑视口,并不保证模拟设备与真实设备拥有相同的 GPU、显示刷新率或系统资源。不同机器间可以比较像素预算,但不能仅凭这一点认定两台机器具有完全相同的性能测试环境。
记录基线并排除环境偏差
建议每次测试保存一条包含实际测量值的记录,而不是只写分辨率为 1080p 或设备 DPR 为 2。
| 记录字段 | 示例值 |
|---|---|
| 浏览器 | Chrome,记录实际版本 |
| 页面缩放 | 100% |
| CSS 视口 | 1280×720 |
window.devicePixelRatio |
2 |
renderer.getPixelRatio() |
1 |
| Canvas CSS 尺寸 | 1280×720 |
| Drawing Buffer | 1280×720 |
| 绘制像素数 | 921,600 |
| 抗锯齿 | false |
| 场景版本 | 同一 Git 提交版本 |
这些值是记录格式示例,不代表执行代码后必然得到的结果。实际测试还需要记录硬件、GPU、操作系统和浏览器版本,并在同一性能模式下执行。
出现数据不一致时,优先检查以下问题:
- 视口尺寸变化:开发者工具开合、窗口调整可能改变
innerWidth和innerHeight。重新确认日志后再比较。 - 浏览器缩放变化:页面缩放可能改变 CSS 视口和
devicePixelRatio。统一为 100%,并重新加载页面记录。 - 跨屏幕移动:不同显示器的缩放比例可能不同。移动窗口后重新加载页面,确认设备 DPR 与绘制缓冲区。
- 重复设置像素比:检查项目是否在初始化后再次调用
setPixelRatio(),例如使用Math.min(window.devicePixelRatio, 2)进行动态限制。 - 只比较 Canvas 显示尺寸:CSS 尺寸相同不代表绘制缓冲区相同,应核对
getDrawingBufferSize()。 - 后处理分辨率独立变化:如果项目使用
EffectComposer或独立渲染目标,还应核对其像素比、尺寸和内部缓冲区,不能仅依赖主渲染器的记录。
基线测试的验收标准是:在相同视口和像素比设置下,重复刷新后得到一致的逻辑宽高、实际绘制缓冲区尺寸和像素总数。只有先确认这些条件一致,后续的帧耗时、Draw Call 和显存占用对比才具有明确的测试前提。