GPUDevice: createQuerySet() 方法

descriptor

一个包含以下属性的对象

count

一个数字，指定由生成的 GPUQuerySet 管理的查询数量。

label 可选

一个字符串，提供一个标签，该标签可用于标识对象，例如在 GPUError 消息或控制台警告中。

type

一个枚举值，指定由生成的 GPUQuerySet 管理的查询类型。可能的值是

"occlusion"

遮挡查询可在渲染通道上使用，以查询通过一组绘制命令（包括裁剪、样本掩码、Alpha 到覆盖、模板和深度测试）的所有逐片段测试的片段样本数量。要运行遮挡查询，必须将适当的 GPUQuerySet 作为 occlusionQuerySet 描述符属性的值提供，在调用 GPUCommandEncoder.beginRenderPass() 以运行渲染通道时。

"timestamp"

时间戳查询允许应用程序将时间戳写入 GPUQuerySet。要运行时间戳查询，必须在调用 GPUCommandEncoder.beginRenderPass() 以运行渲染通道或 GPUCommandEncoder.beginComputePass() 以运行计算通道时，在 timestampWrites 描述符属性的值中提供适当的 GPUQuerySet。或者，您可以通过将适当的 GPUQuerySet 作为参数调用 GPUCommandEncoder.writeTimeStamp() 来随时运行单个时间戳查询。

要使用时间戳查询，timestamp-query 功能 必须在 GPUDevice 中启用。

一个 GPUQuerySet 对象实例。

调用 createQuerySet() 时，必须满足以下条件，否则将生成 GPUValidationError，并返回一个无效的 GPUQuerySet 对象

• count 小于或等于 4096。

以下代码片段创建了一个包含 32 个遮挡查询结果的 GPUQuerySet

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

• WebGPU API