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 的浏览器中运行。把下面内容保存为 index.html;画布为 640×360,无深度附件。顶点位置直接由 WGSL 的 vertex_index 选择,因此无需创建顶点缓冲区;三个顶点构成一个 triangle-list 三角形。
<!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 服务,避免直接用文件路径打开页面:
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 即恢复绘制。检查时按下面顺序缩小范围:
- 整页显示初始化错误:检查是否使用
localhost/HTTPS、navigator.gpu是否存在,以及requestAdapter()是否返回null。 - 控制台出现验证错误:检查
pass.end()是否先于encoder.finish(),目标纹理格式与管线格式是否一致,以及submit()是否收到命令缓冲数组。 - 仅有背景色:确认已在通道中调用
setPipeline(pipeline),并传入draw(3);draw的第一个参数是顶点数。 - 第二帧绘制异常:每帧重新获取当前画布纹理、创建编码器并录制通道;已调用
finish()的编码器不能再次追加命令。
至此,一帧最小绘制具备明确的顺序:获取当前颜色目标、录制绘制通道、结束通道、完成命令编码并提交队列。后续增加顶点缓冲或多次绘制时,仍沿用这条提交链路。