Web 图形与 3D / 系统课时

画布缩放后如何保持画面清晰

画布缩放后如何保持画面清晰

当 Three.js 场景嵌在产品卡片或数字展厅的可变尺寸容器中,只改变 CSS 宽高可能造成模糊、裁切或物体拉伸。本篇通过监听容器变化,同时更新渲染缓冲区与相机投影,并限制设备像素比,使画面在缩放时保持清晰且不过度消耗 GPU。

学习目标

  • 区分容器 CSS 尺寸、Canvas 绘制缓冲区尺寸与相机宽高比。
  • 让容器拖拽、窗口缩放和设备像素比变化都触发正确更新。
  • 用具体像素数量评估清晰度与渲染开销,并验证效果。

三种尺寸必须协同更新

页面上的 Canvas 有两套尺寸:CSS 宽高决定它占多大版面;内部绘制缓冲区的像素数决定渲染细节。假设容器为 800 × 450 CSS 像素、设备像素比(DPR)为 2,绘制缓冲区可以设为 1600 × 900 像素,但画布在页面上仍只占 800 × 450。

透视相机还要使用容器的宽高比:camera.aspect = 800 / 450。如果仅把 Canvas 拉宽而不增加绘制像素,边缘容易发虚;如果改了渲染器尺寸却漏掉 camera.updateProjectionMatrix(),物体可能横向拉伸。同步关系如下:

CSS 容器、绘制缓冲区与相机投影的尺寸同步关系

实现容器自适应渲染

下面示例适用于 Three.js r180、现代浏览器(支持 WebGL 2 与 ResizeObserver)。把代码保存为 index.html,示例从 CDN 加载 Three.js,需要联网。容器既能随视口变窄,也能通过右下角拖拽改变大小。

html
<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Three.js 响应式画布</title>
  <style>
    body { margin: 24px; font: 14px system-ui; }
    #stage {
      width: min(80vw, 800px);
      height: 420px;
      min-width: 250px;
      min-height: 180px;
      border: 1px solid #aab9c8;
      resize: both;
      overflow: hidden;
    }
    #stage canvas { display: block; width: 100%; height: 100%; }
  </style>
</head>
<body>
  <div id="stage"></div>
  <p id="info"></p>
  <script type="module">
    import * as THREE from 'https://cdn.jsdelivr.net/npm/three@0.180.0/build/three.module.js';

    const stage = document.querySelector('#stage');
    const info = document.querySelector('#info');
    const renderer = new THREE.WebGLRenderer({ antialias: true });
    stage.appendChild(renderer.domElement);

    const scene = new THREE.Scene();
    scene.background = new THREE.Color(0xf0f6ff);
    const camera = new THREE.PerspectiveCamera(60, 1, 0.1, 100);
    camera.position.z = 4;
    const cube = new THREE.Mesh(
      new THREE.BoxGeometry(1.5, 1.5, 1.5),
      new THREE.MeshNormalMaterial()
    );
    scene.add(cube);

    let oldWidth = 0, oldHeight = 0, oldDpr = 0;
    function updateSize() {
      const width = stage.clientWidth;
      const height = stage.clientHeight;
      if (!width || !height) return; // 隐藏容器时避免零高度宽高比

      const dpr = Math.min(window.devicePixelRatio || 1, 2);
      if (width === oldWidth && height === oldHeight && dpr === oldDpr) return;

      renderer.setPixelRatio(dpr);
      renderer.setSize(width, height, false); // 保留由 CSS 控制的画布尺寸
      camera.aspect = width / height;
      camera.updateProjectionMatrix();

      const buffer = renderer.getDrawingBufferSize(new THREE.Vector2());
      info.textContent = `CSS ${width}×${height} · DPR ${dpr} · 缓冲区 ${buffer.x}×${buffer.y}`;
      oldWidth = width;
      oldHeight = height;
      oldDpr = dpr;
    }

    new ResizeObserver(updateSize).observe(stage);
    window.addEventListener('resize', updateSize);
    updateSize();

    renderer.setAnimationLoop(() => {
      // 跨显示器拖动时,DPR 可能变化而容器尺寸不变
      if (Math.min(window.devicePixelRatio || 1, 2) !== oldDpr) updateSize();
      cube.rotation.y += 0.01;
      renderer.render(scene, camera);
    });
  </script>
</body>
</html>

预期结果:页面出现旋转的彩色立方体,下方持续显示当前 CSS 宽高、限幅后的 DPR 和实际绘制缓冲区尺寸;拖动容器右下角后,立方体比例保持正常,文字中的尺寸同步变化。

在 index.html 所在目录启动本地静态服务(需要 Python 3):

bash
python3 -m http.server 8000

预期结果:终端显示 HTTP 服务正在监听 8000 端口;访问 http://localhost:8000/ 可以看到上述场景。终端提示格式会因系统和 Python 版本而异。

这里监听的是 stage 而非整个窗口,因为展厅侧栏展开、网格列宽变化也会改变实际容器大小。setSize(width, height, false) 的第三个参数阻止渲染器改写 Canvas 的 CSS 宽高,避免与响应式布局互相干扰。仅当尺寸或 DPR 真正变化时才重建缓冲区。

选择适当的设备像素比

devicePixelRatio 不应无条件照搬:在相同 CSS 尺寸下,DPR 翻倍意味着像素数量变为四倍。以 800 × 450 CSS 像素为例:

渲染 DPR 缓冲区尺寸 像素数量
1 800 × 450 36 万
2 1600 × 900 144 万
3 2400 × 1350 324 万

示例使用 Math.min(window.devicePixelRatio || 1, 2),让 3 倍屏最多按 2 倍渲染。这是产品展示场景的起点而非统一最佳值:移动设备或复杂材质场景可以改成上限 1.5;文字标注、后处理和精细边缘则需要实际比较视觉质量。浏览器缩放也可能改变 DPR。

缩放后的验收与排查

  1. 拖拽示例容器右下角,把宽度从约 800 缩到 400 CSS 像素;观察信息行中的缓冲区宽度应随之缩小,立方体不应明显变扁。再改变窗口宽度,验证无需手动刷新。
  2. 在浏览器开发者工具中检查 #stage canvas:CSS 宽高应跟随容器,而 canvas.width 和 canvas.height 是绘制缓冲区的物理像素值。例如 CSS 400 × 300、DPR 2 时,内部值应约为 800 × 600。
  3. 如果场景模糊,检查绘制缓冲区是否仍停留在初始尺寸;如果物体变形,检查 camera.aspect 和 camera.updateProjectionMatrix();如果缩放后掉帧,先把 DPR 上限从 2 降到 1.5 做对照。

当容器被折叠成 0 宽或 0 高时,示例直接跳过调整,避免除以零;它重新显示后,ResizeObserver 会再次触发更新。如果使用正交相机,则应按新的宽高比更新 left/right/top/bottom 并调用 updateProjectionMatrix(),不能照搬透视相机的 aspect 属性。

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

目录与阅读设置

阅读设置

17

记录一个想法

画布缩放后如何保持画面清晰

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

登录哪都通