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. offsetOptional-
Eine Zahl, die den Offset in Bytes vom Anfang des
bufferzur zu löschenden Subregion darstellt. Wenn nicht angegeben, beträgt der Standardwert füroffset0. sizeOptional-
Eine Zahl, die die Größe in Bytes der zu löschenden Subregion darstellt. Wenn nicht angegeben, entspricht
sizeder Größe desbufferabzüglichoffset.
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.usagedesbufferenthält dasGPUBufferUsage.COPY_DST-Flag. offsetundsizesind Vielfache von 4.- Die
GPUBuffer.sizedesbufferist größer oder gleichoffset+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