GPUDevice

Интерфейс GPUDevice API WebGPU представляет собой логическое устройство GPU. Это основной интерфейс, через который осуществляется доступ к большинству функций WebGPU.

Объект GPUDevice запрашивается с помощью метода GPUAdapter.requestDevice().

Наследует свойства от своего родителя, EventTarget.

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

Объект GPUSupportedFeatures, описывающий дополнительные возможности, поддерживаемые устройством.

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

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

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

Объект GPUSupportedLimits, описывающий ограничения, поддерживаемые устройством.

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

Содержит Promise, который остается ожидающим в течение всего срока службы устройства и разрешается с объектом GPUDeviceLostInfo, когда устройство потеряно.

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

Возвращает основной GPUQueue для устройства.

Наследует методы от своего родителя, EventTarget.

createBindGroup() Экспериментальный

Создаёт GPUBindGroup на основе GPUBindGroupLayout, который определяет набор ресурсов, которые будут связаны вместе в группе, и как эти ресурсы используются в стадиях шейдеров.

createBindGroupLayout() Экспериментальный

Создаёт GPUBindGroupLayout, который определяет структуру и назначение связанных ресурсов GPU, таких как буферы, которые будут использоваться в конвейере, и используется в качестве шаблона при создании GPUBindGroup.

createBuffer() Экспериментальный

Создаёт GPUBuffer, в котором хранятся сырые данные для использования в операциях GPU.

createCommandEncoder() Экспериментальный

Создаёт GPUCommandEncoder, который используется для кодирования команд, которые должны быть отправлены GPU.

createComputePipeline() Экспериментальный

Создаёт GPUComputePipeline, который может управлять стадией вычислительного шейдера и использоваться в GPUComputePassEncoder.

createComputePipelineAsync() Экспериментальный

Возвращает Promise, который выполняется с GPUComputePipeline, который может управлять стадией вычислительного шейдера и использоваться в GPUComputePassEncoder, как только конвейер можно будет использовать без задержек.

createPipelineLayout() Экспериментальный

Создаёт GPUPipelineLayout, который определяет GPUBindGroupLayouts, используемые конвейером. GPUBindGroups, используемые с конвейером во время кодирования команд, должны иметь совместимые GPUBindGroupLayouts.

createQuerySet() Экспериментальный

Создаёт GPUQuerySet, который можно использовать для записи результатов запросов к проходам, таких как запросы на окклюзию или отметки времени.

createRenderBundleEncoder() Экспериментальный

Создаёт GPURenderBundleEncoder, который можно использовать для предварительной записи наборов команд. Они могут быть повторно использованы в GPURenderPassEncoder с помощью метода executeBundles() столько раз, сколько необходимо.

createRenderPipeline() Экспериментальный

Создаёт GPURenderPipeline, который может управлять вершинными и фрагментными стадиями шейдеров и использоваться в GPURenderPassEncoder или GPURenderBundleEncoder.

createRenderPipelineAsync() Экспериментальный

Возвращает Promise, который выполняется с GPURenderPipeline, который может управлять вершинными и фрагментными стадиями шейдеров и использоваться в GPURenderPassEncoder или GPURenderBundleEncoder, как только конвейер можно будет использовать без задержек.

createSampler() Экспериментальный

Создаёт GPUSampler, который управляет тем, как шейдеры преобразуют и фильтруют данные текстурных ресурсов.

createShaderModule() Экспериментальный

Создаёт GPUShaderModule из строки исходного кода WGSL.

createTexture() Экспериментальный

Создаёт GPUTexture, в котором хранятся данные текстуры для использования в операциях рендеринга GPU.

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

Уничтожает устройство, предотвращая дальнейшие операции с ним.

importExternalTexture() Экспериментальный

Принимает HTMLVideoElement в качестве входных данных и возвращает GPUExternalTexture объект-обёртку, содержащий моментальный снимок видео, который можно использовать в операциях рендеринга GPU.

popErrorScope() Экспериментальный

Выталкивает существующий область видимости ошибок GPU из стека области видимости ошибок и возвращает Promise, который разрешается до объекта (GPUInternalError, GPUOutOfMemoryError или GPUValidationError), описывающего первую ошибку, захваченную в области видимости, или null если ошибка не произошла.

pushErrorScope() Экспериментальный

Добавляет новую область видимости ошибок GPU в стек области видимости ошибок устройства, позволяя захватывать ошибки определённого типа.

uncapturederror Экспериментальный

Срабатывает, когда возникает ошибка, которая не была обнаружена областью видимости ошибок GPU, чтобы предоставить способ сообщить об неожиданных ошибках. Известные случаи ошибок должны обрабатываться с использованием pushErrorScope() и popErrorScope().

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 device = await adapter.requestDevice();

  const shaderModule = device.createShaderModule({
    code: shaders,
  });

  //...
}

Обратитесь к отдельным страницам членов, указанным выше, и к следующим демонстрационным сайтам для получения гораздо больше примеров использования GPUDevice:

• Демонстрация базовых вычислений
• Демонстрация базового рендеринга
• Примеры WebGPU

• API WebGPU