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