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 eine Region eines GPUBuffer mit Nullen füllt.

Syntax

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

Parameter

buffer: Ein GPUBuffer-Objekt, das den zu löschenden Puffer darstellt.
offset Optional: Eine Zahl, die den Offset in Bytes vom Anfang des buffer zur zu löschenden Subregion darstellt. Wenn nicht angegeben, beträgt der Standardwert für offset 0.
size Optional: Eine Zahl, die die Größe in Bytes der zu löschenden Subregion darstellt. Wenn nicht angegeben, entspricht size der Größe des buffer abzüglich offset.

Rückgabewert

Keiner (undefined).

Validierung

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

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

Beispiele

// …

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

// Later on

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

// …

Spezifikationen

Spezifikation
WebGPU # dom-gpucommandencoder-clearbuffer

Browser-Kompatibilität

Siehe auch

Die WebGPU API

Help improve MDN

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

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