fonction glReadBuffer
La fonction glReadBuffer sélectionne une source de mémoire tampon de couleur pour les pixels.
Syntaxe
void WINAPI glReadBuffer(
GLenum mode
);
Paramètres
-
mode
-
Mémoire tampon de couleurs. Les valeurs acceptées sont GL_FRONT_LEFT, GL_FRONT_RIGHT, GL_BACK_LEFT, GL_BACK_RIGHT, GL_FRONT, GL_BACK, GL_LEFT, GL_RIGHT et GL_AUX i, où i est compris entre 0 et GL_AUX_BUFFERS 1.
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 |
|---|---|
|
mode n’était pas l’une des douze valeurs (ou plus) acceptées. |
|
le mode a spécifié une mémoire tampon qui n’existe pas. |
|
La fonction a été appelée entre un appel à glBegin et l’appel à glEnd correspondant. |
Notes
La fonction glReadBuffer spécifie une mémoire tampon de couleur comme source pour les commandes glReadPixels et glCopyPixels suivantes. Le paramètre mode accepte l’une des douze valeurs prédéfinies ou plus. (GL_AUX0 via GL_AUX3 sont toujours définis.) Dans un système entièrement configuré, GL_FRONT, GL_LEFT et GL_FRONT_LEFT nomment tous la mémoire tampon avant gauche, GL_FRONT_RIGHT et GL_RIGHT nomment la mémoire tampon à droite, et GL_BACK_LEFT et GL_BACK nomment la mémoire tampon arrière-gauche.
Les configurations nonstereo à double mise en mémoire tampon n’ont qu’une mémoire tampon avant-gauche et arrière-gauche. Les configurations à mise en mémoire tampon unique ont une mémoire tampon avant gauche et une mémoire tampon avant droite si stéréo, et uniquement une mémoire tampon avant gauche si nonstereo. Il s’agit d’une erreur de spécifier une mémoire tampon inexistante sur glReadBuffer.
Par défaut, le mode est GL_FRONT dans les configurations à mise en mémoire tampon unique et GL_BACK dans les configurations à double mise en mémoire tampon.
La fonction suivante récupère les informations relatives à glReadBuffer :
glGet avec argument GL_READ_BUFFER
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 |
|