游戏引擎 / 系统课时

验证高 DPI 下的像素缩放

验证高 DPI 下的像素缩放

同一张像素风贴图在普通显示器上可能很锐利,换到 Retina 屏或浏览器缩放后却出现模糊、粗细不均。下面用 Phaser 4.2.1 制作可重复的棋盘格样例,区分设备像素比、画布尺寸与纹理过滤,并给出上线前的验收方法。

学习目标

  • 正确读取 DPR、画布缓冲区尺寸和 CSS 显示尺寸。
  • 使用最近邻采样与整数倍放大保持像素边界清楚。
  • 在不同屏幕和浏览器缩放比例下定位模糊原因。

分清三种像素尺寸

window.devicePixelRatio(DPR)表示一个 CSS 像素对应的设备像素比例,但它不是 Phaser 游戏世界的缩放倍数。验证时要分别记录游戏画布的内部尺寸 canvas.width、页面中实际显示的 CSS 尺寸,以及显示器最终使用的物理像素尺寸。

以逻辑画布 320×180 为例:如果 FIT 将它显示为 960×540 CSS 像素,CSS 缩放就是 3 倍;在 DPR=2 的设备上,这块区域约占 1920×1080 个物理像素。画布中的一个逻辑像素被映射到 3×3 个 CSS 像素、约 6×6 个物理像素。像素块边缘清楚不等于画布具有原生高 DPI 细节。

320×180 游戏画布到 CSS 像素和高 DPI 物理像素的三级映射

制作可复现的棋盘格测试页

将下面内容保存为 dpi-check.html,使用联网的 Chrome 或 Edge 打开。示例加载固定版本 Phaser 4.2.1,无需外部图片:它创建 16×16 的交错纹理、将精灵放大 4 倍,并用控制台打印实际画布数据。演示容器最大为 960×540 CSS 像素;请在至少 320×180 的浏览器可视区域测试。

html
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Phaser DPI 检查</title>
<style>
  html, body { margin: 0; height: 100%; background: #101824; }
  #game { width: min(100vw, 960px); height: min(100vh, 540px); margin: auto; }
  #game canvas { image-rendering: pixelated; }
</style>
<script src="https://cdn.jsdelivr.net/npm/phaser@4.2.1/dist/phaser.min.js"></script>
</head>
<body>
<div id="game"></div>
<script>
class CheckScene extends Phaser.Scene {
  constructor() { super('CheckScene'); }
  create() {
    const texture = this.textures.createCanvas('checker', 16, 16);
    const ctx = texture.getContext();
    for (let y = 0; y < 16; y++) {
      for (let x = 0; x < 16; x++) {
        ctx.fillStyle = (x + y) % 2 ? '#23b6a8' : '#ffb45a';
        ctx.fillRect(x, y, 1, 1);
      }
    }
    texture.refresh(); // 让 WebGL 获取新绘制的像素
    this.add.image(160, 90, 'checker').setScale(4);

    const inspect = () => {
      const canvas = this.game.canvas;
      const rect = canvas.getBoundingClientRect();
      console.log(
        `DPR=${window.devicePixelRatio}, buffer=${canvas.width}x${canvas.height}, ` +
        `CSS=${Math.round(rect.width)}x${Math.round(rect.height)}, ` +
        `scale=${(rect.width / canvas.width).toFixed(2)}`
      );
    };
    inspect();
    this.scale.on('resize', inspect); // 窗口变化时重新记录显示尺寸
  }
}
new Phaser.Game({
  type: Phaser.AUTO,
  backgroundColor: '#101824',
  render: { pixelArt: true },
  scale: {
    parent: 'game',
    width: 320,
    height: 180,
    mode: Phaser.Scale.FIT,
    autoCenter: Phaser.Scale.CENTER_BOTH,
    snap: { width: 320, height: 180 }
  },
  scene: CheckScene
});
</script>
</body>
</html>

预期结果:页面中央显示由青绿和橙色硬边方块组成的棋盘格。在容器达到 960×540 CSS 像素、设备 DPR 恰为 2 时,控制台应显示:

text
DPR=2, buffer=320x180, CSS=960x540, scale=3.00

其他窗口或设备上的数值会变化。render.pixelArt: true 使用适合像素风的最近邻采样及整数位置对齐;CSS 的 image-rendering: pixelated 则明确要求浏览器放大画布时保留硬边。snap 将 FIT 的显示尺寸约束到 320×180 的整数倍,留白属于正常现象。本例纹理还经过 setScale(4) 放大,因此每个纹素覆盖 4×4 个游戏逻辑像素。

按显示条件逐项验收

在浏览器按 F12 打开开发者工具的 Console,记录日志后依次检查:

  1. 标准密度:在 DPR 约为 1、可视区域不小于 960×540 CSS 像素时,确认缩放为 3.00,色块没有渐变色边缘。
  2. 高像素密度:在真正 DPR 为 2 或 3 的显示器上打开同一页面,确认 buffer 仍为 320×180,棋盘格清晰且位置不偏移。
  3. 窗口缩放:缩小窗口到约 700×450 CSS 像素,正常应出现 640×360 的 2 倍显示;再放大窗口,检查像素边宽度是否一致。
  4. 浏览器缩放:分别在 100% 与 125% 缩放下重新记录 DPR、CSS 尺寸和缩放倍数,留意屏幕物理像素映射可能不是整数;不要把模拟设备模式当成真实屏幕验证。

验收记录至少保留浏览器版本、操作系统显示缩放比例、DPR、画布内部尺寸、CSS 缩放倍数和一张原尺寸截图。棋盘格中相邻色块不应混色;整数 CSS 倍率下同向色块宽度应一致。若实际内容还含 Camera 滚动和 HUD,需在移动状态下额外检查边缘抖动与文字可读性。

定位模糊和像素粗细不均

出现颜色相互渗入时,先确认项目实际使用 render.pixelArt: true,没有同时开启 render.smoothPixelArt,并检查是否有其他样式覆盖了 Canvas 的 image-rendering。Phaser 4 的 smoothPixelArt 面向需要缩放、旋转和柔和边缘的 WebGL 场景,不等同于纯最近邻像素风。

出现像素列宽不均时,检查 Console 的 scale 是否为整数,以及系统显示缩放或浏览器缩放是否带来小数 DPR。FIT 默认可能产生非整数 CSS 倍率;可优先使用本例的 snap,但超窄屏幕不能依赖整数放大强行塞下 320×180 画布,应另设更小的逻辑尺寸或调整布局。

出现像素画清楚、HUD 文字却粗糙时,要区分风格取舍:低分辨率画布上的文字被放大后不会凭空获得高 DPI 字形细节。需要锐利小字的产品可用独立的 HTML UI 或高分辨率界面层。不要往 Phaser 4.2.1 配置中添加旧资料里的 resolution 或 scale.resolution 期待自动修复,它们不是此版本可用的高 DPI 缩放方案。

最终以“目标屏幕上的纹理无混色、整数倍情况下像素等宽、移动时无明显闪烁、HUD 可读”作为通过条件,不以 DPR 数字越大越好作为标准。

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

目录与阅读设置

阅读设置

17

记录一个想法

验证高 DPI 下的像素缩放

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

登录哪都通