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
GL_INVALID_ENUM	mode n’était pas l’une des douze valeurs (ou plus) acceptées.
GL_INVALID_OPERATION	le mode a spécifié une mémoire tampon qui n’existe pas.
GL_INVALID_OPERATION	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	Gl.h
Bibliothèque	Opengl32.lib
DLL	Opengl32.dll

Voir aussi

glBegin

glCopyPixels

glDrawBuffer

glEnd

glReadPixels