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.

Примеры

Привязка текстуры

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

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

BCD tables only load in the browser

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