WebGLRenderingContext: texParameter[fi]() Methode

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die WebGLRenderingContext.texParameter[fi]() Methoden der WebGL API setzen Textureinstellungen.

Syntax

js
texParameterf(target, pname, param)
texParameteri(target, pname, param)

Parameter

target

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

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

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

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

Der param-Parameter ist ein GLfloat oder GLint, der den Wert für den angegebenen Parameter angibt.

pname

Der pname-Parameter ist ein GLenum, der angibt, welcher Textureparameter gesetzt werden soll.

pname Beschreibung param
Verfügbar in WebGL 1
gl.TEXTURE_MAG_FILTER Textur-Magnifikationsfilter gl.LINEAR (Standardwert), gl.NEAREST.
gl.TEXTURE_MIN_FILTER Textur-Minifikationsfilter 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 Wicklungsfunktion für Texturkoordinate s gl.REPEAT (Standardwert), gl.CLAMP_TO_EDGE, gl.MIRRORED_REPEAT.
gl.TEXTURE_WRAP_T Wicklungsfunktion 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 Maximale Anisotropie für eine Textur Ein [`GLfloat`](/de/docs/Web/API/WebGL_API/Types) Wert.
Zusätzlich verfügbar bei Verwendung eines WebGL 2-Kontexts
gl.TEXTURE_BASE_LEVEL Textur-Mipmap-Level Beliebige Ganzzahlen.
gl.TEXTURE_COMPARE_FUNC Textur-Vergleichsfunktion gl.LEQUAL (Standardwert), gl.GEQUAL, gl.LESS, gl.GREATER, gl.EQUAL, gl.NOTEQUAL, gl.ALWAYS, gl.NEVER.
gl.TEXTURE_COMPARE_MODE Textur-Vergleichsmodus gl.NONE (Standardwert), gl.COMPARE_REF_TO_TEXTURE.
gl.TEXTURE_MAX_LEVEL Maximale Textur-Mipmap-Array-Ebene Beliebige Ganzzahlen.
gl.TEXTURE_MAX_LOD Maximaler Level-of-Detail-Wert der Textur Beliebige Gleitkommazahlen.
gl.TEXTURE_MIN_LOD Minimaler Level-of-Detail-Wert der Textur Beliebige Gleitkommazahlen.
gl.TEXTURE_WRAP_R Wicklungsfunktion für Texturkoordinate r gl.REPEAT (Standardwert), gl.CLAMP_TO_EDGE, gl.MIRRORED_REPEAT.

Rückgabewert

Keiner (undefined).

Beispiele

js
gl.texParameterf(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.LINEAR);
gl.texParameteri(
  gl.TEXTURE_2D,
  gl.TEXTURE_MIN_FILTER,
  gl.LINEAR_MIPMAP_NEAREST,
);

Spezifikationen

Specification
WebGL Specification
# 5.14.8
WebGL 2.0 Specification
# 3.7.6

Browser-Kompatibilität

api.WebGLRenderingContext.texParameterf

api.WebGLRenderingContext.texParameteri

Siehe auch