GPUBuffer: mapState-Eigenschaft
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 vor der Verwendung auf produktiven Webseiten.
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
schreibgeschützte Eigenschaft der GPUBuffer
-Schnittstelle stellt den gemappten Zustand des GPUBuffer
dar.
Wert
Ein enumerierter Wert. Mögliche Werte sind:
unmapped
-
Der Buffer ist nicht gemappt.
GPUBuffer.getMappedRange()
kann nicht verwendet werden, um auf den Inhalt desGPUBuffer
in JavaScript zuzugreifen. Dies könnte der Fall sein, weil:GPUBuffer.mapAsync()
noch nicht aufgerufen wurde.- Der
GPUBuffer
vorher gemappt und dann mitGPUBuffer.unmap()
wieder entmappt wurde.
pending
-
Der Buffer ist noch nicht gemappt.
GPUBuffer.mapAsync()
wurde aufgerufen, aber seinPromise
ist derzeit ausstehend.GPUBuffer.getMappedRange()
kann derzeit nicht verwendet werden, um auf den Inhalt desGPUBuffer
in JavaScript zuzugreifen. mapped
-
Der Buffer ist gemappt. Der
GPUBuffer.mapAsync()
Promise
wurde erfüllt, undGPUBuffer.getMappedRange()
kann nun verwendet werden, um auf den Inhalt desGPUBuffer
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
Report problems with this compatibility data on GitHubdesktop | mobile | server | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
mapState |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- Partial support
- Partial support
- In development. Supported in a pre-release version.
- In development. Supported in a pre-release version.
- No support
- No support
- Experimental. Expect behavior to change in the future.
- See implementation notes.
- User must explicitly enable this feature.
- Has more compatibility info.
Siehe auch
- Die WebGPU API