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 Juli 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, der den Bindungspunkt (das Ziel) angibt. Mögliche Werte:gl.TEXTURE_2D-
Eine zweidimensionale Textur.
gl.TEXTURE_CUBE_MAP-
Eine Würfelkarten-Textur.
Bei Verwendung eines WebGL 2-Kontexts sind zusätzlich folgende Werte verfügbar:
gl.TEXTURE_3D-
Eine dreidimensionale Textur.
gl.TEXTURE_2D_ARRAY-
Eine zweidimensionale Array-Textur.
texture-
Ein
WebGLTextureObjekt, das gebunden werden soll. Wennnullübergeben wird, wird die derzeit gebundene Textur für das angegebene Ziel getrennt.
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
Binden einer Textur
const canvas = document.getElementById("canvas");
const gl = canvas.getContext("webgl");
const texture = gl.createTexture();
gl.bindTexture(gl.TEXTURE_2D, texture);
Trennen einer Textur
// Unbind any texture currently bound to TEXTURE_2D
gl.bindTexture(gl.TEXTURE_2D, null);
Abrufen der aktuellen Bindungen
Um die aktuelle Texturbindung zu überprüfen, fragen Sie die gl.TEXTURE_BINDING_2D oder
gl.TEXTURE_BINDING_CUBE_MAP Konstanten ab.
gl.getParameter(gl.TEXTURE_BINDING_2D);
Spezifikationen
| Specification |
|---|
| WebGL Specification # 5.14.8 |
| WebGL 2.0 Specification # 3.7.1 |
Browser-Kompatibilität
Loading…