glPixelMapfv fonction)
La fonction glPixelMapfv définit les mappages de transfert de pixels.
Syntaxe
void WINAPI glPixelMapfv(
GLenum map,
GLsizei mapsize,
const GLfloat *values
);
Paramètres
-
map
-
Nom de mappage symbolique. Les dix cartes sont les suivantes.
Valeur Signification - _ _ carte de pixels _ GL _ i _
Cartes index de couleurs pour les index de couleurs. - _ _ cartes de pixels _ GL _ sur _ s
Cartes les index stencil aux index de stencil. - _ _ carte de pixels GL _ I _ à _ R
Cartes les index de couleurs aux composants red. - _ _ carte de pixels GL _ I _ à _ G
Cartes les index de couleurs aux composants verts. - _ _ carte de pixels GL _ I _ à _ B
Cartes les index de couleurs aux composants bleus. - _ _ carte de pixels GL _ I _ à _ A
Cartes les index de couleurs aux composants alpha. - _ _ carte de pixels GL _ r _ vers _ r
Cartes les composants red aux composants red. - _ _ carte de pixels GL _ g _ à _ g
Cartes les composants verts aux composants verts. - _ _ carte de pixels GL _ b _ à _ b
Cartes les composants bleus aux composants bleus. - _mappage de pixel GL _ _ a _ à _ un
Cartes composants alpha aux composants alpha. -
mapper
-
Taille de la carte en cours de définition.
-
valeurs
-
Tableau de valeurs de la valeur de Mapping .
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 |
|---|---|
|
le mappage n’est pas une valeur acceptée. |
|
la valeur de la taille de mappage était négative ou supérieure à celle de la _ table de mappage de pixels GL _ _ . |
|
Map était la _ _ carte de pixels GL _ i _ à _ i _ , _ les cartes de pixels GL _ s _ à _ s, les _ mappages de pixel GL _ _ i _ à _ R, _ les cartes de pixel GL _ _ i _ à _ G, _ _ la carte de pixels GL _ i _ à _ B, ou _ _ la carte de pixels GL _ i _ à _ a, et la correspondance n’était pas une puissance de deux. |
|
La fonction a été appelée entre un appel à glBegin et l’appel correspondant à glEnd. |
Notes
La fonction glPixelMap définit les tables de traduction, ou Maps, utilisées par glCopyPixels, glCopyTexImage1D, glCopyTexImage2D, glCopyTexSubImage1D, glCopyTexSubImage2D, glDrawPixels, glReadPixels, glTexImage1D, glTexImage2D, glTexSubImage1Det glTexSubImage2D. L’utilisation de ces mappages est décrite entièrement dans la rubrique glPixelTransfer , et en partie dans les rubriques relatives aux commandes de pixels et d’images de texture. Seule la spécification des mappages est décrite dans cette rubrique.
Le paramètre Map est un nom de mappage symbolique, indiquant l’un des dix mappages à définir. Le paramètre Mapping spécifie le nombre d’entrées dans le mappage, et les valeurs sont un pointeur vers un tableau de valeurs de mappage de mappage.
Les entrées d’un mappage peuvent être spécifiées sous la forme de nombres à virgule flottante simple précision, d’entiers courts non signés ou d’entiers longs non signés. Cartes qui stockent les valeurs de composant de couleur (toutes les cartes de _ pixels gl _ _ i _ à _ i et les _ _ cartes de pixels gl _ _ en _ s) conservent leurs valeurs dans un format à virgule flottante, avec la mantisse et les tailles 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 mappages, puis ancrées à la plage [ 0, 1 ] . Les valeurs entières non signées spécifiées par glPixelMapusv et glPixelMapuiv sont converties de manière linéaire de telle sorte que le plus grand entier pouvant être représenté est mappé à 1,0, et zéro est mappé à 0,0.
Cartes qui stockent des index, _ une carte de pixels gl _ _ i _ à _ i et _ _ une carte de pixels gl _ s _ à _ s, conservent leurs valeurs dans un format à virgule fixe, avec un nombre non spécifié de bits à droite du point binaire. Les valeurs à virgule flottante spécifiées par glPixelMapfv sont converties directement au format à virgule fixe interne de ces mappages. Les valeurs entières non signées spécifiées par glPixelMapusv et glPixelMapuiv spécifient des valeurs entières, avec des zéros à droite du point binaire.
Le tableau suivant indique les tailles et les valeurs initiales de chaque mappage. les Cartes indexés par les index de couleur ou de stencil doivent avoir la valeur mapping = 2 ^ n pour un nombre n ou les résultats ne sont pas définis. La taille maximale autorisée pour chaque mappage dépend de l’implémentation et peut être déterminée en appelant glGet à l’aide de la _ table de correspondance de pixels max. de l’argument GL _ _ _ . La valeur maximale unique s’applique à tous les mappages et est au moins égale à 32.
| Mappage | Index de recherche | Valeur de recherche | Taille initiale | Valeur initiale |
|---|---|---|---|---|
| _ _ carte de pixels _ GL _ i _ | index des couleurs | index des couleurs | 1 | 0.0 |
| _ _ cartes de pixels _ GL _ sur _ s | index de stencil | index de stencil | 1 | 0.0 |
| _ _ carte de pixels GL _ I _ à _ R | index des couleurs | R | 1 | 0.0 |
| _ _ carte de pixels GL _ I _ à _ G | index des couleurs | G | 1 | 0.0 |
| _ _ carte de pixels GL _ I _ à _ B | index des couleurs | B | 1 | 0.0 |
| _ _ carte de pixels GL _ I _ à _ A | index des couleurs | Un | 1 | 0.0 |
| _ _ carte de pixels GL _ r _ vers _ r | R | R | 1 | 0.0 |
| _ _ carte de pixels GL _ g _ à _ g | G | G | 1 | 0.0 |
| _ _ carte de pixels GL _ b _ à _ b | B | B | 1 | 0.0 |
| _mappage de pixel GL _ _ a _ à _ un | Un | A | 1 | 0.0 |
Les fonctions suivantes récupèrent les informations relatives à glPixelMap:
glGet avec arguments GL _ pixel _ Map _ i _ à _ i _ Size
glGet avec argument GL de _ correspondance des pixels _ _ _ en _ s _
glGet avec argument GL de _ mappage de pixel _ _ I _ à _ R _ taille
glGet avec argument GL de _ cartes de pixels _ _ I _ à _ G _ taille
glGet avec argument GL _ pixel _ Map _ I _ à _ B _ Size
glGet avec argument GL _ pixel _ Map _ I _ en _ _ taille
glGet avec argument GL de _ mappage de pixel _ _ r _ à _ _ taille r
glGet avec argument GL de _ mappage de pixel _ _ g _ à _ g _ taille
glGet avec argument GL _ pixel _ carte _ b _ à _ b _ taille
glGet avec argument GL _ pixel _ mapper _ a _ à _ une _ taille
glGet avec argument table de la _ carte de pixels max. GL _ _ _
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 |
|
| Bibliothèque |
|
| DLL |
|