WebGLRenderingContext: метод copyTexImage2D()
Базовая Широко доступная
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна во всех браузерах с июля 2015 года.
Примечание: Эта функция доступна в Потоках Web Workers.
Метод WebGLRenderingContext.copyTexImage2D() API WebGL копирует пиксели из текущего WebGLFramebuffer в изображение 2D текстуры.
Синтаксис
copyTexImage2D(target, level, internalformat, x, y, width, height, border)
Параметры
target-
Значение
GLenum, определяющее точку привязки (цель) активной текстуры. Возможные значения:-
gl.TEXTURE_2D: Двумерная текстура. -
gl.TEXTURE_CUBE_MAP_POSITIVE_X: Положительная X грань кубовой текстуры. -
gl.TEXTURE_CUBE_MAP_NEGATIVE_X: Отрицательная X грань кубовой текстуры. -
gl.TEXTURE_CUBE_MAP_POSITIVE_Y: Положительная Y грань кубовой текстуры. -
gl.TEXTURE_CUBE_MAP_NEGATIVE_Y: Отрицательная Y грань кубовой текстуры. -
gl.TEXTURE_CUBE_MAP_POSITIVE_Z: Положительная Z грань кубовой текстуры. -
gl.TEXTURE_CUBE_MAP_NEGATIVE_Z: Отрицательная Z грань кубовой текстуры.
-
level-
Значение
GLint, определяющее уровень детализации. Уровень 0 — базовый уровень изображения, а уровень n — n-ый уровень уменьшения мип-карты. internalformat-
Значение
GLenum, определяющее цветовые компоненты в текстуре. Возможные значения:-
gl.ALPHA: Отбрасывает красные, зелёные и синие компоненты и считывает альфа-компонент. -
gl.RGB: Отбрасывает альфа-компоненты и считывает красные, зелёные и синие компоненты. -
gl.RGBA: Считываются красные, зелёные, синие и альфа-компоненты из буфера цвета. -
gl.LUMINANCE: Каждый цветовой компонент — компонент яркости, альфа — 1.0. -
gl.LUMINANCE_ALPHA: Каждый компонент — компонент яркости/альфа.
-
x-
Значение
GLint, определяющее координату x левого нижнего угла, с которого начинается копирование. y-
Значение
GLint, определяющее координату y левого нижнего угла, с которого начинается копирование. width-
Значение
GLsizei, определяющее ширину текстуры. height-
Значение
GLsizei, определяющее высоту текстуры. border-
Значение
GLint, определяющее ширину границы. Должно быть равно 0.
Возвращаемое значение
None (undefined).
Примеры
gl.copyTexImage2D(gl.TEXTURE_2D, 0, gl.RGBA, 0, 0, 512, 512, 0);
Спецификации
| Спецификация |
|---|
| Спецификация WebGL # 5.14.8 |
Совместимость с браузерами
| Рабочие столы | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на iOS | Samsung Internet | WebView Android | |
copyTexImage2D |
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/copyTexImage2D
