Web 图形与 3D / 系统课时

按设备像素比同步画布分辨率

按设备像素比同步画布分辨率

窗口缩放或移到高分屏后,Canvas 的显示大小与实际绘制像素可能不一致,造成画面发虚、比例变形或特效坐标偏移。本篇用可直接运行的 WebGL2 示例同步 DPR、绘图缓冲、视口和分辨率 uniform,并用像素数量评估性能成本。

学习目标

  • 区分 CSS 显示尺寸、绘图缓冲尺寸和 Shader 的像素坐标。
  • 按有效 DPR 更新 Canvas、gl.viewport 与 u_resolution。
  • 验证浏览器缩放与跨屏变化,并为多 Pass 特效设置像素预算。

区分显示尺寸与绘图尺寸

Canvas 的 CSS width、height 决定它在网页中占多少 CSS 像素;canvas.width、canvas.height 指定绘图缓冲的目标像素尺寸。如果只改 CSS,浏览器可能把旧缓冲区放大,画面就会变模糊。

window.devicePixelRatio(DPR)给出设备像素与 CSS 像素的比例;渲染时可以设上限,例如 effectiveDpr = Math.min(devicePixelRatio, 1.5)。假设 CSS 尺寸为 800×600、DPR 为 2,限制后缓冲区应为 1200×900,而不是 1600×1200。页面缩放或更换显示器可能改变 DPR,见 MDN 的 DPR 说明。

CSS 尺寸和有效 DPR 同步至绘图缓冲、视口及 uniform 的数据流

gl.viewport 控制绘图区域,片元着色器的 gl_FragCoord 使用绘图缓冲坐标,因此传入的 u_resolution 应取 实际 gl.drawingBufferWidth、gl.drawingBufferHeight,而不是 CSS 尺寸。驱动无法满足申请尺寸时,实际缓冲大小也可能与目标值不同。

运行完整同步示例

把下面内容保存为 index.html,在支持 WebGL2 的浏览器中打开。示例用全屏三角形绘制一个圆;每帧检查 CSS 尺寸与 DPR,但仅在目标缓冲区大小发生变化时重新分配 Canvas,避免反复触发昂贵的尺寸重建。

html
<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <style>
    html, body { width: 100%; height: 100%; margin: 0; }
    canvas { display: block; width: 100%; height: 100%; }
  </style>
</head>
<body>
<canvas id="scene"></canvas>
<script type="module">
const canvas = document.querySelector("#scene");
const gl = canvas.getContext("webgl2");
if (!gl) throw new Error("当前环境不支持 WebGL2");

const vertexSource = `#version 300 es
void main() {
  vec2 p[3] = vec2[3](
    vec2(-1.0, -1.0), vec2(3.0, -1.0), vec2(-1.0, 3.0)
  );
  gl_Position = vec4(p[gl_VertexID], 0.0, 1.0);
}`;

const fragmentSource = `#version 300 es
precision highp float;
uniform vec2 u_resolution;
out vec4 outColor;
void main() {
  // 用实际缓冲区像素还原正圆,避免随长宽比拉伸
  vec2 p = (gl_FragCoord.xy - 0.5 * u_resolution)
           / min(u_resolution.x, u_resolution.y);
  float d = length(p);
  float aa = max(fwidth(d), 0.001);
  float fill = 1.0 - smoothstep(0.28 - aa, 0.28 + aa, d);
  vec3 color = mix(vec3(0.08, 0.15, 0.22),
                   vec3(0.10, 0.70, 0.66), fill);
  outColor = vec4(color, 1.0);
}`;

function compile(type, source) {
  const shader = gl.createShader(type);
  gl.shaderSource(shader, source);
  gl.compileShader(shader);
  if (!gl.getShaderParameter(shader, gl.COMPILE_STATUS)) {
    throw new Error(gl.getShaderInfoLog(shader));
  }
  return shader;
}

const program = gl.createProgram();
gl.attachShader(program, compile(gl.VERTEX_SHADER, vertexSource));
gl.attachShader(program, compile(gl.FRAGMENT_SHADER, fragmentSource));
gl.linkProgram(program);
if (!gl.getProgramParameter(program, gl.LINK_STATUS)) {
  throw new Error(gl.getProgramInfoLog(program));
}
gl.useProgram(program);
gl.bindVertexArray(gl.createVertexArray());
const resolutionLocation = gl.getUniformLocation(program, "u_resolution");

function frame() {
  const rect = canvas.getBoundingClientRect();
  const dpr = Math.min(window.devicePixelRatio || 1, 1.5);
  const width = Math.max(1, Math.round(rect.width * dpr));
  const height = Math.max(1, Math.round(rect.height * dpr));

  // 只在尺寸改变时重建绘图缓冲;viewport随之同步
  if (canvas.width !== width || canvas.height !== height) {
    canvas.width = width;
    canvas.height = height;
    gl.viewport(0, 0, gl.drawingBufferWidth, gl.drawingBufferHeight);
  }
  gl.uniform2f(resolutionLocation,
               gl.drawingBufferWidth, gl.drawingBufferHeight);
  gl.drawArrays(gl.TRIANGLES, 0, 3);
  requestAnimationFrame(frame);
}
requestAnimationFrame(frame);
</script>
</body>
</html>

预期结果:页面铺满深蓝灰背景,中央是带柔和边缘的青绿色正圆;改变窗口宽高时它仍保持圆形并始终居中。DPR 大于 1.5 时缓冲区倍率被限制在 1.5。运行时不要求出现任何控制台日志。

验证窗口与 DPR 变化

打开浏览器开发者工具的 Console,在窗口 CSS 尺寸约为 800×600 且设备 DPR 不低于 1.5 时,读取 document.querySelector("#scene").width 和 .height,应分别接近 1200 和 900(因实际 CSS 尺寸及取整略有差异)。缩放窗口、修改页面缩放倍率或在不同缩放比例的显示器间移动窗口,再次读取数值。

  • 画面发虚:只修改了 CSS 尺寸,绘图缓冲还停留在旧像素数;应更新 canvas.width/height。
  • 只在一角绘制:缓冲区变大后忘记执行 gl.viewport(0, 0, gl.drawingBufferWidth, gl.drawingBufferHeight)。
  • 圆形中心或程序化纹理偏移:u_resolution 还保存旧尺寸或误用了 CSS 像素,应按实际绘图缓冲同步。

如果项目用离屏 FBO 做 Bloom 或模糊,Canvas 改变时还需要按新目标分辨率重新分配颜色附件及已有的深度附件,并为每个 Pass 设置匹配其目标纹理的 viewport 和分辨率 uniform;不能把最终屏幕的尺寸无条件用于半分辨率模糊 Pass。

控制高 DPR 的像素预算

以下都以 CSS 尺寸 800×600 为基准,对照无上限时的缓冲区成本:

有效 DPR 缓冲区尺寸 像素数 相对 DPR 1
1.0 800×600 480,000 1 倍
1.5 1200×900 1,080,000 2.25 倍
2.0 1600×1200 1,920,000 4 倍

本例上限为 1.5,因此设备 DPR 即使为 2,也只分配 1,080,000 个像素。单张 1200×900 的 RGBA8 颜色纹理至少需要约 4.12 MiB 存储,不含深度、抗锯齿和其他缓冲。多 Pass 的像素读写也会增加;移动端可从上限 1.0~1.5 起步,用实际 GPU 帧时决定是否提高。

DPR 上限不是越小越好:缩小缓冲区会降低清晰度。最终应同时检查中心圆的边缘质量、浏览器缩放后的坐标准确性,以及目标设备上的帧时。

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

目录与阅读设置

阅读设置

17

记录一个想法

按设备像素比同步画布分辨率

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

登录哪都通