This page was translated from English by the community. Learn more and join the MDN Web Docs community.

View in English Always switch to English

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 ⁨июль 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

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

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