CommandBuffer

不直接构造，只能由编码器产出。

成员

方法

提交

const encoder = device.createCommandEncoder({ id: 'gbuffer' });

const pass = encoder.beginRenderPass({
  framebuffer: fbo,
  clearColor: [0, 0, 0, 1]
});
pass.setPipeline(pipeline);
pass.setVertexArray(vertexArray);
pass.draw({ vertexCount: 36 });
pass.end();

const commandBuffer = encoder.finish();

device.submit(commandBuffer);

一条命令缓冲只能提交一次。重复提交不会执行第二遍， 部分后端会直接报错。需要重复执行相同命令时重新录制， 或改用 RenderBundle（仅 WebGPU）。

记录用途

id 与 userData 不参与执行，只用于排查。 帧编号、渲染阶段名、耗时统计都可以挂在上面， 在浏览器性能面板里更容易对应到具体代码段：

const encoder = device.createCommandEncoder({
  id: 'frame-' + frameIndex,
  userData: { pass: 'terrain', frame: frameIndex }
});

/* ……录制…… */

const cb = encoder.finish();
device.submit(cb);
cb.destroy();

生命周期

不调用 destroy 时，命令缓冲随垃圾回收释放， 但显存回收时机不确定。每帧产出的场景里显式释放更稳。