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: Dieses Feature ist verfügbar in Web Workers.
Die WebGLRenderingContext.bindTexture()
-Methode der WebGL API bindet eine
gegebene WebGLTexture
an ein Ziel (Bindepunkt).
Syntax
bindTexture(target, texture)
Parameter
target
-
Ein
GLenum
, das den Bindepunkt (Ziel) angibt. Mögliche Werte:-
gl.TEXTURE_2D
: Eine zweidimensionale Textur. -
gl.TEXTURE_CUBE_MAP
: Eine würfelgemappte Textur. Bei Verwendung eines WebGL 2-Kontext sind zusätzlich folgende Werte verfügbar:gl.TEXTURE_3D
: Eine dreidimensionale Textur.gl.TEXTURE_2D_ARRAY
: Eine zweidimensionale Array-Textur.
-
texture
-
Ein
WebGLTexture
-Objekt, das gebunden werden soll.
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);
Aktuelle Bindungen abfragen
Um die aktuelle Texturbindung zu überprü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 |
Browser-Kompatibilität
BCD tables only load in the browser