WebGLRenderingContext: bindTexture()-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.bindTexture()-Methode der WebGL API bindet eine gegebene
WebGLTexture an ein Ziel (Bindungspunkt).
Syntax
bindTexture(target, texture)
Parameter
target-
Ein
GLenum, das den Bindungspunkt (Ziel) angibt. Mögliche Werte:-
gl.TEXTURE_2D: Eine zweidimensionale Textur. -
gl.TEXTURE_CUBE_MAP: Eine Würfelkarten-Textur. Beim Verwenden eines WebGL 2 Kontextes sind zusätzlich folgende Werte verfügbar:gl.TEXTURE_3D: Eine dreidimensionale Textur.gl.TEXTURE_2D_ARRAY: Eine Textur aus zweidimensionalen Arrays.
-
texture-
Ein
WebGLTexture-Objekt zum Binden. Wennnullübergeben wird, wird die aktuell gebundene Textur für das angegebene Ziel entbunden.
Rückgabewert
Keiner (undefined).
Ausnahmen
Ein gl.INVALID_ENUM Fehler wird ausgelöst, wenn target nicht
gl.TEXTURE_2D, gl.TEXTURE_CUBE_MAP,
gl.TEXTURE_3D oder gl.TEXTURE_2D_ARRAY ist.
Beispiele
Eine Textur binden
const canvas = document.getElementById("canvas");
const gl = canvas.getContext("webgl");
const texture = gl.createTexture();
gl.bindTexture(gl.TEXTURE_2D, texture);
Eine Textur entbinden
// Unbind any texture currently bound to TEXTURE_2D
gl.bindTexture(gl.TEXTURE_2D, null);
Aktuelle Bindungen abrufen
Um die aktuelle Texturbindung zu prüfen, fragen Sie die Konstanten gl.TEXTURE_BINDING_2D oder
gl.TEXTURE_BINDING_CUBE_MAP ab.
gl.getParameter(gl.TEXTURE_BINDING_2D);
Spezifikationen
| Specification |
|---|
| WebGL Specification # 5.14.8 |
| WebGL 2.0 Specification # 3.7.1 |