1. Web
  2. Web-APIs
  3. GPUBuffer
  4. mapAsync()

Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

GPUBuffer: mapAsync() 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 mapAsync() Methode des GPUBuffer Interfaces mappt den angegebenen Bereich des GPUBuffer. Sie gibt ein Promise zurück, das aufgelöst wird, wenn der Inhalt des GPUBuffer bereit ist, zugegriffen zu werden. Solange der GPUBuffer gemappt ist, kann er in keinen GPU-Befehlen verwendet werden.

Sobald der Puffer erfolgreich gemappt ist (was über GPUBuffer.mapState überprüft werden kann), geben Aufrufe von GPUBuffer.getMappedRange() einen ArrayBuffer zurück, der die aktuellen Werte des GPUBuffer enthält, um von JavaScript nach Bedarf gelesen und aktualisiert zu werden.

Wenn Sie die Arbeit mit den GPUBuffer-Werten beendet haben, rufen Sie GPUBuffer.unmap() auf, um ihn zu entmappen und damit der GPU wieder zugänglich zu machen.

Syntax

js
mapAsync(mode)
mapAsync(mode, offset, size)

Parameter

mode

Ein bitweises Flag, das angibt, ob der GPUBuffer zum Lesen oder Schreiben gemappt ist. Mögliche Werte sind:

GPUMapMode.READ

Der GPUBuffer ist zum Lesen gemappt. Werte können gelesen werden, aber alle Änderungen am ArrayBuffer von GPUBuffer.getMappedRange() werden verworfen, sobald GPUBuffer.unmap() aufgerufen wird.

Das Lesen im gemappten Modus kann nur bei GPUBuffers verwendet werden, die für GPUBufferUsage.MAP_READ eingerichtet sind (d.h. beim Erstellen mit GPUDevice.createBuffer()).

GPUMapMode.WRITE

Der GPUBuffer ist zum Schreiben gemappt. Werte können gelesen und aktualisiert werden — alle Änderungen am ArrayBuffer von GPUBuffer.getMappedRange() werden im GPUBuffer gespeichert, sobald GPUBuffer.unmap() aufgerufen wird.

Das Schreiben im gemappten Modus kann nur bei GPUBuffers verwendet werden, die für GPUBufferUsage.MAP_WRITE eingerichtet sind (d.h. beim Erstellen mit GPUDevice.createBuffer()).

offset Optional

Eine Zahl, die den Offset in Bytes vom Anfang des Puffers bis zum Beginn des zu mappenden Bereichs darstellt. Wenn offset nicht angegeben ist, wird standardmäßig 0 verwendet.

size Optional

Eine Zahl, die die Größe in Bytes des zu mappenden Bereichs darstellt. Wenn size nicht angegeben ist, erstreckt sich der gemappte Bereich bis zum Ende des GPUBuffer.

Rückgabewert

Ein Promise, das zu undefined aufgelöst wird, wenn der Inhalt des GPUBuffer bereit ist, zugegriffen zu werden.

Validierung

Die folgenden Kriterien müssen erfüllt sein, wenn mapAsync() aufgerufen wird, ansonsten wird eine OperationError DOMException ausgelöst, das Promise wird abgelehnt, und ein GPUValidationError wird generiert:

  • offset ist ein Vielfaches von 8.
  • Der Gesamtbereich, der gemappt werden soll (size, falls angegeben, oder GPUBuffer.size - offset, falls nicht), ist ein Vielfaches von 4.
  • Der Gesamtbereich, der gemappt werden soll, liegt im Bereich des GPUBuffer.
  • Wenn der Modus GPUMapMode.READ ist, hat der GPUBuffer eine Nutzung von GPUBufferUsage.MAP_READ.
  • Wenn der Modus GPUMapMode.WRITE ist, hat der GPUBuffer eine Nutzung von GPUBufferUsage.MAP_WRITE.

Beispiele

Sehen Sie auf der Hauptseite zu GPUBuffer nach einem Beispiel.

Spezifikationen

Spezifikation
WebGPU
# dom-gpubuffer-mapasync

Browser-Kompatibilität

Siehe auch

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