WebGLRenderingContext: getTexParameter()-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.getTexParameter()-Methode der WebGL-API gibt Informationen über die angegebene Textur zurück.

Syntax

js
getTexParameter(target, pname)

Parameter

target

Ein GLenum, das den Bindungspunkt (target) angibt. Mögliche Werte:

  • gl.TEXTURE_2D: Eine zweidimensionale Textur.
  • gl.TEXTURE_CUBE_MAP: Eine Würfelmappen-Textur.

Bei Verwendung eines WebGL 2-Kontexts, sind zusätzlich die folgenden Werte verfügbar:

  • gl.TEXTURE_3D: Eine dreidimensionale Textur.
  • gl.TEXTURE_2D_ARRAY: Eine zweidimensionale Array-Textur.
pname

Ein GLenum, das die abzufragenden Informationen angibt. Mögliche Werte:

pname Rückgabewerttyp Beschreibung Mögliche Rückgabewerte
Verfügbar in einem WebGL 1-Kontext
gl.TEXTURE_MAG_FILTER [`GLenum`](/de/docs/Web/API/WebGL_API/Types) Texturvergrößerungsfilter gl.LINEAR (Standardwert), gl.NEAREST.
gl.TEXTURE_MIN_FILTER [`GLenum`](/de/docs/Web/API/WebGL_API/Types) Texturverkleinerungsfilter gl.LINEAR, gl.NEAREST, gl.NEAREST_MIPMAP_NEAREST, gl.LINEAR_MIPMAP_NEAREST, gl.NEAREST_MIPMAP_LINEAR (Standardwert), gl.LINEAR_MIPMAP_LINEAR.
gl.TEXTURE_WRAP_S [`GLenum`](/de/docs/Web/API/WebGL_API/Types) Wickelfunktion für Texturkoordinate s gl.REPEAT (Standardwert), gl.CLAMP_TO_EDGE, gl.MIRRORED_REPEAT.
gl.TEXTURE_WRAP_T [`GLenum`](/de/docs/Web/API/WebGL_API/Types) Wickelfunktion für Texturkoordinate t gl.REPEAT (Standardwert), gl.CLAMP_TO_EDGE, gl.MIRRORED_REPEAT.
Zusätzlich verfügbar bei Verwendung der [`EXT_texture_filter_anisotropic`](/de/docs/Web/API/EXT_texture_filter_anisotropic)-Erweiterung
ext.TEXTURE_MAX_ANISOTROPY_EXT [`GLfloat`](/de/docs/Web/API/WebGL_API/Types) Maximale Anisotropie für eine Textur Beliebige Float-Werte.
Zusätzlich verfügbar bei Nutzung eines WebGL 2-Kontexts
gl.TEXTURE_BASE_LEVEL [`GLint`](/de/docs/Web/API/WebGL_API/Types) Textur-Mipmap-Level Beliebige int-Werte.
gl.TEXTURE_COMPARE_FUNC [`GLenum`](/de/docs/Web/API/WebGL_API/Types) Vergleichsfunktion gl.LEQUAL (Standardwert), gl.GEQUAL, gl.LESS, gl.GREATER, gl.EQUAL, gl.NOTEQUAL, gl.ALWAYS, gl.NEVER.
gl.TEXTURE_COMPARE_MODE [`GLenum`](/de/docs/Web/API/WebGL_API/Types) Textur-Vergleichsmodus gl.NONE (Standardwert), gl.COMPARE_REF_TO_TEXTURE.
gl.TEXTURE_IMMUTABLE_FORMAT [`GLboolean`](/de/docs/Web/API/WebGL_API/Types) Unveränderlichkeit des Texturformats und der Größe true oder false.
gl.TEXTURE_IMMUTABLE_LEVELS [`GLuint`](/de/docs/Web/API/WebGL_API/Types) ? Beliebige uint-Werte.
gl.TEXTURE_MAX_LEVEL [`GLint`](/de/docs/Web/API/WebGL_API/Types) Maximales Textur-Mipmap-Array-Level Beliebige int-Werte.
gl.TEXTURE_MAX_LOD [`GLfloat`](/de/docs/Web/API/WebGL_API/Types) Maximaler Wert für die Textur-Detailstufe (Level-of-Detail) Beliebige Float-Werte.
gl.TEXTURE_MIN_LOD [`GLfloat`](/de/docs/Web/API/WebGL_API/Types) Minimaler Wert für die Textur-Detailstufe (Level-of-Detail) Beliebige Float-Werte.
gl.TEXTURE_WRAP_R [`GLenum`](/de/docs/Web/API/WebGL_API/Types) Wickelfunktion für Texturkoordinate r gl.REPEAT (Standardwert), gl.CLAMP_TO_EDGE, gl.MIRRORED_REPEAT.

Rückgabewert

Gibt die angeforderten Texturinformationen zurück (wie durch pname angegeben). Tritt ein Fehler auf, wird null zurückgegeben.

Beispiele

js
gl.getTexParameter(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER);

Spezifikationen

Specification
WebGL Specification
# 5.14.8
WebGL 2.0 Specification
# 3.7.6

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch