GPURenderBundleEncoder: drawIndexedIndirect() 方法
注意：此功能在 Web Workers 中可用。
drawIndexedIndirect() 方法屬於 GPURenderBundleEncoder 介面，它使用從 GPUBuffer 讀取的引數來繪製索引圖元。
注意： 此方法在功能上與其在 GPURenderPassEncoder 上的等效方法 — drawIndexedIndirect() — 完全相同。
語法
js
drawIndexedIndirect(indirectBuffer, indirectOffset)
引數
indirectBuffer-
一個
GPUBuffer，其中包含執行繪製操作所需的indexCount、instanceCount、firstIndex、baseVertex和firstInstance值。該緩衝區必須包含一個緊密打包的五個 32 位無符號整數值塊，表示這些值（總共 20 位元組），順序與GPURenderBundleEncoder.drawIndexed()的引數順序相同。例如：jsconst uint32 = new Uint32Array(5); uint32[0] = 3; // The indexCount value uint32[1] = 1; // The instanceCount value uint32[2] = 0; // The firstIndex value uint32[3] = 0; // The baseVertex value uint32[4] = 0; // The firstInstance value // Write values into a GPUBuffer device.queue.writeBuffer(buffer, 0, uint32, 0, uint32.length);注意： 必須啟用
indirect-first-instance功能才能使用非零的firstInstance值。如果未啟用indirect-first-instance功能且firstInstance不為零，則drawIndexedIndirect()呼叫將被視為無操作（no-op）。 indirectOffset-
indirectBuffer中資料開始的偏移量（以位元組為單位）。
返回值
無 (Undefined)。
驗證
呼叫 drawIndirect() 時必須滿足以下條件，否則將生成 GPUValidationError 並且 GPURenderBundleEncoder 將失效
indirectBuffer的GPUBuffer.usage包含GPUBufferUsage.INDIRECT標誌。indirectOffset+indirectBuffer中值引數指定的總大小小於或等於indirectBuffer的GPUBuffer.size。indirectOffset是 4 的倍數。
示例
js
// …
// Create GPURenderBundleEncoder
const bundleEncoder = device.createRenderBundleEncoder(descriptor);
// Set pipeline and vertex buffer
bundleEncoder.setPipeline(renderPipeline);
bundleEncoder.setVertexBuffer(0, vertexBuffer);
bundleEncoder.setIndexBuffer(indexBuffer, "uint16");
// Create drawIndexedIndirect values
const uint32 = new Uint32Array(5);
uint32[0] = 3;
uint32[1] = 1;
uint32[2] = 0;
uint32[3] = 0;
uint32[4] = 0;
// Create a GPUBuffer and write the draw values into it
const drawValues = device.createBuffer({
size: 20,
usage: GPUBufferUsage.COPY_DST | GPUBufferUsage.INDIRECT,
});
device.queue.writeBuffer(drawValues, 0, uint32, 0, uint32.length);
// Draw the vertices
bundleEncoder.drawIndexedIndirect(drawValues, 0);
// End the bundle recording
const renderBundle = bundleEncoder.finish();
// …
規範
| 規範 |
|---|
| WebGPU # dom-gpurendercommandsmixin-drawindexedindirect |
瀏覽器相容性
載入中…