GPUCommandEncoder: resolveQuerySet() Methode

Syntax

resolveQuerySet(querySet, firstQuery, queryCount, destination, destinationOffset)

Parameter

querySet

Ein GPUQuerySet-Objekt, das das aufzulsende Abfrageset darstellt.

firstQuery

Die Indexnummer des ersten Abfragewerts, der in den Puffer kopiert werden soll.

queryCount

Die Anzahl der Abfragen, die beginnend mit firstQuery in den Puffer kopiert werden sollen.

destination

Ein GPUBuffer, der den Puffer darstellt, in den die Abfragewerte kopiert werden.

destinationOffset

Eine Zahl, die den Versatz in Bytes vom Beginn des Puffers darstellt, an dem die Abfragewerte geschrieben werden sollen.

Rckgabewert

Keiner (undefined).

Validierung

Die folgenden Kriterien mssen erfllt sein, wenn resolveQuerySet() aufgerufen wird. Andernfalls wird ein GPUValidationError generiert und der GPUCommandEncoder wird ungltig:

• Der GPUBuffer.usage des destination.buffer muss das GPUBufferUsage.QUERY_RESOLVE-Flag beinhalten.
• firstQuery ist kleiner als die Anzahl der Abfragen in querySet.
• firstQuery + queryCount ist kleiner oder gleich der Anzahl der Abfragen in querySet.
• destinationOffset ist ein Vielfaches von 256.
• destinationOffset + 8 queryCount ist kleiner oder gleich destination.size.

Beispiele

// 

const queryBuffer = device.createBuffer({
  size: 1024,
  usage: GPUBufferUsage.QUERY_RESOLVE,
});

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

// 

const commandEncoder = device.createCommandEncoder();

// Write timestamps to querySet
commandEncoder.writeTimestamp(querySet, 0);
// 
commandEncoder.writeTimestamp(querySet, 1);
// etc.

// 

commandEncoder.resolveQuerySet(
  querySet,
  0, // First query to write
  16, // Number of queries to count
  queryBuffer,
  0, // Buffer offset
);

// 

Spezifikationen

Browser-Kompatibilitt

Siehe auch

• Die WebGPU API