GPURenderPassEncoder: метод executeBundles()

Метод executeBundles() интерфейса GPURenderPassEncoder выполняет команды, ранее записанные в указанные объекты GPURenderBundle, в рамках этого рендеринга.

bundles

Массив объектов GPURenderBundle, содержащих предварительно записанные команды для выполнения.

None (Undefined).

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

Для каждого объекта GPURenderBundle:

• Если свойство depthReadOnly прохода рендеринга (как указано в описателе исходного вызова GPUCommandEncoder.beginRenderPass()) равно true, то свойство depthReadOnly набора (как указано в описателе вызова GPUDevice.createRenderBundleEncoder(), создавшего исходный объект GPURenderBundleEncoder) также равно true.
• Если свойство stencilReadOnly прохода рендеринга (как указано в описателе исходного вызова GPUCommandEncoder.beginRenderPass()) равно true, то свойство stencilReadOnly набора (как указано в описателе вызова GPUDevice.createRenderBundleEncoder(), создавшего исходный объект GPURenderBundleEncoder) также равно true.
• Макет конвейера рендеринга, указанный в GPURenderPassEncoder.setPipeline() (как определено в описателе исходного вызова GPUDevice.createRenderPipeline()), равен макету конвейера набора рендеринга, указанному в GPURenderBundleEncoder.setPipeline().

В примере Animometer из примеров WebGPU много подобных операций выполняется одновременно на многих разных объектах. executeBundles() используется для повторного использования работы над несколькими проходами рендеринга, чтобы улучшить производительность. Изучите пример кода для полного контекста.

// ...

return function doDraw(timestamp) {
  if (startTime === undefined) {
    startTime = timestamp;
  }
  uniformTime[0] = (timestamp - startTime) / 1000;
  device.queue.writeBuffer(uniformBuffer, timeOffset, uniformTime.buffer);

  renderPassDescriptor.colorAttachments[0].view = context
    .getCurrentTexture()
    .createView();

  const commandEncoder = device.createCommandEncoder();
  const passEncoder = commandEncoder.beginRenderPass(renderPassDescriptor);

  if (settings.renderBundles) {
    passEncoder.executeBundles([renderBundle]);
  } else {
    recordRenderPass(passEncoder);
  }

  passEncoder.end();
  device.queue.submit([commandEncoder.finish()]);
};

// ...

• The API WebGPU