GPUQuerySet

Интерфейс GPUQuerySet API WebGPU используется для записи результатов запросов к проходам, таких как запросы на непрозрачность или временные метки.

• Запросы на непрозрачность доступны для проходов отрисовки, чтобы определить, проходят ли фрагменты все проверки по фрагменту для набора команд отрисовки (включая обрезку, маску выборки, альфа-к-покрытию, стереоскопию и проверки глубины). Для выполнения запроса на непрозрачность необходимо предоставить соответствующий GPUQuerySet в качестве значения свойства описателя occlusionQuerySet, когда вызывается GPUCommandEncoder.beginRenderPass() для выполнения прохода отрисовки.

• Запросы на временные метки позволяют приложениям записывать временные метки в GPUQuerySet. Для выполнения запроса на временную метку необходимо предоставить соответствующие GPUQuerySet внутри значения свойства описателя timestampWrites, когда вызывается GPUCommandEncoder.beginRenderPass() для выполнения прохода отрисовки или GPUCommandEncoder.beginComputePass() для выполнения прохода вычисления.

Объект GPUQuerySet создаётся с помощью метода GPUDevice.createQuerySet().

count Экспериментальная Только для чтения

Число, указывающее количество запросов, управляемых GPUQuerySet.

label Экспериментальная

Строка, предоставляющая метку, которая может использоваться для идентификации объекта, например, в сообщениях об GPUError ошибках или предупреждениях консоли.

type Экспериментальная Только для чтения

Перечисление, указывающее тип запросов, управляемых GPUQuerySet.

destroy() Экспериментальная

Удаляет GPUQuerySet.

Следующий фрагмент кода создаёт GPUQuerySet, который хранит 32 результата запросов на непрозрачность, а затем возвращает type и count:

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

console.log(querySet.count); // 32
console.log(querySet.type); // "occlusion"

• API WebGPU