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 的版本要求,在终端执行:

bash
npm create vite@latest pixel-baseline -- --template vanilla
cd pixel-baseline
npm install
npm install three
npm run dev

预期结果:终端启动 Vite 开发服务器并显示本地访问地址,实际端口可能不同。

text
Local: http://localhost:<PORT>/

打开该地址,将项目中的 src/main.js 完整替换为以下代码:

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,控制台将输出以下内容。实际视口与设备像素比可能不同。

text
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() 的参数。

  1. 在 Chrome DevTools 中打开设备工具栏,选择 Responsive,设置视口宽高为 1280×720,并用控制台日志核实实际 window.innerWidth 和 window.innerHeight。
  2. 保持 renderer.setPixelRatio(1),刷新页面,记录 buffer 和 pixels。
  3. 将代码改为 renderer.setPixelRatio(2),刷新页面,再次记录相同字段。
  4. 比较两次结果。若两次 CSS 视口都为 1280×720,绘制像素数应从 921,600 增加到 3,686,400。
  5. 恢复像素比 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 和显存占用对比才具有明确的测试前提。

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

目录与阅读设置

阅读设置

17

记录一个想法

统一像素比与视口测试条件

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

登录哪都通