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 |
См. также
© 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