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 为右下。条带第二个三角形会交替调整前两个顶点的顺序,以保持相邻三角形的绕序一致。不使用索引缓冲时,列表绘制 个独立三角形需要 个顶点输入,而一段连续条带绘制 个三角形只需 个顶点输入;这不意味着实际运行一定更快。

绕序决定哪一面被剔除
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 文件。
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);预期输出:
已提交 4 组绘制命令预期页面效果:前两个画布都是青绿色矩形;第三个因将正面约定改为 cw 且剔除背面,仅显示浅色背景;第四个采用 cullMode: 'none',矩形重新出现。这里的矩形由两片三角形组成,颜色相同,所以中间对角线不会显示。<PORT> 是本地服务实际端口,可能不同。
缺面时按顺序排查
- 先关闭剔除:临时使用
cullMode: 'none'。若网格立刻出现,优先检查绕序;如果仍不可见,应查顶点坐标、索引、裁剪、深度测试和渲染目标。 - 对照正面约定:保持
cullMode: 'back',分别创建frontFace: 'ccw'与'cw'两条管线。只有其中一条能显示时,通常是绕序与正面约定不一致。 - 检查网格顺序:
triangle-list每三个索引构成一面;triangle-strip第二面为(2,1,3),不能当成(1,2,3)。随机交换单个三角形的两个索引会反转该面的朝向。 - 检查镜像与实例变换:例如模型矩阵含 X 轴缩放
-1,可能把整片网格正反面颠倒。优先统一资产绕序或修正变换;不要一遇到缺面就永久关闭剔除。
对 drawIndexed() 还有一条特殊规则:索引条带管线必须在 primitive.stripIndexFormat 设置与 setIndexBuffer() 一致的 uint16 或 uint32。它们对应的重启索引分别是 0xFFFF 与 0xFFFFFFFF;非条带拓扑不得填写此字段。本例使用 draw() 而非索引绘制,因此不需要 stripIndexFormat。
对一般不规则三角网格,优先考虑 triangle-list 配合索引缓冲,便于局部修改与共享顶点;连续带状曲面可尝试 triangle-strip。将 frontFace: 'ccw' 与 cullMode: 'back' 作为普通封闭模型的起始配置,然后用剔除开关验证实际绕序。