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

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

BCD tables only load in the browser

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