DiecreateQuerySet()-Methode derGPUDevice-Schnittstelle erstellt einGPUQuerySet, das verwendet werden kann, um die Ergebnisse von Abfragen auf Passes, wie Okklusions- oder Zeitstempelabfragen, aufzuzeichnen.

Syntax

createQuerySet(descriptor)

Parameter

descriptor

Ein Objekt, das die folgenden Eigenschaften enthält:

count

Eine Zahl, die die Anzahl der Abfragen angibt, die vom resultierendenGPUQuerySet verwaltet werden sollen.

labelOptional

Ein String, der ein Label bereitstellt, das verwendet werden kann, um das Objekt zu identifizieren, zum Beispiel inGPUError-Meldungen oder Konsolenwarnungen.

type

Ein enumerierter Wert, der den Typ der Abfragen angibt, die vom resultierendenGPUQuerySet verwaltet werden sollen. Mögliche Werte sind:

"occlusion"

Okklusionsabfragen stehen bei Render-Passes zur Verfügung, um die Anzahl der Fragmentproben abzufragen, die alle per-Fragment-Tests für einen Satz von Zeichnungsbefehlen bestehen (einschließlich Schere, Sample-Maske, Alpha-to-Coverage, Schablonen- und Tiefentests). Um eine Okklusionsabfrage auszuführen, muss ein geeignetesGPUQuerySet als Wert derocclusionQuerySet-Deskriptoreigenschaft angegeben werden, wennGPUCommandEncoder.beginRenderPass() aufgerufen wird, um einen Render-Pass auszuführen.

"timestamp"

Zeitstempelabfragen ermöglichen es Anwendungen, Zeitstempel an einGPUQuerySet zu schreiben. Um eine Zeitstempelabfrage auszuführen, müssen geeigneteGPUQuerySet innerhalb des Wertes dertimestampWrites-Deskriptoreigenschaft bereitgestellt werden, wennGPUCommandEncoder.beginRenderPass() aufgerufen wird, um einen Render-Pass auszuführen, oderGPUCommandEncoder.beginComputePass(), um einen Compute-Pass auszuführen. Alternativ können Sie jederzeit eine einzelne Zeitstempelabfrage durchführen, indem SieGPUCommandEncoder.writeTimeStamp() mit einem geeignetenGPUQuerySet als Parameter aufrufen.

Hinweis:Dastimestamp-queryFeature muss aktiviert sein, um Zeitstempelabfragen verwenden zu können.

Rückgabewert

Eine Instanz einesGPUQuerySet-Objekts.

Validierung

Die folgenden Kriterien müssen erfüllt sein, wenncreateQuerySet() aufgerufen wird, andernfalls wird einGPUValidationError generiert und ein ungültigesGPUQuerySet-Objekt zurückgegeben:

• count ist kleiner oder gleich 4096.

Beispiele

Das folgende Snippet erstellt einGPUQuerySet, das 32 Okklusionsabfrageergebnisse hält:

const querySet = device.createQuerySet({  type: "occlusion",  count: 32,});

Spezifikationen

Browser-Kompatibilität

Siehe auch

• DieWebGPU API