glGetColorTableParameterivEXT, fonction
Les fonctions glGetColorTableParameterfvEXT et glGetColorTableParameterivEXT obtiennent les paramètres de palette des tables de couleurs.
Syntaxe
void WINAPI glGetColorTableParameterivEXT(
GLenum target,
GLenum pname,
GLint *params
);
Paramètres
-
cible
-
Texture cible de la palette pour laquelle vous souhaitez obtenir des données de paramètre. Doit être TEXTURE_1D, TEXTURE_2D, PROXY_TEXTURE_1D ou PROXY_TEXTURE_2D.
-
pname
-
Constante symbolique pour le type de données de paramètre de palette pointées vers params.
Voici les constantes symboliques acceptées et leur signification.
Valeur Signification - GL_COLOR_TABLE_FORMAT_EXT
Retourne le format interne spécifié par l’appel le plus récent à glColorTableEXT ou la valeur par défaut. - GL_COLOR_TABLE_WIDTH_EXT
Retourne la largeur de la palette active. - GL_COLOR_TABLE_RED_SIZE_EXT
Retourne la taille réelle utilisée en interne pour stocker le composant rouge des données de palette. - GL_COLOR_TABLE_GREEN_SIZE_EXT
Retourne la taille réelle utilisée en interne pour stocker le composant vert des données de palette. - GL_COLOR_TABLE_BLUE_SIZE_EXT
Retourne la taille réelle utilisée en interne pour stocker le composant bleu des données de palette. - GL_COLOR_TABLE_ALPHA_SIZE_EXT
Retourne la taille réelle utilisée en interne pour stocker le composant alpha des données de palette. -
params
-
Pointe vers les données de paramètre de table de couleurs spécifiées par le paramètre pname .
Valeur renvoyée
Cette fonction ne retourne pas de valeur.
Notes
Vous utilisez les fonctions glGetColorTableParameterivEXT et glGetColorTableParameterfvEXT pour récupérer des données de paramètres spécifiques à partir de tables de couleurs définies avec glColorTableEXT pour des palettes de textures ciblées. Vous pouvez également utiliser ces fonctions pour déterminer le nombre d’entrées de table de couleurs renvoyées par glGetColorTableEXT .
Lorsque le paramètre cible est GL_PROXY_TEXTURE_1D ou GL_PROXY_TEXTURE_2D et que l’implémentation ne prend pas en charge les valeurs spécifiées pour le format ou la largeur, glColorTableEXT peut ne pas créer la table de couleurs demandée. Dans ce cas, la table de couleurs est vide et tous les paramètres récupérés seront zéro. Vous pouvez déterminer si OpenGL prend en charge un format et une taille de table de couleurs particuliers en appelant glColorTableEXT avec une cible proxy, puis en appelant glGetColorTableParameterivEXT ou glGetColorTableParameterfvEXT pour déterminer si le paramètre width correspond à celui défini par glColorTableEXT. Si la largeur récupérée est égale à zéro, la demande de table de couleurs de glColorTable a échoué. Si la largeur récupérée n’est pas égale à zéro, vous pouvez appeler glColorTable avec la cible réelle avec TEXTURE_1D ou TEXTURE_2D pour définir la table de couleurs.
Les fonctions glGetColorTableParameterivEXT et glGetColorTableParameterfvEXT sont des fonctions d’extension qui ne font pas partie de la bibliothèque OpenGL standard, mais qui font partie de l’extension GL_EXT_paletted_texture. Pour case activée si votre implémentation d’OpenGL prend en charge glGetColorTableParameterivEXT et glGetColorTableParameterfvEXT, appelez glGetString(GL_EXTENSIONS). S’il retourne GL_EXT_paletted_texture, glGetColorTableParameterivEXT et glGetColorTableParameterfvEXT sont pris en charge. Pour obtenir l’adresse de fonction d’une fonction d’extension, appelez wglGetProcAddress.
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge |
Windows 2000 Server [applications de bureau uniquement] |
| En-tête |
|