WGSLLanguageFeatures
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 WGSLLanguageFeatures-Schnittstelle der WebGPU API ist ein setähnliches Objekt, das die von der WebGPU-Implementierung unterstützten WGSL-Spracherweiterungen meldet.
Auf das WGSLLanguageFeatures-Objekt wird über die GPU.wgslLanguageFeatures Eigenschaft zugegriffen.
Hinweis: Nicht alle WGSL-Spracherweiterungen sind für WebGPU in allen Browsern verfügbar, die die API unterstützen. Wir empfehlen, alle Erweiterungen, die Sie verwenden möchten, gründlich zu testen.
Verfügbare Funktionen
Die folgenden WGSL-Spracherweiterungen sind in den WGSL-Spracherweiterungen in der WGSL-Spezifikation definiert. Beachten Sie, dass der genaue Satz an verfügbaren Funktionen je nach Implementierung und physischen Geräten variieren kann und sich im Laufe der Zeit ändern kann.
packed_4x8_integer_dot_product-
Erlaubt DP4a-GPU-Instruktionen (Dot Product of 4 Elements and Accumulate) über Ihren WGSL-Code zu verwenden. Diese führen effizient 8-Bit-Integer-Dot-Produkte aus, um die Berechnung zu beschleunigen, sparen Speicher- und Netzwerkbandbreite und verbessern die Leistung im Vergleich zu den entsprechenden
f32-Versionen. Sie werden häufig in maschinellen Lernmodellen in der Inferenz innerhalb von KI-Frameworks verwendet.Insbesondere wenn
packed_4x8_integer_dot_productverfügbar ist, kann WGSL-Code Folgendes verwenden:- 32-Bit-Integer-Skalare, die 4-Komponenten-Vektoren aus 8-Bit-Integern packen, um als Eingaben zu Dot-Produkt-Instruktionen verwendet zu werden (über die eingebauten Funktionen
dot4U8Packed()unddot4I8Packed()). - Pack- und Unpack-Instruktionen mit gepackten 4-Komponenten-Vektoren aus 8-Bit-Integern (über eingebaute Funktionen wie
pack4xI8()undpack4xI8Clamp()).
- 32-Bit-Integer-Skalare, die 4-Komponenten-Vektoren aus 8-Bit-Integern packen, um als Eingaben zu Dot-Produkt-Instruktionen verwendet zu werden (über die eingebauten Funktionen
readonly_and_readwrite_storage_textures-
Wenn verfügbar, können die Werte
"read-only"und"read-write"fürstorageTexture.accessgesetzt werden, wenn Speicher-Texture-Bind-Group-Entry-Typen in einem Bind-Group-Layout spezifiziert werden. Diese ermöglichen es, dass WGSL-Code Speicher-Texturen lesen und Speicher-Texturen lesen/schreiben kann. unrestricted_pointer_parameters-
Lockerung der Einschränkungen für Zeiger, die an WGSL-Funktionen übergeben werden. Wenn verfügbar, sind folgende Dinge erlaubt:
-
Parameterzeiger auf Speicher-, Uniform- und Arbeitsgruppen-Adressräume, die an benutzerdefinierte Funktionen übergeben werden.
-
Zeiger auf Strukturmitglieder und Array-Elemente, die an benutzerdefinierte Funktionen übergeben werden.
Siehe Zeiger als Funktionsparameter für weitere Details.
-
Instanzeigenschaften
Die folgende Eigenschaft steht allen schreibgeschützten setähnlichen Objekten zur Verfügung:
size-
Gibt die Anzahl der Werte im Set zurück.
Instanzmethoden
Die folgenden Methoden stehen allen schreibgeschützten setähnlichen Objekten zur Verfügung:
has()-
Gibt einen booleschen Wert zurück, der angibt, ob ein Element mit dem angegebenen Wert im Set vorhanden ist oder nicht.
values()-
Gibt ein neues Iterator-Objekt zurück, das Werte für jedes Element im Set in der Reihenfolge der Einfügung ausgibt.
keys()-
Ein Alias für
values(). entries()-
Gibt ein neues Iterator-Objekt zurück, das ein Array von
[value, value]für jedes Element im Set in der Reihenfolge der Einfügung enthält. forEach()-
Ruft die bereitgestellte Callback-Funktion einmal für jeden im Set vorhandenen Wert in der Reihenfolge der Einfügung auf.
Beispiele
Überprüfen, ob eine Erweiterung verfügbar ist
if (
navigator.gpu.wgslLanguageFeatures.has(
"readonly_and_readwrite_storage_textures",
)
) {
console.log("Read-only and read-write storage textures are available");
}
Setgröße zurückgeben und durch Werte iterieren
const wgslFeatures = navigator.gpu.wgslLanguageFeatures;
// Return the size of the set
console.log(wgslFeatures.size);
// Iterate through all the set values using values()
const valueIterator = wgslFeatures.values();
for (const value of valueIterator) {
console.log(value);
}
// …
Spezifikationen
| Specification |
|---|
| WebGPU # gpuwgsllanguagefeatures |