Web 图形与 3D / 系统课时

设置图元拓扑与背面剔除

设置图元拓扑与背面剔除

同一组网格顶点,改动 primitive.topology 就可能改变三角形的连接方式;开启背面剔除后,绕序错误还会让模型突然消失。本课用两组三角形拼成的矩形,验证列表、条带、正反面判定和剔除设置,并学会定位缺面问题。

学习目标

  • 区分 triangle-list 与 triangle-strip 的组装规则及顶点数量。
  • 正确设置 frontFace、cullMode,解释绕序与可见面的关系。
  • 通过可运行的 WebGPU 示例验证两种拓扑,并排查背面剔除导致的缺面。

顶点怎样组成三角形

GPUPrimitiveState.topology 决定顶点如何组装。两个相邻三角形拼成一个矩形时,两种拓扑使用的顶点顺序不同:

拓扑 提交顺序 组装结果 本例顶点数
triangle-list A、B、C、C、B、D (A,B,C) 与 (C,B,D) 6
triangle-strip A、B、C、D (A,B,C) 与 (C,B,D) 4

这里 A 为左上、B 为左下、C 为右上、D 为右下。条带第二个三角形会交替调整前两个顶点的顺序,以保持相邻三角形的绕序一致。不使用索引缓冲时,列表绘制 TT 个独立三角形需要 3T3T 个顶点输入,而一段连续条带绘制 TT 个三角形只需 T+2T+2 个顶点输入;这不意味着实际运行一定更快。

三角形列表、条带及背面剔除的空间关系

绕序决定哪一面被剔除

frontFace 定义哪种顶点绕序算正面:ccw 为逆时针,cw 为顺时针,默认是 ccw。cullMode 定义丢弃哪一面:none 不剔除(默认),back 剔除背面,front 剔除正面。两者作用于三角形光栅化阶段,不改变顶点缓冲中的数据。

绕序按顶点着色器输出、经过投影与视口变换后的三角形判定,不应直接根据建模软件里顶点的原始坐标猜测。对当前示例的矩形,按 A→B→C 和 C→B→D 提交,在默认的 ccw 正面规则下两个三角形都能通过 back 剔除;若只把 frontFace 改为 cw,矩形就会被完全剔除。

运行四组管线对照

在支持 WebGPU 的 Chrome 或 Edge 中打开安全上下文页面(HTTPS 或 http://localhost:<PORT>),在开发者工具 Console 运行下面的完整 JavaScript。脚本自动创建四个画布;不需要预先准备 HTML、顶点缓冲或 WGSL 文件。

js
async function main() {
  if (!navigator.gpu) throw new Error('当前页面没有 WebGPU');
  const adapter = await navigator.gpu.requestAdapter();
  if (!adapter) throw new Error('未获取到 GPUAdapter');
  const device = await adapter.requestDevice();
  const format = navigator.gpu.getPreferredCanvasFormat();

  // A左上、B左下、C右上、D右下;两种拓扑生成同一矩形。
  const A = [-0.7, 0.7], B = [-0.7, -0.7];
  const C = [0.7, 0.7], D = [0.7, -0.7];
  const list = new Float32Array([...A, ...B, ...C, ...C, ...B, ...D]);
  const strip = new Float32Array([...A, ...B, ...C, ...D]);

  function upload(data) {
    const buffer = device.createBuffer({
      size: data.byteLength,
      usage: GPUBufferUsage.VERTEX | GPUBufferUsage.COPY_DST,
    });
    device.queue.writeBuffer(buffer, 0, data);
    return buffer;
  }
  const listBuffer = upload(list);
  const stripBuffer = upload(strip);
  const shader = device.createShaderModule({ code: `
    @vertex fn vs(@location(0) pos: vec2f) -> @builtin(position) vec4f {
      return vec4f(pos.x, pos.y, 0.0, 1.0);
    }
    @fragment fn fs() -> @location(0) vec4f {
      return vec4f(0.0, 0.72, 0.68, 1.0);
    }
  ` });

  const cases = [
    ['列表 ccw/back', 'triangle-list', 'ccw', 'back'],
    ['条带 ccw/back', 'triangle-strip', 'ccw', 'back'],
    ['列表 cw/back', 'triangle-list', 'cw', 'back'],
    ['列表 cw/none', 'triangle-list', 'cw', 'none'],
  ];
  const gallery = document.createElement('div');
  gallery.style.cssText = 'display:flex;flex-wrap:wrap;gap:12px';
  document.body.append(gallery);

  for (const [label, topology, frontFace, cullMode] of cases) {
    const panel = document.createElement('div');
    const caption = document.createElement('p');
    caption.textContent = label;
    const canvas = document.createElement('canvas');
    canvas.width = canvas.height = 180;
    panel.append(caption, canvas);
    gallery.append(panel);

    const context = canvas.getContext('webgpu');
    if (!context) throw new Error('无法创建 GPUCanvasContext');
    context.configure({ device, format, alphaMode: 'opaque' });
    const pipeline = device.createRenderPipeline({
      layout: 'auto',
      vertex: {
        module: shader, entryPoint: 'vs',
        buffers: [{
          arrayStride: 8,
          attributes: [{ shaderLocation: 0, offset: 0, format: 'float32x2' }],
        }],
      },
      fragment: { module: shader, entryPoint: 'fs', targets: [{ format }] },
      primitive: { topology, frontFace, cullMode },
    });

    const encoder = device.createCommandEncoder();
    const pass = encoder.beginRenderPass({
      colorAttachments: [{
        view: context.getCurrentTexture().createView(),
        clearValue: { r: 0.96, g: 0.97, b: 0.98, a: 1 },
        loadOp: 'clear', storeOp: 'store',
      }],
    });
    pass.setPipeline(pipeline);
    pass.setVertexBuffer(0, topology === 'triangle-strip' ? stripBuffer : listBuffer);
    pass.draw(topology === 'triangle-strip' ? 4 : 6);
    pass.end();
    device.queue.submit([encoder.finish()]);
  }
  console.log('已提交 4 组绘制命令');
}
main().catch(console.error);

预期输出:

text
已提交 4 组绘制命令

预期页面效果:前两个画布都是青绿色矩形;第三个因将正面约定改为 cw 且剔除背面,仅显示浅色背景;第四个采用 cullMode: 'none',矩形重新出现。这里的矩形由两片三角形组成,颜色相同,所以中间对角线不会显示。<PORT> 是本地服务实际端口,可能不同。

缺面时按顺序排查

  1. 先关闭剔除:临时使用 cullMode: 'none'。若网格立刻出现,优先检查绕序;如果仍不可见,应查顶点坐标、索引、裁剪、深度测试和渲染目标。
  2. 对照正面约定:保持 cullMode: 'back',分别创建 frontFace: 'ccw' 与 'cw' 两条管线。只有其中一条能显示时,通常是绕序与正面约定不一致。
  3. 检查网格顺序:triangle-list 每三个索引构成一面;triangle-strip 第二面为 (2,1,3),不能当成 (1,2,3)。随机交换单个三角形的两个索引会反转该面的朝向。
  4. 检查镜像与实例变换:例如模型矩阵含 X 轴缩放 -1,可能把整片网格正反面颠倒。优先统一资产绕序或修正变换;不要一遇到缺面就永久关闭剔除。

对 drawIndexed() 还有一条特殊规则:索引条带管线必须在 primitive.stripIndexFormat 设置与 setIndexBuffer() 一致的 uint16 或 uint32。它们对应的重启索引分别是 0xFFFF 与 0xFFFFFFFF;非条带拓扑不得填写此字段。本例使用 draw() 而非索引绘制,因此不需要 stripIndexFormat。

对一般不规则三角网格,优先考虑 triangle-list 配合索引缓冲,便于局部修改与共享顶点;连续带状曲面可尝试 triangle-strip。将 frontFace: 'ccw' 与 cullMode: 'back' 作为普通封闭模型的起始配置,然后用剔除开关验证实际绕序。

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

目录与阅读设置

阅读设置

17

记录一个想法

设置图元拓扑与背面剔除

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

登录哪都通