WebGLRenderingContext.bindTexture()
WebGLRenderingContext.bindTexture()
метод WebGL API связывает WebGLTexture
(en-US) с target
.
Синтаксис
void gl.bindTexture(target, texture);
Параметры
- target
GLenum
(en-US) указывает тип объектаtexture
для связывания. Возможные значения:gl.TEXTURE_2D
: двухмерная текстура.gl.TEXTURE_CUBE_MAP
: кубическая текстура.- При использовании WebGL 2 context (en-US), дополнительно доступны:
gl.TEXTURE_3D
: трёхмерная текстура.gl.TEXTURE_2D_ARRAY
: массив двумерных текстур.
- texture
WebGLTexture
(en-US) объект связывания
Возвращаемое значение
None.
Исключения
gl.INVALID_ENUM
исключение если target
неgl.TEXTURE_2D
, gl.TEXTURE_CUBE_MAP
, gl.TEXTURE_3D
, или gl.TEXTURE_2D_ARRAY
.
Примеры
Привязка текстуры
var canvas = document.getElementById('canvas');
var gl = canvas.getContext('webgl');
var texture = gl.createTexture();
gl.bindTexture(gl.TEXTURE_2D, texture);
Получить текущую привязку
Для проверки текущей привязки текстуры, вызовитеgl.TEXTURE_BINDING_2D
или gl.TEXTURE_BINDING_CUBE_MAP
.
gl.getParameter(gl.TEXTURE_BINDING_2D);
Спецификации
Спецификация | Статус | Комментарии |
---|---|---|
WebGL 1.0 Определение 'bindTexture' в этой спецификации. |
Рекомендация | Initial definition for WebGL. |
OpenGL ES 2.0 Определение 'glBindTexture' в этой спецификации. |
Стандарт | Man page of the (similar) OpenGL ES 2.0 API. |
WebGL 2.0 Определение 'bindTexture' в этой спецификации. |
Редакторский черновик | Updated definition for WebGL 2. Adds: gl.TEXTURE_3D and gl.TEXTURE_2D_ARRAY |
OpenGL ES 3.0 Определение 'glBindTexture' в этой спецификации. |
Стандарт | Man page of the (similar) OpenGL ES 3.0 API. |
Совместимость с браузерами
BCD tables only load in the browser
Таблица совместимости на этой странице создаётся из структурированных данных. Если вы хотите внести свой вклад в данные, ознакомьтесь с https://github.com/mdn/browser-compat-data и отправить нам запрос на слияние.