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: Dieses Feature ist verfügbar in Web Workers.

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

BCD tables only load in the browser

Siehe auch