GPUCommandEncoder: clearBuffer()-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, bevor Sie diese produktiv verwenden.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Hinweis: Dieses Feature ist verfügbar in Web Workers.
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 Teilregion darstellt. Wirdoffset
ausgelassen, wird standardmäßig 0 verwendet. size
Optional-
Eine Zahl, die die Größe in Bytes der zu löschenden Teilregion darstellt. Wird
size
ausgelassen, wird standardmäßig die Größe vonbuffer
-offset
verwendet.
Rückgabewert
Keiner (Undefined
).
Validierung
Die folgenden Kriterien müssen erfüllt sein, wenn clearBuffer()
aufgerufen wird, sonst wird ein GPUValidationError
generiert und der GPUCommandEncoder
wird ungültig:
- Die
GPUBuffer.usage
desbuffer
umfasst dasGPUBufferUsage.COPY_DST
-Flag. offset
undsize
sind beide Vielfache von 4.- Die
GPUBuffer.size
desbuffer
ist 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
Specification |
---|
WebGPU # dom-gpucommandencoder-clearbuffer |
Browser-Kompatibilität
BCD tables only load in the browser
Siehe auch
- Die WebGPU API