WebGLRenderingContext: Methode getTexParameter()

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.getTexParameter()-Methode der WebGL-API liefert Informationen über die angegebene Textur.

Syntax

getTexParameter(target, pname)

Parameter

target

Ein GLenum, der den Bindungspunkt (Ziel) spezifiziert. Mögliche Werte:

gl.TEXTURE_2D: Eine zweidimensionale Textur.
gl.TEXTURE_CUBE_MAP: Eine würfelgemappte Textur.

Beim Verwenden eines WebGL 2-Kontextes stehen zusätzlich folgende Werte zur Verfügung:

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

pname

Ein GLenum, das die zu abfragende Information spezifiziert. Mögliche Werte:

pname	Rückgabetyp	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 Verwendung eines WebGL 2-Kontextes
`gl.TEXTURE_BASE_LEVEL`	[`GLint`](/de/docs/Web/API/WebGL_API/Types)	Texture 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)	Texturvergleichsmodus	`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	wahr oder falsch.
`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)	Maximalwert der Textur-Detailstufe	Beliebige Float-Werte.
`gl.TEXTURE_MIN_LOD`	[`GLfloat`](/de/docs/Web/API/WebGL_API/Types)	Minimalwert der Textur-Detailstufe	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

Liefert die angeforderten Texturinformationen (wie mit pname angegeben). Falls ein Fehler auftritt, wird null zurückgegeben.

Beispiele

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

Spezifikationen

Specification
WebGL Specification # 5.14.8
WebGL 2.0 Specification # 3.7.6