WebGLRenderingContext.bindTexture()

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.

Примеры

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

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

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