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 (Bindepunkt).

Syntax

js
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

js
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.

js
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

Siehe auch