Web 图形与 3D / 系统课时

编码绘制通道并提交命令

编码绘制通道并提交命令

画布和渲染管线准备好后,调用 draw 仍不会立即把三角形画到屏幕。本篇完成一帧渲染的最后一段链路:建立命令编码器、指定颜色附件、记录绘制、结束通道、生成命令缓冲并提交到 GPU 队列。完成后可在浏览器里看到彩色三角形。

学习目标

  • 区分命令编码器、绘制通道、命令缓冲与提交队列的职责。
  • 使用 beginRenderPass()、draw(3)、end()、finish() 和 submit() 完成一次绘制。
  • 根据画布颜色与浏览器报错定位提交顺序及附件配置问题。

把绘制操作录进命令缓冲

GPUCommandEncoder 负责记录一批 GPU 操作。调用 beginRenderPass() 会创建 GPURenderPassEncoder,它描述本次绘制写入哪张纹理、加载时是否清屏,以及使用哪条管线。setPipeline() 与 draw(3) 都是录制命令,不代表 GPU 已执行。

绘制通道必须先以 pass.end() 结束,之后才能以 encoder.finish() 得到 GPUCommandBuffer。最后将命令缓冲组成数组传给 device.queue.submit();提交会安排 GPU 执行,但不会让 JavaScript 同步等待绘制完成。

WebGPU 一帧绘制的命令编码与提交数据流

从画布到提交的完整示例

示例在支持 WebGPU 的浏览器中运行。把下面内容保存为 index.html;画布为 640×360,无深度附件。顶点位置直接由 WGSL 的 vertex_index 选择,因此无需创建顶点缓冲区;三个顶点构成一个 triangle-list 三角形。

html
<!doctype html>
<html lang='zh-CN'>
<head>
  <meta charset='utf-8'>
  <title>WebGPU 提交三角形</title>
</head>
<body>
  <canvas id='screen' width='640' height='360'></canvas>
  <p id='status'>正在初始化</p>
  <script type='module'>
    async function main() {
      // WebGPU 需要受支持的浏览器及安全上下文
      if (!isSecureContext || !navigator.gpu) {
        throw new Error('请在 HTTPS 或 localhost 下使用支持 WebGPU 的浏览器');
      }
      const adapter = await navigator.gpu.requestAdapter();
      if (!adapter) throw new Error('找不到可用的 GPU 适配器');
      const device = await adapter.requestDevice();
      const canvas = document.querySelector('#screen');
      const context = canvas.getContext('webgpu');
      if (!context) throw new Error('无法创建 WebGPU 画布上下文');
      const format = navigator.gpu.getPreferredCanvasFormat();
      context.configure({ device, format, alphaMode: 'opaque' });

      const shader = device.createShaderModule({
        code: `
          struct VertexOut {
            @builtin(position) position: vec4f,
            @location(0) color: vec3f,
          };
          @vertex fn vsMain(@builtin(vertex_index) i: u32) -> VertexOut {
            let positions = array<vec2f, 3>(
              vec2f(0.0, 0.65),
              vec2f(-0.65, -0.65),
              vec2f(0.65, -0.65)
            );
            let colors = array<vec3f, 3>(
              vec3f(1.0, 0.3, 0.3),
              vec3f(0.2, 0.9, 0.5),
              vec3f(0.3, 0.6, 1.0)
            );
            var out: VertexOut;
            out.position = vec4f(positions[i], 0.0, 1.0);
            out.color = colors[i];
            return out;
          }
          @fragment fn fsMain(input: VertexOut) -> @location(0) vec4f {
            return vec4f(input.color, 1.0);
          }
        `
      });
      const pipeline = device.createRenderPipeline({
        layout: 'auto',
        vertex: { module: shader, entryPoint: 'vsMain' },
        fragment: { module: shader, entryPoint: 'fsMain',
                    targets: [{ format }] },
        primitive: { topology: 'triangle-list' }
      });

      // 当前画布纹理视图作为唯一颜色附件
      const encoder = device.createCommandEncoder();
      const pass = encoder.beginRenderPass({
        colorAttachments: [{
          view: context.getCurrentTexture().createView(),
          clearValue: { r: 0.07, g: 0.10, b: 0.16, a: 1 },
          loadOp: 'clear',
          storeOp: 'store'
        }]
      });
      pass.setPipeline(pipeline);
      pass.draw(3); // 3 是顶点数量,而不是三角形数量
      pass.end();
      const commands = encoder.finish();
      device.queue.submit([commands]);
      document.querySelector('#status').textContent = '命令已提交';
    }
    main().catch(error => {
      document.querySelector('#status').textContent = error.message;
      console.error(error);
    });
  </script>
</body>
</html>

预期结果:页面显示一块深蓝灰色的 640×360 画布,中间有顶端偏红、左下偏绿、右下偏蓝的渐变三角形;画布下方显示“命令已提交”。这表示 CPU 已调用提交接口,并非 GPU 完成时间的测量。

运行验证与参数含义

安装 Python 3 后,在 index.html 所在目录启动本地 HTTP 服务,避免直接用文件路径打开页面:

bash
python3 -m http.server 8000

预期结果:终端保持服务运行并监听 8000 端口;监听地址的输出因系统而异。在浏览器访问 http://localhost:8000,打开开发者工具控制台,确认没有 WebGPU 验证错误。

本例的颜色附件有三项容易混淆的设置:view 是 context.getCurrentTexture().createView() 生成的当前帧目标;loadOp: 'clear' 表示绘制前用 clearValue 清屏;storeOp: 'store' 表示保留本次通道写入的颜色结果。管线 fragment.targets[0].format 必须与画布配置使用的 format 相容。

根据画面定位失败位置

可以把 pass.draw(3) 临时改为 pass.draw(0) 并刷新:若仍出现深蓝灰背景但没有三角形,说明清屏通道已工作,需检查顶点数量、管线或着色器;改回 3 即恢复绘制。检查时按下面顺序缩小范围:

  1. 整页显示初始化错误:检查是否使用 localhost/HTTPS、navigator.gpu 是否存在,以及 requestAdapter() 是否返回 null。
  2. 控制台出现验证错误:检查 pass.end() 是否先于 encoder.finish(),目标纹理格式与管线格式是否一致,以及 submit() 是否收到命令缓冲数组。
  3. 仅有背景色:确认已在通道中调用 setPipeline(pipeline),并传入 draw(3);draw 的第一个参数是顶点数。
  4. 第二帧绘制异常:每帧重新获取当前画布纹理、创建编码器并录制通道;已调用 finish() 的编码器不能再次追加命令。

至此,一帧最小绘制具备明确的顺序:获取当前颜色目标、录制绘制通道、结束通道、完成命令编码并提交队列。后续增加顶点缓冲或多次绘制时,仍沿用这条提交链路。

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

目录与阅读设置

阅读设置

17

记录一个想法

编码绘制通道并提交命令

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

登录哪都通