GPURenderBundleEncoder: setVertexBuffer()-Methode

Syntax

setVertexBuffer(slot, buffer, offset, size)

Parameter

slot

Eine Zahl, die auf den Vertex-Puffer-Slot verweist, für den der Vertex-Puffer gesetzt werden soll.

buffer

Ein GPUBuffer, der den Puffer darstellt, der die Vertex-Daten für nachfolgende Zeichnungsbefehle enthält, oder null, in welchem Fall ein zuvor gesetzter Puffer im angegebenen Slot entfernt wird.

offset Optional

Eine Zahl, die den Offset in Bytes in buffer darstellt, wo die Vertex-Daten beginnen. Wenn ausgelassen, wird offset standardmäßig auf 0 gesetzt.

size Optional

Eine Zahl, die die Größe in Bytes der Vertex-Daten im buffer darstellt. Wenn ausgelassen, wird size standardmäßig auf die buffer's GPUBuffer.size - offset gesetzt.

Rückgabewert

Keiner (undefined).

Validierung

Die folgenden Kriterien müssen erfüllt sein, wenn setVertexBuffer() aufgerufen wird, andernfalls wird ein GPUValidationError generiert und der GPURenderBundleEncoder wird ungültig:

• buffer's GPUBuffer.usage enthält das GPUBufferUsage.VERTEX-Flag.
• slot ist kleiner als das GPUDevice maxVertexBuffers Limit.
• offset + size ist kleiner oder gleich buffer's GPUBuffer.size.
• offset ist ein Vielfaches von 4.

Beispiele

Vertex-Puffer setzen

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);
  }
}

Der obige Ausschnitt stammt aus dem WebGPU-Beispiel Animometer example.

Vertex-Puffer entfernen

// Set vertex buffer in slot 0
passEncoder.setVertexBuffer(0, vertexBuffer);

// Later, unset vertex buffer in slot 0
passEncoder.setVertexBuffer(0, null);

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Die WebGPU API