GPUCommandEncoder: clearBuffer() Methode

Eingeschränkt verfügbar

Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.

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 clearBuffer()-Methode der GPUCommandEncoder-Schnittstelle kodiert einen Befehl, der einen Bereich eines GPUBuffer mit Nullen füllt.

In diesem Artikel

Syntax

js
clearBuffer(buffer)
clearBuffer(buffer, offset)
clearBuffer(buffer, offset, size)

Parameter

buffer

Ein GPUBuffer-Objekt, das den zu leerenden Puffer darstellt.

offset Optional

Eine Zahl, die den Versatz in Bytes vom Anfang des buffer bis zur zu leerenden Teilregion darstellt. Wenn weggelassen, ist der Standardwert für offset 0.

size Optional

Eine Zahl, die die Größe in Bytes der zu leerenden Teilregion darstellt. Wenn weggelassen, ist size standardmäßig die buffer-Größe minus offset.

Rückgabewert

Keiner (Undefined).

Validierung

Die folgenden Kriterien müssen erfüllt sein, wenn clearBuffer() aufgerufen wird, andernfalls wird ein GPUValidationError erzeugt und der GPUCommandEncoder wird ungültig:

Die GPUBuffer.usage des buffer beinhaltet das GPUBufferUsage.COPY_DST-Flag.
offset und size sind beide Vielfache von 4.
Die GPUBuffer.size des buffer ist größer oder gleich offset + size.

Beispiele

js
// …

const buffer = device.createBuffer({
  size: 1000,
  usage: GPUBufferUsage.MAP_READ | GPUBufferUsage.COPY_DST,
});

// Later on

const commandBuffer = device.createCommandEncoder();
commandEncoder.clearBuffer(buffer);

// …

Die WebGPU API

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden