GPUAdapter: метод requestDevice()

Метод requestDevice() интерфейса GPUAdapter возвращает Promise, который выполняется с объектом GPUDevice, который является основным интерфейсом для взаимодействия с графическим процессором.

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

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

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

Объект, предоставляющий информацию для стандартной очереди устройства GPUQueue (как возвращается GPUDevice.queue). У этого объекта есть единственное свойство — label — которое предоставляет стандартную очередь со значением label. Если значение не предоставлено, по умолчанию используется пустой объект, а метка стандартной очереди будет пустой строкой.

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

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

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

Массив строк, представляющих дополнительную функциональность, которую вы хотите поддерживать возвращаемым GPUDevice. Вызов requestDevice() завершится ошибкой, если GPUAdapter не может предоставить эти функции. Полный список возможных функций см. в GPUSupportedFeatures. По умолчанию используется пустой массив, если значение не указано.

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

Объект, содержащий свойства, представляющие ограничения, которые вы хотите поддерживать возвращаемым GPUDevice. Вызов requestDevice() завершится ошибкой, если GPUAdapter не может предоставить эти ограничения. Каждый ключ должен быть именем члена GPUSupportedLimits. По умолчанию используется пустой объект, если значение не указано.

A Promise, который выполняется с объектом GPUDevice.

Если вы вызываете функцию повторно, т.е. вызываете requestDevice() на GPUAdapter, на котором requestDevice() уже был вызван, обещание выполняется с устройством, которое немедленно потеряно. Затем вы можете получить информацию о том, как устройство было потеряно, с помощью GPUDevice.lost.

OperationError DOMException

Обещание отклоняется с OperationError если ограничения, включенные в свойство requiredLimits, не поддерживаются GPUAdapter, либо потому, что они не являются допустимыми ограничениями, либо потому, что их значения выше, чем значения адаптера для этих ограничений.

TypeError DOMException

Обещание отклоняется с TypeError если функции, включенные в свойство requiredFeatures, не поддерживаются GPUAdapter.

В следующем коде мы:

1. Проверяем, доступна ли функция texture-compression-astc для GPUAdapter. Если да, мы добавляем ее в массив requiredFeatures.
2. Запрашиваем значение GPUAdapter.limits для maxBindGroups и проверяем, равно ли оно или больше 6. Нашему теоретическому приложению идеально подходят 6 групп связывания. Если возвращаемое значение >= 6, мы добавляем максимальное ограничение в 6 к объекту requiredLimits.
3. Запрашиваем устройство с этими требованиями к функциям и ограничениям, а также меткой defaultQueue.

async function init() {
  if (!navigator.gpu) {
    throw Error("WebGPU not supported.");
  }

  const adapter = await navigator.gpu.requestAdapter();
  if (!adapter) {
    throw Error("Couldn't request WebGPU adapter.");
  }

  const requiredFeatures = [];

  if (adapter.features.has("texture-compression-astc")) {
    requiredFeatures.push("texture-compression-astc");
  }

  const requiredLimits = {};

  // App ideally needs 6 bind groups, so we'll try to request what the app needs
  if (adapter.limits.maxBindGroups >= 6) {
    requiredLimits.maxBindGroups = 6;
  }

  const device = await adapter.requestDevice({
    defaultQueue: {
      label: "my_queue",
    },
    requiredFeatures,
    requiredLimits,
  });

  // ...
}

• The API WebGPU