GPURenderBundleEncoder:setVertexBuffer() 方法
注意:此功能在 Web Workers 中可用。
GPURenderBundleEncoder 介面的 setVertexBuffer() 方法用於設定或取消設定指定槽位中當前將為後續繪製命令提供頂點資料的 GPUBuffer。
注意: 此方法的功能與其在 GPURenderPassEncoder 上的等效方法 — setVertexBuffer() — 完全相同。
語法
js
setVertexBuffer(slot, buffer, offset, size)
引數
返回值
無 (Undefined)。
驗證
呼叫 setVertexBuffer() 時必須滿足以下條件,否則將生成 GPUValidationError,並且 GPURenderBundleEncoder 將變得無效
buffer的GPUBuffer.usage包含GPUBufferUsage.VERTEX標誌。slot小於GPUDevice的maxVertexBuffers限制。offset+size小於或等於buffer的GPUBuffer.size。offset是 4 的倍數。
示例
設定頂點緩衝區
js
function recordRenderPass(passEncoder) {
if (settings.dynamicOffsets) {
passEncoder.setPipeline(dynamicPipeline);
} else {
passEncoder.setPipeline(pipeline);
}
passEncoder.setVertexBuffer(0, vertexBuffer);
passEncoder.setBindGroup(0, timeBindGroup);
const dynamicOffsets = [0];
for (let i = 0; i < numTriangles; ++i) {
if (settings.dynamicOffsets) {
dynamicOffsets[0] = i * alignedUniformBytes;
passEncoder.setBindGroup(1, dynamicBindGroup, dynamicOffsets);
} else {
passEncoder.setBindGroup(1, bindGroups[i]);
}
passEncoder.draw(3, 1, 0, 0);
}
}
上面的程式碼片段摘自 WebGPU 示例 Animometer 示例。
取消設定頂點緩衝區
js
// Set vertex buffer in slot 0
passEncoder.setVertexBuffer(0, vertexBuffer);
// Later, unset vertex buffer in slot 0
passEncoder.setVertexBuffer(0, null);
規範
| 規範 |
|---|
| WebGPU # dom-gpurendercommandsmixin-setvertexbuffer |
瀏覽器相容性
載入中…