glPixelMapuiv, fonction

La fonction glPixelMapuiv configure des mappages de transfert de pixels.

Syntaxe

void WINAPI glPixelMapuiv(
         GLenum  map,
         GLsizei mapsize,
   const GLuint  *values
);

Paramètres

map

Nom de carte symbolique. Les dix cartes sont les suivantes.

Valeur	Signification
GL_PIXEL_MAP_I_TO_I	Mappe les index de couleur aux index de couleur.
GL_PIXEL_MAP_S_TO_S	Mappe les index de gabarit aux index de gabarit.
GL_PIXEL_MAP_I_TO_R	Mappe les index de couleur aux composants rouges.
GL_PIXEL_MAP_I_TO_G	Mappe les index de couleur aux composants verts.
GL_PIXEL_MAP_I_TO_B	Mappe les index de couleur aux composants bleus.
GL_PIXEL_MAP_I_TO_A	Mappe les index de couleur aux composants alpha.
GL_PIXEL_MAP_R_TO_R	Mappe les composants rouges aux composants rouges.
GL_PIXEL_MAP_G_TO_G	Mappe les composants verts aux composants verts.
GL_PIXEL_MAP_B_TO_B	Mappe les composants bleus aux composants bleus.
GL_PIXEL_MAP_A_TO_A	Mappe les composants alpha aux composants alpha.

mapsize

Taille de la carte en cours de définition.

Valeurs

Tableau de valeurs mapize .

Valeur renvoyée

Cette fonction ne retourne pas de valeur.

Codes d’erreur

Les codes d’erreur suivants peuvent être récupérés par la fonction glGetError .

Notes

La fonction glPixelMap configure des tables de traduction, ou des cartes, utilisées par glCopyPixels, glCopyTexImage1D, glCopyTexImage2D, glCopyTexSubImage1D, glCopyTexSubImage2D, glDrawPixels, glReadPixels, glTexImage1D, glTexImage2D, glTexSubImage1D et glTexSubImage2D. L’utilisation de ces mappages est décrite entièrement dans la rubrique glPixelTransfer , et en partie dans les rubriques pour les commandes d’image de pixel et de texture. Seule la spécification des mappages est décrite dans cette rubrique.

Le paramètre de carte est un nom de carte symbolique, indiquant l’une des dix cartes à définir. Le paramètre mapsize spécifie le nombre d’entrées dans la carte, et les valeurs sont un pointeur vers un tableau de valeurs de mappage de mappage .

Les entrées d’une carte peuvent être spécifiées sous forme de nombres à virgule flottante simple précision, d’entiers courts non signés ou d’entiers longs non signés. Les cartes qui stockent les valeurs des composants de couleur (sauf GL_PIXEL_MAP_I_TO_I et GL_PIXEL_MAP_S_TO_S) conservent leurs valeurs au format à virgule flottante, avec des tailles de mantisse et d’exposant non spécifiées. Les valeurs à virgule flottante spécifiées par glPixelMapfv sont converties directement au format à virgule flottante interne de ces cartes, puis limitées à la plage [0,1]. Les valeurs entières non signées spécifiées par glPixelMapusv et glPixelMapuiv sont converties linéairement de sorte que le plus grand entier pouvant être représenté est mappé à 1,0 et zéro à 0,0.

Mappe qui stockent les index, les GL_PIXEL_MAP_I_TO_I et les GL_PIXEL_MAP_S_TO_S, conservent leurs valeurs au format à point fixe, avec un nombre de bits non spécifié à droite du point binaire. Les valeurs à virgule flottante spécifiées par glPixelMapfv sont converties directement en format à point fixe interne de ces cartes. Les valeurs entières non signées spécifiées par glPixelMapusv et glPixelMapuiv spécifient des valeurs entières, avec tous les zéros à droite du point binaire.

Le tableau suivant présente les tailles initiales et les valeurs de chacun des mappages. Les cartes indexées par des index de couleur ou de gabarit doivent avoir mapize = 2 ^ n pour certains n , sinon les résultats ne sont pas définis. La taille maximale autorisée pour chaque carte dépend de l’implémentation et peut être déterminée en appelant glGet avec l’argument GL_MAX_PIXEL_MAP_TABLE. La valeur maximale unique s’applique à toutes les cartes, et elle est d’au moins 32.

Les fonctions suivantes récupèrent des informations relatives à glPixelMap :

glGet avec argument GL_PIXEL_MAP_I_TO_I_SIZE

glGet avec argument GL_PIXEL_MAP_S_TO_S_SIZE

glGet avec argument GL_PIXEL_MAP_I_TO_R_SIZE

glGet avec argument GL_PIXEL_MAP_I_TO_G_SIZE

glGet avec argument GL_PIXEL_MAP_I_TO_B_SIZE

glGet avec argument GL_PIXEL_MAP_I_TO_A_SIZE

glGet avec GL_PIXEL_MAP_R_TO_R_SIZE d’argument

glGet avec argument GL_PIXEL_MAP_G_TO_G_SIZE

glGet avec GL_PIXEL_MAP_B_TO_B_SIZE d’argument

glGet avec argument GL_PIXEL_MAP_A_TO_A_SIZE

glGet avec argument GL_MAX_PIXEL_MAP_TABLE

Spécifications

Voir aussi

glBegin

glCopyPixels

glDrawPixels

glEnd

glPixelStore

glPixelTransfer

glReadPixels

glTexImage1D

glTexImage2D