WebGLRenderingContext.getTexParameter()

La méthode WebGLRenderingContext.getTexParameter() de l'API WebGL retourne des informations concernant la texture indiquée.

Syntaxe

js
quelconque gl.getTexParameter(cible, nomp);

Paramètres

cible

Un GLenum (en-US) indiquant le point de liaison (cible). Valeurs possibles :

  • gl.TEXTURE_2D : une texture bi-dimensionnelle.
  • gl.TEXTURE_CUBE_MAP : une texture appliquée à un cube.
  • Lorsqu' un WebGL 2 context est utilisé, les valeurs suivantes sont en outre disponibles :
    • gl.TEXTURE_3D : une texture tri-dimensionnelle.
    • gl.TEXTURE_2D_ARRAY : une texture bi-dimensionnelle en tableau.
nomp

Un Glenum (en-US) indiquant l'information à obtenir. Valeurs possibles :

nomp Type retourné Description Valeurs retournées possibles
Disponible dans un contexte WebGL 1
gl.TEXTURE_MAG_FILTER GLenum (en-US) Filtre de grossissement de texture gl.LINEAR (valeur par défaut), gl.NEAREST.
gl.TEXTURE_MIN_FILTER GLenum (en-US) Filtre de réduction de texture gl.LINEAR, gl.NEAREST, gl.NEAREST_MIPMAP_NEAREST, gl.LINEAR_MIPMAP_NEAREST, gl.NEAREST_MIPMAP_LINEAR (valeur par défaut), gl.LINEAR_MIPMAP_LINEAR.
gl.TEXTURE_WRAP_S GLenum (en-US) Fonction d'emballage pour la coordonnée de texture s gl.REPEAT (valeur par défaut), gl.CLAMP_TO_EDGE, gl.MIRRORED_REPEAT.
gl.TEXTURE_WRAP_T GLenum (en-US) Fonction d'emballage pour la coordonnée de texture t gl.REPEAT (valeur par défaut), gl.CLAMP_TO_EDGE, gl.MIRRORED_REPEAT.
Disponible en outre lorsque l'extension EXT_texture_filter_anisotropic (en-US) est utilisée
ext.TEXTURE_MAX_ANISOTROPY_EXT GLfloat (en-US) Anisotropie maximum pour une texture Toutes valeurs float.
Disponible en outre lorsqu'un contexte WebGL 2 est utilisé
gl.TEXTURE_BASE_LEVEL GLint (en-US) Niveau de mipmap de texture Toutes valeurs int.
gl.TEXTURE_COMPARE_FUNC GLenum (en-US) Fonction de comparaison gl.LEQUAL (valeurs par défaut), gl.GEQUAL, gl.LESS, gl.GREATER, gl.EQUAL, gl.NOTEQUAL, gl.ALWAYS, gl.NEVER.
gl.TEXTURE_COMPARE_MODE GLenum (en-US) Mode de comparaison de texture gl.NONE (valeur par défaut), gl.COMPARE_REF_TO_TEXTURE.
gl.TEXTURE_IMMUTABLE_FORMAT GLboolean (en-US) Immuabilité du format et de la taille de la texture true ou false.
gl.TEXTURE_IMMUTABLE_LEVELS GLuint (en-US) ? Toutes valeurs uint.
gl.TEXTURE_MAX_LEVEL GLint (en-US) Niveau maximum de mipmap de texture en tableau Toutes valeurs int.
gl.TEXTURE_MAX_LOD GLfloat (en-US) Valeur de niveau-de-détail maximum de texture Toutes valeurs float.
gl.TEXTURE_MIN_LOD GLfloat (en-US) Valeur de niveau-de-détail minimum de texture Toutes valeurs float.
gl.TEXTURE_WRAP_R GLenum (en-US) Fonction d'emballage pour la coordonnée de texture r gl.REPEAT (valeur par défaut), gl.CLAMP_TO_EDGE, gl.MIRRORED_REPEAT.

Valeur retournée

Retourne l'information de texture demandée (telle qu'indiquée par nomp). Si une erreur se produit, null est retourné.

Exemples

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

Spécifications

Specification
WebGL Specification
# 5.14.8
WebGL 2.0 Specification
# 3.7.6

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi