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

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 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 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 Filtre de grossissement de texture gl.LINEAR (valeur par défaut), gl.NEAREST.
gl.TEXTURE_MIN_FILTER GLenum 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 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 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 est utilisée
ext.TEXTURE_MAX_ANISOTROPY_EXT GLfloat Anisotropie maximum pour une texture Toutes valeurs float.
Disponible en outre lorsqu'un contexte WebGL 2 est utilisé
gl.TEXTURE_BASE_LEVEL GLint Niveau de mipmap de texture Toutes valeurs int.
gl.TEXTURE_COMPARE_FUNC GLenum 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 Mode de comparaison de texture gl.NONE (valeur par défaut), gl.COMPARE_REF_TO_TEXTURE.
gl.TEXTURE_IMMUTABLE_FORMAT GLboolean Immuabilité du format et de la taille de la texture true ou false.
gl.TEXTURE_IMMUTABLE_LEVELS GLuint ? Toutes valeurs uint.
gl.TEXTURE_MAX_LEVEL GLint Niveau maximum de mipmap de texture en tableau Toutes valeurs int.
gl.TEXTURE_MAX_LOD GLfloat Valeur de niveau-de-détail maximum de texture Toutes valeurs float.
gl.TEXTURE_MIN_LOD GLfloat Valeur de niveau-de-détail minimum de texture Toutes valeurs float.
gl.TEXTURE_WRAP_R GLenum 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