fonction glGetColorTableParameterfvEXT

Article
06/13/2023

Les fonctions glGetColorTableParameterfvEXT et glGetColorTableParameterivEXT obtiennent les paramètres de palette des tables de couleurs.

Syntaxe

void WINAPI glGetColorTableParameterfvEXT(
   GLenum  target,
   GLenum  pname,
   GLfloat *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 par des paramètres.

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 actuelle.
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 la 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 les palettes de textures ciblées. Vous pouvez également utiliser ces fonctions pour déterminer le nombre d’entrées de table de couleurs retourné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 tableau 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 par 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	Gl.h

Voir aussi

glColorSubTableEXT
glColorTableEXT
glGetColorTableEXT
glGetColorTableParameterivEXT
wglGetProcAddress