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

Смотрите также