WebGLRenderingContext: метод bindTexture()

Базовая поддержка Широко распространена

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна во всех браузерах с июля 2015 года.

Примечание: Эта функция доступна в Web Workers.

Метод WebGLRenderingContext.bindTexture() API WebGL связывает заданную WebGLTexture с целевым объектом (точной точкой привязки).

Синтаксис

bindTexture(target, texture)

Параметры

target

GLenum, указывающий точку привязки (цель). Возможные значения:

gl.TEXTURE_2D: Двумерная текстура.
gl.TEXTURE_CUBE_MAP: Текстура с кубовыми картами. При использовании контекста WebGL 2, дополнительно доступны следующие значения:
- gl.TEXTURE_3D: Трехмерная текстура.
- gl.TEXTURE_2D_ARRAY: Двумерная массив-текстура.

texture

Объект WebGLTexture для привязки.

Возвращаемое значение

Ничего (undefined).

Исключения

Бросается ошибка gl.INVALID_ENUM, если target не является gl.TEXTURE_2D, gl.TEXTURE_CUBE_MAP, gl.TEXTURE_3D, или gl.TEXTURE_2D_ARRAY.

Примеры

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

const canvas = document.getElementById("canvas");
const gl = canvas.getContext("webgl");
const 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 # 5.14.8
Спецификация WebGL 2.0 # 3.7.1

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

	Рабочие столы					Мобильные
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`bindTexture`	9	12	4	12	5.1	25	4	12	8	1.5	4.4.3

См. также

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/WebGLRenderingContext/bindTexture