GPURenderBundleEncoder: draw() 方法

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

安全上下文: 此功能僅在安全上下文(HTTPS)中可用,且支援此功能的瀏覽器數量有限。

注意:此功能在 Web Workers 中可用。

GPURenderBundleEncoder 介面的 draw() 方法會根據 setVertexBuffer() 提供的頂點緩衝區來繪製圖元。

注意: 此方法在功能上與其在 GPURenderPassEncoder 上的對應方法 — draw() — 完全相同。

語法

js
draw(vertexCount)
draw(vertexCount, instanceCount)
draw(vertexCount, instanceCount, firstVertex)
draw(vertexCount, instanceCount, firstVertex, firstInstance)

引數

vertexCount

一個定義要繪製的頂點數的數字。

instanceCount 可選

一個定義要繪製的例項數量的數字。如果省略,instanceCount 預設為 1。

firstVertex 可選

一個數字,定義從頂點緩衝區開始繪製的偏移量(以頂點為單位)。如果省略,firstVertex 預設為 0。

firstInstance 可選

一個定義要繪製的第一個例項的數字。如果省略,firstInstance 預設為 0。

返回值

無 (Undefined)。

示例

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 示例

規範

規範
WebGPU
# dom-gpurendercommandsmixin-draw

瀏覽器相容性

另見