WebGPU API
The resolveQuerySet() method of the
GPUCommandEncoder interface encodes a command that resolves a GPUQuerySet, copying the results into a specified GPUBuffer.
Syntax
resolveQuerySet(querySet, firstQuery, queryCount, destination, destinationOffset)
Parameters
querySet- : A GPUQuerySet object representing the query set to be resolved.
firstQuery- : The index number of the first query value to be copied over to the buffer.
queryCount- : The number of queries to be copied over to the buffer, starting from
firstQuery.
- : The number of queries to be copied over to the buffer, starting from
destination- : A GPUBuffer representing the buffer to copy the query values to.
destinationOffset- : A number representing the offset, in bytes, from the start of the buffer to start writing the query values at.
Return value
None (undefined).
Validation
The following criteria must be met when calling resolveQuerySet(), otherwise a GPUValidationError is generated and the GPUCommandEncoder becomes invalid:
- The
destination.buffer's GPUBuffer.usage includes theGPUBufferUsage.QUERY_RESOLVEflag. firstQueryis smaller than the number of queries inquerySet.firstQuery+queryCountis smaller than or equal to the number of queries inquerySet.destinationOffsetis a multiple of 256.destinationOffset+ 8 ×queryCountis less than or equal todestination.size.
Examples
// …
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
);
// …
Specifications
Browser compatibility
See also
- The WebGPU API
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
