WebGLRenderingContext.bindTexture()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
WebGLRenderingContext.bindTexture() метод WebGL API связывает WebGLTexture с target.
Синтаксис
void gl.bindTexture(target, texture);
Параметры
- target
-
GLenumуказывает тип объектаtextureдля связывания. Возможные значения:-
gl.TEXTURE_2D: двухмерная текстура. -
gl.TEXTURE_CUBE_MAP: кубическая текстура. -
При использовании WebGL 2 context, дополнительно доступны:
gl.TEXTURE_3D: трёхмерная текстура.gl.TEXTURE_2D_ARRAY: массив двумерных текстур.
-
- texture
-
WebGLTextureобъект связывания
Возвращаемое значение
None.
Исключения
gl.INVALID_ENUM исключение если target не gl.TEXTURE_2D, gl.TEXTURE_CUBE_MAP, gl.TEXTURE_3D, или gl.TEXTURE_2D_ARRAY.
Примеры
Привязка текстуры
js
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.
js
gl.getParameter(gl.TEXTURE_BINDING_2D);
Спецификации
| Specification |
|---|
| WebGL Specification # 5.14.8 |
| WebGL 2.0 Specification # 3.7.1 |