WebGLRenderingContext: activeTexture()-Methode

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.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die WebGLRenderingContext.activeTexture()-Methode der WebGL API legt fest, welche Textureinheit aktiv sein soll.

Syntax

js
activeTexture(texture)

Parameter

texture

Die zu aktivierende Textureinheit. Der Wert ist ein gl.TEXTUREI, wobei I im Bereich von 0 bis gl.MAX_COMBINED_TEXTURE_IMAGE_UNITS - 1 liegt.

Rückgabewert

Keiner (undefined).

Ausnahmen

Wenn texture nicht eines von gl.TEXTUREI ist, wobei I im Bereich von 0 bis gl.MAX_COMBINED_TEXTURE_IMAGE_UNITS - 1 liegt, wird ein gl.INVALID_ENUM-Fehler ausgelöst.

Beispiele

Der folgende Aufruf wählt gl.TEXTURE1 als aktuelle Textur aus. Nachfolgende Aufrufe, die den Texturzustand ändern, wirken sich auf diese Textur aus.

js
gl.activeTexture(gl.TEXTURE1);

Die Anzahl der Textureinheiten ist implementierungsabhängig; Sie können diese Anzahl mit Hilfe der MAX_COMBINED_TEXTURE_IMAGE_UNITS-Konstante ermitteln. Sie beträgt gemäß Spezifikation mindestens 8.

js
gl.getParameter(gl.MAX_COMBINED_TEXTURE_IMAGE_UNITS);

Um die aktive Textur abzurufen, fragen Sie die ACTIVE_TEXTURE-Konstante ab.

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

Spezifikationen

Specification
WebGL Specification
# 5.14.3

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
activeTexture

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch