GPURenderPassEncoder: drawIndexedIndirect() 方法
注意：此功能在 Web Workers 中可用。
drawIndexedIndirect() 方法是 GPURenderPassEncoder 接口的一部分，它使用从 GPUBuffer 读取的参数来绘制索引图元。
语法
js
drawIndexedIndirect(indirectBuffer, indirectOffset)
参数
indirectBuffer-
一个包含执行绘制操作所需的
indexCount、instanceCount、firstIndex、baseVertex和firstInstance值的GPUBuffer。该缓冲区必须包含一个紧密打包的、由五个 32 位无符号整数值组成的块（总共 20 字节），这些值按照GPURenderPassEncoder.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);注意： 如果要使用非零的
firstInstance值，则需要启用indirect-first-instance功能。如果未启用indirect-first-instance功能且firstInstance不为零，则drawIndexedIndirect()调用将被视为无操作。 indirectOffset-
indirectBuffer中数据开始的偏移量（以字节为单位）。
返回值
无 (Undefined)。
验证
调用 drawIndirect() 时必须满足以下条件，否则将生成 GPUValidationError，并且 GPURenderPassEncoder 将变得无效。
indirectBuffer的GPUBuffer.usage包含GPUBufferUsage.INDIRECT标志。indirectOffset+indirectBuffer中值参数指定的总大小小于或等于indirectBuffer的GPUBuffer.size。indirectOffset是 4 的倍数。
示例
js
// …
// Create GPURenderPassEncoder
const passEncoder = commandEncoder.beginRenderPass(renderPassDescriptor);
// Set pipeline and vertex buffer
passEncoder.setPipeline(renderPipeline);
passEncoder.setVertexBuffer(0, vertexBuffer);
passEncoder.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
passEncoder.drawIndexedIndirect(drawValues, 0);
// End the render pass
passEncoder.end();
// End frame by passing array of GPUCommandBuffers to command queue for execution
device.queue.submit([commandEncoder.finish()]);
// …
规范
| 规范 |
|---|
| WebGPU # dom-gpurendercommandsmixin-drawindexedindirect |
浏览器兼容性
加载中…