Spec-Zone.ru › Web APIs

WebGLRenderingContext: метод viewport()

Базовая линия Широко поддерживается

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.

  • Подробнее
  • Полная совместимость
  • Отправить отзыв

Примечание: Эта функция доступна в Web Workers.

Метод WebGLRenderingContext.viewport() API WebGL устанавливает область обзора, которая определяет аффинное преобразование x и y из нормализованных координат устройства в координаты окна.

Синтаксис

viewport(x, y, width, height)

Параметры

x

Значение типа GLint, определяющее горизонтальную координату левого нижнего угла начала области обзора. Значение по умолчанию: 0.

y

Значение типа GLint, определяющее вертикальную координату левого нижнего угла начала области обзора. Значение по умолчанию: 0.

width

Неотрицательное значение типа GLsizei, определяющее ширину области обзора. Значение по умолчанию: ширина холста.

height

Неотрицательное значение типа GLsizei, определяющее высоту области обзора. Значение по умолчанию: высота холста.

Возвращаемое значение

None (undefined).

Исключения

Если значение width или height отрицательное, будет выброшено исключение gl.INVALID_VALUE.

Примеры

При первом создании контекста WebGL размер области обзора соответствует размеру холста. Однако, если вы измените размер холста, вам нужно будет указать новый размер области обзора для контекста WebGL. В этом случае можно использовать gl.viewport.

gl.viewport(0, 0, canvas.width, canvas.height);

Ширина и высота области обзора ограничены диапазоном, зависящим от реализации. Чтобы получить этот диапазон, можно использовать константу MAX_VIEWPORT_DIMS, которая возвращает Int32Array.

gl.getParameter(gl.MAX_VIEWPORT_DIMS);
// e.g. Int32Array[16384, 16384]

Чтобы получить текущую область обзора, обратитесь к константе VIEWPORT.

gl.getParameter(gl.VIEWPORT);
// e.g. Int32Array[0, 0, 640, 480]

Спецификации

Спецификация
Спецификация WebGL
# 5.14.4

Совместимость с браузерами

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari в iOS Samsung Internet WebView Android
viewport 9 12 4 12 5.1 25 4 12 8 1.5 4.4.3

См. также

  • WebGLRenderingContext.scissor()
  • WebGLRenderingContext.getParameter()

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/WebGLRenderingContext/viewport

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API