WebGLRenderingContext: activeTexture()-Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die WebGLRenderingContext.activeTexture()-Methode der
WebGL API legt fest, welche Textureinheit aktiv sein soll.
Syntax
activeTexture(texture)
Parameter
texture-
Die zu aktivierende Textureinheit. Der Wert ist ein
gl.TEXTUREI, wobei I im Bereich von 0 bisgl.MAX_COMBINED_TEXTURE_IMAGE_UNITS - 1liegt.
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.
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.
gl.getParameter(gl.MAX_COMBINED_TEXTURE_IMAGE_UNITS);
Um die aktive Textur abzurufen, fragen Sie die ACTIVE_TEXTURE-Konstante ab.
gl.activeTexture(gl.TEXTURE0);
gl.getParameter(gl.ACTIVE_TEXTURE);
// returns "33984" (0x84C0, gl.TEXTURE0 enum value)
Spezifikationen
| Spezifikation |
|---|
| WebGL Specification # 5.14.3 |