glPixelStoref fonction)
Définit les modes de stockage en pixels.
Syntaxe
void WINAPI glPixelStoref(
GLenum pname,
GLfloat param
);
Paramètres
-
pname
-
Nom symbolique du paramètre à définir. Six des paramètres de stockage affectent la manière dont les données de pixels sont retournées à la mémoire du client et ne sont donc significatives que pour les commandes glReadPixels . Les voici :
Stockage Paramètre Description _octets d’échange de packs GL _ _ Si la valeur est true, l’ordre des octets pour les composants de couleur multioctets, les composants de profondeur, les index de couleurs ou les index de gabarit est inversé. Autrement dit , si un composant de quatre octets est composé d’octets b 0, b 1, b 2, b 3, il est stocké en mémoire sous la forme b 3, b 2, b 1, b 0 si les octets d’échange de _ packs GL _ _ sont vrais. _Les octets d’échange de packs GL n' _ _ ont aucun effet sur l’ordre de mémoire des composants au sein d’un pixel, mais uniquement sur l’ordre des octets dans les composants ou les index. Par exemple, les trois composants d’un _ Pixel au format RGB du GL sont toujours stockés avec les troisièmes rouges, les secondes vertes et les tiers bleus, quelle que soit la valeur des octets de l' _ échange de packs GL _ _ . LSB du Pack GL en _ _ _ premier Si la valeur est true, les bits sont classés dans un octet du moins significatif au plus significatif. dans le cas contraire, le premier bit de chaque octet est le plus significatif. Ce paramètre est significatif pour les données bitmap uniquement. _longueur de _ ligne du Pack GL _ Si la valeur est supérieure à zéro, _ _ la longueur de ligne du Pack GL _ définit le nombre de pixels dans une ligne. Si le premier pixel d’une ligne est placé à l’emplacement p en mémoire, l’emplacement du premier pixel de la ligne suivante est obtenu en ignorant
[ composants de saut ] de ligne ou index, où n est le nombre de composants ou d’index dans un pixel, l est le nombre de pixels dans une ligne - ( - la longueur de ligne du Pack GL - si elle est supérieure à zéro, l’argument Width à la routine de pixel dans le cas contraire), a est la valeur de l' - alignement du Pack GL - , et s est la taille, en octets, d’un seul composant (si un < s = ). dans le cas de valeurs de 1 bit, l’emplacement de la ligne suivante est obtenu en ignorant 
composants ou index. Le mot composant dans cette description fait référence aux valeurs non indexées rouge, vert, bleu, alpha et profondeur. par exemple, la mise en forme de la Stockage de la comptabilité _ rvb est de trois composants par pixel : le premier rouge, le vert et le bleu final.Pack GL- _ _ Ignorer _ les pixels et
_ _ lignes ignorées du Pack GL _Ces valeurs sont fournies à titre de commodité au programmeur. elles ne fournissent aucune fonctionnalité qui ne peut pas être dupliquée simplement en incrémentant le pointeur transmis à glReadPixels. Le fait _ d' _ Ignorer _ les pixels du Pack GL revient à incrémenter le pointeur par i n composants ou index, où n est le nombre de composants ou d’index dans chaque pixel. La définition _ _ _ des lignes d’omission du Pack comptable à j équivaut à l’incrémentation du pointeur par des composants ou des index j k , où k est le nombre de composants ou d’index par ligne, tel que calculé ci-dessus dans la section de la _ longueur de ligne du Pack GL _ _ . _alignement du Pack GL _ Spécifie les exigences d’alignement pour le début de chaque ligne de pixel en mémoire. Les valeurs autorisées sont 1 (alignement sur les octets), 2 (lignes alignées sur octets pairs), 4 (alignement de mot) et 8 (les lignes commencent sur les limites d’un mot double). Les six autres paramètres de stockage affectent la manière dont les données de pixels sont lues à partir de la mémoire du client. Ces valeurs sont significatives pour glDrawPixels, glTexImage1D, glTexImage2D, glBitmapet glPolygonStipple. Les voici :
Stockage Paramètre Description _octets de swap de décompression GL _ _ Si la valeur est true, l’ordre des octets pour les composants de couleur multioctets, les composants de profondeur, les index de couleurs ou les index de gabarit est inversé. Autrement dit, si un composant de quatre octets est composé d’octets b 0, b 1, b 2 , b 3 , il est stocké en mémoire sous la forme b 3, b 2, b 1, b 0 si les octets d’échange de _ décompression GL _ _ sont vrais. _Le DÉcompresser _ les octets d’échange n' _ a aucun effet sur l’ordre de mémoire des composants au sein d’un pixel, mais uniquement sur l’ordre des octets dans les composants ou les index. Par exemple, les trois composants d’un _ Pixel au format RVB sont toujours stockés avec les troisièmes rouges, les secondes vertes et les tiers bleus, quelle que soit la valeur de la _ décompression des octets de l’échange GL _ _ . COMPTABILITÉ _ DÉcompresser _ LSB en _ premier Si la valeur est true, les bits sont classés dans un octet du moins significatif au plus significatif. dans le cas contraire, le premier bit de chaque octet est le plus significatif. Cela est important pour les données bitmap uniquement. _DÉcompresser _ la _ longueur de ligne Si la valeur est supérieure à zéro, _ _ la longueur de ligne décompressée _ par GL définit le nombre de pixels dans une ligne. Si le premier pixel d’une ligne est placé à l’emplacement p en mémoire, l’emplacement du premier pixel de la ligne suivante est obtenu en ignorant
[ composants de saut ] de ligne ou index, où n est le nombre de composants ou d’index dans un pixel, l est le nombre de pixels dans une ligne - ( - la longueur de ligne du Pack GL - si elle est supérieure à zéro, l’argument Width à la routine de pixel dans le cas contraire), a est la valeur de l' - alignement du Pack GL - , et s est la taille, en octets, d’un seul composant (si un < s = ). dans le cas de valeurs de 1 bit, l’emplacement de la ligne suivante est obtenu en ignorant 
composants ou index. Le mot composant dans cette description fait référence aux valeurs non indexées rouge, vert, bleu, alpha et profondeur. par exemple, la mise en forme de la Stockage de la comptabilité _ rvb est de trois composants par pixel : le premier rouge, le vert et le bleu final._DÉcompresser _ _ les pixels ignorés
_DÉcompresser _ les _ lignes ignoréesCes valeurs sont fournies à titre de commodité au programmeur. elles ne fournissent aucune fonctionnalité qui ne peut pas être dupliquée simplement en incrémentant le pointeur passé à glDrawPixels, glTexImage1D, glTexImage2D, glBitmapou glPolygonStipple. La définition de _ l’option DÉcompresser les pixels DÉcompressés _ _ est équivalente à l’incrémentation du pointeur par les composants ou les index i n , où n est le nombre de composants ou d’index de chaque pixel. La définition de _ l’option DÉcompresser _ _ les lignes de décompression à la valeur j équivaut à incrémenter le pointeur par des composants ou des index j k , où k est le nombre de composants ou d’index par ligne, comme indiqué ci-dessus dans la _ section « décompresser la longueur de ligne de décompression _ _ ». alignement de la _ décompression GL _ Spécifie les exigences d’alignement pour le début de chaque ligne de pixel en mémoire. Les valeurs autorisées sont 1 (alignement sur les octets), 2 (lignes alignées sur octets pairs), 4 (alignement de mot) et 8 (les lignes commencent sur les limites d’un mot double). -
param
-
Valeur définie pour l' pname .
Valeur renvoyée
Cette fonction ne retourne pas de valeur.
Notes
La fonction glPixelStore définit les modes de stockage en pixels qui affectent le fonctionnement des glDrawPixels et glReadPixels suivants, ainsi que la décompression des modèles de polygone stipple (consultez glPolygonStipple), des bitmaps (consultez GlBitmap) et des modèles de texture (consultez glTexImage1D, glTexImage2D, glTexSubImage1Det glTexSubImage2D).
Le tableau suivant indique le type, la valeur initiale et la plage de valeurs valides pour chacun des paramètres de stockage qui peuvent être définis avec glPixelStore.
| Pname | Type | Valeur initiale | Plage valide |
|---|---|---|---|
| _octets d’échange de packs GL _ _ | Booléen | false | True ou False |
| _octets d’échange de packs GL _ _ | Booléen | false | True ou False |
| _longueur de _ ligne du Pack GL _ | entier | 0 | [0, ?) |
| _ _ lignes ignorées du Pack GL _ | entier | 0 | [0, ?) |
| _Ignorer les _ _ pixels du Pack GL | entier | 0 | [0, ?) |
| _alignement du Pack GL _ | entier | 4 | 1, 2, 4 ou 8 |
| _octets de swap de décompression GL _ _ | Booléen | false | True ou False |
| COMPTABILITÉ _ DÉcompresser _ LSB en _ premier | Booléen | false | True ou False |
| _DÉcompresser _ la _ longueur de ligne | entier | 0 | [0, ?) |
| _DÉcompresser _ les _ lignes ignorées | entier | 0 | [0, ?) |
| _DÉcompresser _ les _ pixels ignorés | entier | 0 | [0, ?) |
| alignement de la _ décompression GL _ | entier | 4 | 1, 2, 4 ou 8 |
La fonction glPixelStoref peut être utilisée pour définir un paramètre de magasin de pixels. Si le type de paramètre est booléen et si param est 0,0, alors le paramètre a la valeur false ; Sinon, elle a la valeur true. Si pname est un paramètre de type entier, alors param est arrondi à l’entier le plus proche.
De même, la fonction glPixelStorei peut également être utilisée pour définir les paramètres du magasin de pixels. Les paramètres booléens ont la valeur false si param est 0 et true dans le cas contraire. Le paramètre param est converti en virgule flottante avant d’être assigné à des paramètres réels.
Les modes de stockage en pixels appliqués lorsque glDrawPixels, glReadPixels, glTexImage1D, glTexImage2D, glBitmapou glPolygonStipple est placé dans une liste d’affichage contrôlent l’interprétation des données de mémoire. Les modes de stockage en pixels en vigueur lors de l’exécution d’une liste d’affichage ne sont pas significatifs.
Les fonctions suivantes récupèrent les informations relatives à glPixelStore:
glGet avec argument _ Report GL _ _ octets swap
glGet avec argument GL _ Pack _ LSB en _ premier
glGet avec argument de _ la _ longueur de ligne du Pack GL _
glGet avec argument GL _ Pack _ Skip _ lignes
glGet avec argument GL _ Pack _ ignore les _ pixels
glGet avec argument de _ l' _ alignement GL Pack
glGet avec argument GL _ décompresser les _ octets d’échange _
glGet avec l’argument GL _ Unpack _ LSB _ First
glGet avec argument GL _ décompresser la _ longueur de ligne _
glGet avec argument GL _ décompresser les _ _ lignes
glGet avec argument GL _ décompresser _ Ignorer les _ pixels
glGet avec l’argument GL _ décompresser l' _ alignement
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 |
|