Spec-Zone.ru › Web APIs

WebGLRenderingContext: метод copyTexSubImage2D()

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

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

  • Узнать больше
  • Показать полную совместимость
  • Отправить отзыв

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

Метод WebGLRenderingContext.copyTexSubImage2D() из WebGL API копирует пиксели из текущего WebGLFramebuffer в существующий подфрагмент 2D-текстуры.

Синтаксис

copyTexSubImage2D(target, level, xoffset, yoffset, x, y, width, height)

Параметры

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-й уровень уменьшения mipmap.

xoffset

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

yoffset

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

x

GLint, определяющий координату x левого нижнего угла, с которого начинается копирование.

y

GLint, определяющий координату y левого нижнего угла, с которого начинается копирование.

width

GLsizei, определяющий ширину текстуры.

height

GLsizei, определяющий высоту текстуры.

Значение, возвращаемое методом

Ничего (undefined).

Примеры

gl.copyTexSubImage2D(gl.TEXTURE_2D, 0, 0, 0, 0, 0, 16, 16);

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

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

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

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

См. также

  • WebGLRenderingContext.copyTexImage2D()
  • WebGLRenderingContext.texImage2D()
  • WebGLRenderingContext.texSubImage2D()
  • WebGLRenderingContext.compressedTexImage2D()

© 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/copyTexSubImage2D

Spec-Zone.ru

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