glGetPixelMapuiv, fonction

Les fonctions glGetPixelMapfv, glGetPixelMapuiv et glGetPixelMapusv retournent la carte de pixels spécifiée.

Syntaxe

void WINAPI glGetPixelMapuiv(
   GLenum map,
   GLuint *values
);

Paramètres

map

Nom de la carte de pixels à retourner. Les valeurs acceptées sont GL_PIXEL_MAP_I_TO_I, GL_PIXEL_MAP_S_TO_S, GL_PIXEL_MAP_I_TO_R, GL_PIXEL_MAP_I_TO_G, GL_PIXEL_MAP_I_TO_B, GL_PIXEL_MAP_I_TO_A, GL_PIXEL_MAP_R_TO_R, GL_PIXEL_MAP_G_TO_G, GL_PIXEL_MAP_B_TO_B, et GL_PIXEL_MAP_A_TO_A.

Valeurs

Retourne le contenu de la carte de pixels.

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 .

Nom	Signification
GL_INVALID_ENUM	map n’était pas une valeur acceptée.
GL_INVALID_OPERATION	La fonction a été appelée entre un appel à glBegin et l’appel à glEnd correspondant.

Notes

Pour obtenir une description des valeurs acceptables pour le paramètre de carte, consultez glPixelMap. La fonction glGetPixelMap retourne en valeurs le contenu de la carte de pixels spécifiée dans la carte. Utilisez des mappages de pixels pendant l’exécution de glReadPixels, glDrawPixels, glCopyPixels, glTexImage1D et glTexImage2D pour mapper des index de couleur, des index de gabarit, des composants de couleur et des composants de profondeur à d’autres valeurs.

Les valeurs entières non signées, si demandées, sont mappées de manière linéaire à partir de la représentation interne fixe ou à virgule flottante, de sorte que 1.0 correspond à la plus grande valeur entière représentable et 0.0 à zéro. Les valeurs entières non signées de retour ne sont pas définies si la valeur de la carte n’était pas dans la plage [0,1].

Pour déterminer la taille requise de la carte, appelez glGet avec la constante symbolique appropriée.

Si une erreur est générée, aucune modification n’est apportée au contenu des valeurs.

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

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

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
Bibliothèque	Opengl32.lib
DLL	Opengl32.dll

Voir aussi

glBegin

glCopyPixels

glDrawPixels

glEnd

glGet

glPixelMap

glPixelTransfer

glReadPixels

glTexImage1D

glTexImage2D