GPUCommandEncoder: метод copyTextureToTexture()

Метод copyTextureToTexture() интерфейса GPUCommandEncoder кодирует команду, копирующую данные из одной GPUTexture в другую.

source

Объект (см. Структура объекта копирования текстуры), определяющий текстуру, из которой копируются данные. В сочетании с copySize он определяет область подресурса исходной текстуры.

destination

Объект (см. Структура объекта копирования текстуры), определяющий текстуру, в которую записываются данные. В сочетании с copySize он определяет область подресурса целевой текстуры.

copySize

Объект или массив, определяющий ширину, высоту и глубину/количество слоев массива копируемых данных. Ширина всегда должна быть указана, а высота и глубина/количество слоев массива — необязательны и по умолчанию равны 1, если не указаны.

Вот пример массива copySize:

[16, 16, 2];

Эквивалентный объект выглядит так:

{
  width: 16,
  height: 16,
  depthOrArrayLayers: 2
}

Объект копирования текстуры имеет следующую структуру:

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

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

"all"

Будут скопированы все доступные аспекты формата текстуры, что может означать все или любые из цветового, глубины и трафарета в зависимости от типа формата.

"depth-only"

Будет скопирован только аспект глубины формата глубины или трафарета.

"stencil-only"

Будет скопирован только аспект трафарета формата глубины или трафарета.

Если не указано, aspect принимает значение "all".

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

Число, представляющее уровень mip-маски текстуры для копирования данных. Если не указано, mipLevel по умолчанию равен 0.

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

Объект или массив, определяющий начало копирования/назначения — крайнюю нижнюю точку области текстуры для копирования данных. Вместе с size он определяет весь объём области для копирования. Значения x, y и z по умолчанию равны 0, если какой-либо или все origin не указаны.

Пример массива:

[0, 0, 0];

Эквивалентный объект:

{
  x: 0,
  y: 0,
  z: 0
}

texture

Объект GPUTexture, представляющий текстуру для копирования данных.

Ничего (Undefined).

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

Для source:

• source's GPUTexture.usage включает флаг GPUTextureUsage.COPY_SRC.

Для destination:

• source's GPUTexture.usage включает флаг GPUTextureUsage.COPY_DST.

Для source и destination:

• mipLevel меньше, чем GPUTexture.mipLevelCount.
• origin.x кратно ширине блока текселей GPUTexture.format.
• origin.y кратно высоте блока текселей GPUTexture.format.
• Исходная и целевая texture GPUTexture.format совместимы для копирования.
• Исходная и целевая texture GPUTexture.sampleCount равны.
• Если GPUTexture.format — формат глубины или трафарета или GPUTexture.sampleCount больше 1, размер подресурса равен size.
• texture's GPUTexture.sampleCount равно 1.
• aspect ссылается на один аспект GPUTexture.format.
• Этот аспект является допустимым источником/назначением копирования изображения в соответствии с форматами глубины или трафарета.
• texture совместим с copySize.

• API WebGPU