WebGLRenderingContext: метод activeTexture()

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

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

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

Метод WebGLRenderingContext.activeTexture() API WebGL указывает, какой текстурный блок сделать активным.

Синтаксис

activeTexture(texture)

Параметры

texture: Текстурный блок, который нужно сделать активным. Значение является gl.TEXTUREI, где I находится в диапазоне от 0 до gl.MAX_COMBINED_TEXTURE_IMAGE_UNITS - 1.

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

Ничего (undefined).

Исключения

Если texture не является одним из gl.TEXTUREI, где I находится в диапазоне от 0 до gl.MAX_COMBINED_TEXTURE_IMAGE_UNITS - 1, выбрасывается ошибка gl.INVALID_ENUM.

Примеры

Следующий вызов выбирает gl.TEXTURE1 в качестве текущей текстуры. Последующие вызовы, изменяющие состояние текстуры, будут влиять на эту текстуру.

gl.activeTexture(gl.TEXTURE1);

Количество текстурных блоков зависит от реализации; вы можете получить это число с помощью константы MAX_COMBINED_TEXTURE_IMAGE_UNITS. По спецификации, оно не меньше 8.

gl.getParameter(gl.MAX_COMBINED_TEXTURE_IMAGE_UNITS);

Чтобы получить активную текстуру, запросите константу ACTIVE_TEXTURE.

gl.activeTexture(gl.TEXTURE0);
gl.getParameter(gl.ACTIVE_TEXTURE);
// returns "33984" (0x84C0, gl.TEXTURE0 enum value)

Спецификации

Спецификация
Спецификация WebGL # 5.14.3

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

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

См. также

WebGLRenderingContext.getParameter()

© 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/activeTexture