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 说明。

gl.viewport 控制绘图区域,片元着色器的 gl_FragCoord 使用绘图缓冲坐标,因此传入的 u_resolution 应取 实际 gl.drawingBufferWidth、gl.drawingBufferHeight,而不是 CSS 尺寸。驱动无法满足申请尺寸时,实际缓冲大小也可能与目标值不同。
运行完整同步示例
把下面内容保存为 index.html,在支持 WebGL2 的浏览器中打开。示例用全屏三角形绘制一个圆;每帧检查 CSS 尺寸与 DPR,但仅在目标缓冲区大小发生变化时重新分配 Canvas,避免反复触发昂贵的尺寸重建。
<!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 上限不是越小越好:缩小缓冲区会降低清晰度。最终应同时检查中心圆的边缘质量、浏览器缩放后的坐标准确性,以及目标设备上的帧时。