GPUBuffer: mapState-Eigenschaft

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

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 mapState-Eigenschaft der GPUBuffer-Schnittstelle ist eine schreibgeschützte Eigenschaft, die den Zuordnungszustand des GPUBuffer darstellt.

Wert

Ein enumerierter Wert. Mögliche Werte sind:

unmapped

Der Puffer ist nicht zugeordnet. GPUBuffer.getMappedRange() kann nicht verwendet werden, um auf den Inhalt des GPUBuffer in JavaScript zuzugreifen. Dies könnte daran liegen:

GPUBuffer.mapAsync() wurde noch nicht aufgerufen.
Der GPUBuffer wurde zuvor zugeordnet und dann mit GPUBuffer.unmap() wieder freigegeben.

pending

Der Puffer ist noch nicht zugeordnet. GPUBuffer.mapAsync() wurde aufgerufen, aber sein Promise ist derzeit ausstehend. GPUBuffer.getMappedRange() kann momentan nicht verwendet werden, um auf den Inhalt des GPUBuffer in JavaScript zuzugreifen.

mapped

Der Puffer ist zugeordnet. Das GPUBuffer.mapAsync() Promise wurde erfüllt, und GPUBuffer.getMappedRange() kann jetzt verwendet werden, um auf den Inhalt des GPUBuffer in JavaScript zuzugreifen.

Beispiele

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

console.log(stagingBuffer.mapState); // "unmapped"

// …

await stagingBuffer.mapAsync(
  GPUMapMode.READ,
  0, // Offset
  BUFFER_SIZE, // Length
);

console.log(stagingBuffer.mapState); // "mapped"

Spezifikationen

Specification
WebGPU # dom-gpubuffer-mapstate

Browser-Kompatibilität

Siehe auch

Die WebGPU API