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);

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

Specification
WebGL Specification (WebGL)
# 5.14.8
WebGL 2.0 Specification (WebGL 2.0)
# 3.7.1

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

BCD tables only load in the browser

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