GPUDevice: метод createQuerySet()

Метод createQuerySet() интерфейса GPUDevice создаёт GPUQuerySet, который можно использовать для записи результатов запросов на проходах, таких как запросы на непрозрачность или временные метки.

descriptor

Объект, содержащий следующие свойства:

count

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

label Необязательно

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

type

Перечисление, указывающее тип запросов, которые будут управляться полученным GPUQuerySet. Возможные значения:

"occlusion"

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

"timestamp"

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

Примечание: Необходимо включить timestamp-query функцию, чтобы использовать запросы временных меток.

Экземпляр объекта GPUQuerySet.

При вызове createQuerySet() должны быть соблюдены следующие критерии, в противном случае генерируется GPUValidationError и возвращается недействительный объект GPUQuerySet:

• Значение count должно быть меньше или равно 4096.

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

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

• API WebGPU