GPUDevice: createQuerySet()-Methode

descriptor

Ein Objekt, das die folgenden Eigenschaften enthält:

count

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

label Optional

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

type

Ein enumerierter Wert, der den Typ der Abfragen angibt, die vom resultierenden GPUQuerySet 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 geeignetes GPUQuerySet als Wert der occlusionQuerySet-Deskriptoreigenschaft angegeben werden, wenn GPUCommandEncoder.beginRenderPass() aufgerufen wird, um einen Render-Pass auszuführen.

"timestamp"

Zeitstempelabfragen ermöglichen es Anwendungen, Zeitstempel an ein GPUQuerySet zu schreiben. Um eine Zeitstempelabfrage auszuführen, müssen geeignete GPUQuerySet innerhalb des Wertes der timestampWrites-Deskriptoreigenschaft bereitgestellt werden, wenn GPUCommandEncoder.beginRenderPass() aufgerufen wird, um einen Render-Pass auszuführen, oder GPUCommandEncoder.beginComputePass(), um einen Compute-Pass auszuführen. Alternativ können Sie jederzeit eine einzelne Zeitstempelabfrage durchführen, indem Sie GPUCommandEncoder.writeTimeStamp() mit einem geeigneten GPUQuerySet als Parameter aufrufen.

Hinweis: Das timestamp-query Feature muss aktiviert sein, um Zeitstempelabfragen verwenden zu können.

Eine Instanz eines GPUQuerySet-Objekts.

Die folgenden Kriterien müssen erfüllt sein, wenn createQuerySet() aufgerufen wird, andernfalls wird ein GPUValidationError generiert und ein ungültiges GPUQuerySet-Objekt zurückgegeben:

• count ist kleiner oder gleich 4096.

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

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

• Die WebGPU API