Web 图形与 3D / 系统课时

用双缓冲反馈生成运动残影

用双缓冲反馈生成运动残影

本课将移动光点的当前画面与历史画面合成,做出可调节长度的运动残影。你会用两张离屏纹理交替保存反馈结果,避免在同一张纹理上同时读取和写入,并在浏览器里验证衰减、交换顺序和清屏操作。

学习目标

  • 区分当前场景纹理、历史读取纹理与历史写入目标。
  • 使用 Three.js 和 GLSL ES 3.00 实现双缓冲反馈。
  • 用按时间归一的衰减系数控制残影,并排查反馈回路错误。

分开当前画面与历史画面

本例创建三张 960×540 的颜色纹理:sceneRT 存本帧光点,A 与 B 是交替读写的历史缓冲。第 n 帧从 A.texture 读取历史,将合成结果写入 B,显示 B.texture;第 n+1 帧改为读 B、写 A。交换的是两个 JavaScript 引用,不必复制整张纹理。

场景颜色与两张历史纹理交替读写的数据流

renderer.setRenderTarget(write) 指定本帧写入目标;renderer.setRenderTarget(null) 才把结果画到屏幕。如果将正在写入的 write.texture 同时绑定为 uHistory,就形成 WebGL 纹理反馈回路,结果未定义,部分设备会报错、黑屏或闪烁。

计算可跨帧率使用的衰减

对每个像素、每个 RGB 通道分别取较大值:新画面保留当前亮点,旧画面逐渐变暗。与直接相加相比,这种合成不容易让轨迹交叠处累积成纯白。

Ht=max⁡(Ct, dtHt−1),dt=r60ΔtH_t=\max(C_t,\ d_t H_{t-1}),\qquad d_t=r^{60\Delta t}

其中 C_t 是当前帧颜色,H_t 是新的历史颜色,r 表示每 1/60 秒的保留率,Δt 以秒计。设置 r=0.96,经过约 1 秒历史亮度剩下 0.9660≈0.0860.96^{60}\approx0.086;改成 r=0.995,约剩 0.99560≈0.7400.995^{60}\approx0.740。用 r^(60*dt) 而不是每帧固定乘 r,可以让 30 FPS 与 60 FPS 下的衰减速度接近。

实现可运行的反馈页面

将下面的完整页面保存为 feedback.html。在文件目录执行 python3 -m http.server 8000(Windows 可用 py -m http.server 8000),访问 http://localhost:8000/feedback.html。需要支持 WebGL2 的浏览器和可访问 CDN 的网络;示例固定使用 Three.js 0.180.0。

html
<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>双缓冲反馈残影</title>
  <style>
    body { margin: 0; padding: 16px; background: #101722; color: #fff;
           font: 16px system-ui; display: grid; justify-items: center; gap: 12px; }
    canvas { width: min(96vw, 960px); height: auto; display: block; }
  </style>
</head>
<body>
  <label>每 1/60 秒保留率
    <input id="retain" type="range" min="0.80" max="0.995" step="0.005" value="0.96">
    <output id="value">0.960</output>
  </label>
  <canvas id="view"></canvas>
  <script type="module">
    import * as THREE from 'https://cdn.jsdelivr.net/npm/three@0.180.0/build/three.module.js';

    const W = 960, H = 540;
    const renderer = new THREE.WebGLRenderer({
      canvas: document.querySelector('#view'), antialias: false
    });
    renderer.setSize(W, H, false);
    renderer.outputColorSpace = THREE.SRGBColorSpace;

    const camera = new THREE.OrthographicCamera(-1, 1, 1, -1, 0.1, 10);
    camera.position.z = 1;

    // 当前帧:仅绘制一个运动光点
    const sourceScene = new THREE.Scene();
    sourceScene.background = new THREE.Color(0x000000);
    const dot = new THREE.Mesh(
      new THREE.CircleGeometry(0.09, 64),
      new THREE.MeshBasicMaterial({ color: 0x23ead2 })
    );
    dot.scale.x = H / W; // 修正宽屏画布上光点的视觉比例
    sourceScene.add(dot);

    function makeTarget() {
      return new THREE.WebGLRenderTarget(W, H, {
        type: THREE.UnsignedByteType,
        format: THREE.RGBAFormat,
        minFilter: THREE.LinearFilter,
        magFilter: THREE.LinearFilter,
        depthBuffer: false,
        stencilBuffer: false,
        generateMipmaps: false
      });
    }
    const sceneRT = makeTarget();
    const targets = [makeTarget(), makeTarget()];
    let [read, write] = targets;

    // 历史纹理首帧必须清黑;按 C 可重新清空
    renderer.setClearColor(0x000000, 1);
    function clearHistory() {
      for (const target of targets) {
        renderer.setRenderTarget(target);
        renderer.clear();
      }
      renderer.setRenderTarget(null);
    }
    clearHistory();
    addEventListener('keydown', (event) => {
      if (event.key.toLowerCase() === 'c') clearHistory();
    });

    const uniforms = {
      uCurrent: { value: sceneRT.texture },
      uHistory: { value: read.texture },
      uDecay: { value: 0.96 }
    };
    const feedbackMaterial = new THREE.ShaderMaterial({
      glslVersion: THREE.GLSL3,
      uniforms,
      depthTest: false,
      depthWrite: false,
      vertexShader: `
        out vec2 vUv;
        void main() {
          vUv = uv;
          gl_Position = vec4(position.xy, 0.0, 1.0);
        }
      `,
      fragmentShader: `
        precision highp float;
        uniform sampler2D uCurrent;
        uniform sampler2D uHistory;
        uniform float uDecay;
        in vec2 vUv;
        out vec4 outColor;
        void main() {
          vec3 currentColor = texture(uCurrent, vUv).rgb;
          vec3 oldColor = texture(uHistory, vUv).rgb;
          outColor = vec4(max(currentColor, oldColor * uDecay), 1.0);
        }
      `
    });

    const quad = new THREE.PlaneGeometry(2, 2);
    const feedbackScene = new THREE.Scene();
    feedbackScene.add(new THREE.Mesh(quad, feedbackMaterial));
    const displayMaterial = new THREE.MeshBasicMaterial({
      map: write.texture, depthTest: false, depthWrite: false
    });
    const displayScene = new THREE.Scene();
    displayScene.add(new THREE.Mesh(quad, displayMaterial));

    const slider = document.querySelector('#retain');
    const value = document.querySelector('#value');
    slider.addEventListener('input', () => {
      value.textContent = Number(slider.value).toFixed(3);
    });

    const clock = new THREE.Clock();
    let elapsed = 0;
    function animate() {
      const dt = Math.min(clock.getDelta(), 0.05);
      elapsed += dt;
      dot.position.set(0.75 * Math.cos(elapsed * 1.8),
                       0.5 * Math.sin(elapsed * 2.3), 0);

      renderer.setRenderTarget(sceneRT);
      renderer.render(sourceScene, camera);

      uniforms.uHistory.value = read.texture;
      uniforms.uDecay.value = Math.pow(Number(slider.value), 60 * dt);
      renderer.setRenderTarget(write);
      renderer.render(feedbackScene, camera);

      renderer.setRenderTarget(null);
      displayMaterial.map = write.texture;
      renderer.render(displayScene, camera);

      // 下一帧角色互换,严禁把正在写入的纹理当历史采样
      [read, write] = [write, read];
      requestAnimationFrame(animate);
    }
    animate();
  </script>
</body>
</html>

预期结果:页面出现沿曲线运动的青绿色光点,身后留有逐渐变暗的轨迹。滑块调到 0.80 时残影明显缩短,调到 0.995 时残影明显变长;按 C 会清掉已有轨迹。页面没有固定的控制台文本输出。

验证读写顺序与效果边界

可以在浏览器开发者工具的 Console 中查看着色器或 WebGL 报错。调试时确认每帧 read !== write,且 uHistory.value === read.texture;交换必须发生在屏幕显示之后。若只有移动光点没有残影,检查是否错误地每帧清空历史 A/B,或把 uHistory 指向了 sceneRT.texture。

如果画面黑屏,先检查浏览器 WebGL2 支持、CDN 模块是否加载成功,以及呈现前是否调用了 setRenderTarget(null)。当保留率接近 1 时旧轨迹会停留很久;示例把 dt 最大限制为 0.05 秒,避免切换标签页后出现骤变,若要求按真实经过时间衰减,应去掉该限制并按需要处理长时间暂停。

本例三张 RGBA8 纹理在 960×540 下共占约 5.93 MiB 的颜色存储(不计其他 GPU 开销)。若要适配窗口尺寸,应同时调整画布和三个 RenderTarget 的尺寸,并重新清空历史,否则旧轨迹会按新分辨率拉伸。

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

目录与阅读设置

阅读设置

17

记录一个想法

用双缓冲反馈生成运动残影

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

登录哪都通