GPURenderPassEncoder: метод setViewport()

Метод setViewport() интерфейса GPURenderPassEncoder устанавливает область просмотра, используемую на стадии растрирования, для линейного отображения от нормализованных координат устройства до координат области просмотра.

x

Число, представляющее минимальное значение X области просмотра в пикселях.

y

Число, представляющее минимальное значение Y области просмотра в пикселях.

width

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

height

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

minDepth

Число, представляющее минимальное значение глубины области просмотра.

maxDepth

Число, представляющее максимальное значение глубины области просмотра.

None (Undefined).

При вызове setViewport() должны быть соблюдены следующие критерии; в противном случае генерируется ошибка GPUValidationError, и GPURenderPassEncoder становится недействительным:

• x, y, width, и height должны быть больше или равны 0.
• x + width должно быть меньше или равно ширине прикреплений рендеринга прохода рендеринга (см. примечание ниже).
• y + height должно быть меньше или равно высоте прикреплений рендеринга прохода рендеринга (см. примечание ниже).
• minDepth и maxDepth должны находиться в диапазоне от 0,0 до 1,0 включительно.
• minDepth должно быть меньше maxDepth.

В типичном рендеринге на холсте можно использовать следующий код, чтобы уменьшить ширину и высоту рендерируемой графики вдвое:

passEncoder.setViewport(0, 0, canvas.width / 2, canvas.height / 2, 0, 1);

В примере WebGPU Samples reversedZ, setViewport используется несколько раз для установки области просмотра для разных проходов рендеринга. Изучите пример кода для полного контекста.

Например:

// ...

colorPass.setViewport(
  (canvas.width * m) / 2,
  0,
  canvas.width / 2,
  canvas.height,
  0,
  1,
);

// ...

• API WebGPU