GPURenderBundleEncoder: setVertexBuffer()-Methode

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die setVertexBuffer()-Methode der GPURenderBundleEncoder-Schnittstelle setzt oder entfernt den aktuellen GPUBuffer für den angegebenen Slot, der Vertex-Daten für nachfolgende Zeichenbefehle bereitstellt.

Hinweis: Diese Methode ist funktional identisch mit ihrem Äquivalent auf GPURenderPassEncoder — setVertexBuffer().

Syntax

setVertexBuffer(slot, buffer, offset, size)

Parameter

slot: Eine Zahl, die den Vertex-Buffer-Slot referenziert, für den der Vertex-Buffer gesetzt werden soll.
buffer: Ein GPUBuffer, der den Puffer mit den zu verwendenden Vertex-Daten für nachfolgende Zeichenbefehle darstellt, oder null, in welchem Fall ein zuvor gesetzter Puffer im angegebenen Slot entfernt wird.
offset Optional: Eine Zahl, die den Versatz in Bytes in buffer darstellt, wo die Vertex-Daten beginnen. Falls weggelassen, ist der Standardwert von offset 0.
size Optional: Eine Zahl, die die Größe in Bytes der in buffer enthaltenen Vertex-Daten darstellt. Falls weggelassen, ist der Standardwert von size die GPUBuffer.size des buffers - offset.

Rückgabewert

Keiner (Undefined).

Validierung

Die folgenden Kriterien müssen beim Aufruf von setVertexBuffer() erfüllt sein, andernfalls wird ein GPUValidationError erzeugt und der GPURenderBundleEncoder wird ungültig:

Die GPUBuffer.usage des buffers enthält das GPUBufferUsage.VERTEX-Flag.
slot ist kleiner als das Limit maxVertexBuffers des GPUDevice.
offset + size ist kleiner oder gleich der GPUBuffer.size des buffers.
offset ist ein Vielfaches von 4.

Beispiele

Vertex-Buffer 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 Samples Animometer-Beispiel.

Vertex-Buffer entfernen

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

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

Spezifikationen

Specification
WebGPU # dom-gpurendercommandsmixin-setvertexbuffer

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch

Die WebGPU API