GPUTexture

Интерфейс GPUTexture API WebGPU представляет собой контейнер, используемый для хранения одномерных, двумерных или трехмерных массивов данных, таких как изображения, для использования в операциях рендеринга на GPU.

Экземпляр объекта GPUTexture создается с помощью метода GPUDevice.createTexture().

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

Число, представляющее глубину или количество слоев GPUTexture (пиксели или количество слоев).

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

Перечисление, представляющее размер набора текселей для каждого GPUTexture подресурса.

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

Значение перечисления, представляющее формат GPUTexture. См. раздел «Форматы текстур» в спецификации по всем возможным значениям.

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

Число, представляющее высоту GPUTexture в пикселях.

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

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

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

Число, представляющее количество уровней MIP GPUTexture.

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

Число, представляющее количество выборок GPUTexture.

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

Битовые флаги, представляющие разрешенные варианты использования GPUTexture.

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

Число, представляющее ширину GPUTexture в пикселях.

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

Создает GPUTextureView, представляющий определенный вид GPUTexture.

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

Уничтожает GPUTexture.

В примере WebGPU Textured Cube sample текстура для использования на гранях куба создается следующим образом:

• Загрузка изображения в HTMLImageElement и создание битовой карты изображения с помощью createImageBitmap().
• Создание новой GPUTexture с помощью createTexture().
• Копирование битовой карты изображения в текстуру с помощью GPUQueue.copyExternalImageToTexture().

//...
let cubeTexture;
{
  const img = document.createElement("img");

  img.src = new URL(
    "../../../assets/img/Di-3d.png",
    import.meta.url,
  ).toString();

  await img.decode();

  const imageBitmap = await createImageBitmap(img);

  cubeTexture = device.createTexture({
    size: [imageBitmap.width, imageBitmap.height, 1],
    format: "rgba8unorm",
    usage:
      GPUTextureUsage.TEXTURE_BINDING |
      GPUTextureUsage.COPY_DST |
      GPUTextureUsage.RENDER_ATTACHMENT,
  });

  device.queue.copyExternalImageToTexture(
    { source: imageBitmap },
    { texture: cubeTexture },
    [imageBitmap.width, imageBitmap.height],
  );
}
//...

• The WebGPU API