Partager via


glReadBuffer, fonction

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 couleur. 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 retourné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 Sens
GL_INVALID_ENUM
le mode n’était pas l’une des douze valeurs acceptées (ou plus).
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 correspondant à glEnd.

Remarques

La fonction glReadBuffer spécifie une mémoire tampon de couleur comme source pour les commandes glReadPixels et glCopyPixels suivantes. Le paramètre de mode accepte une ou plusieurs valeurs prédéfinies. (GL_AUX0 via GL_AUX3 sont toujours définis.) Dans un système entièrement configuré, GL_FRONT, GL_LEFT et GL_FRONT_LEFT tous les noms de la mémoire tampon frontale gauche, GL_FRONT_RIGHT et GL_RIGHT nommez la mémoire tampon frontale droite, et GL_BACK_LEFT et GL_BACK nommez la mémoire tampon arrière gauche.

Les configurations nonstereo à double mémoire tampon n’ont qu’une mémoire tampon frontale gauche et une mémoire tampon back-left. Les configurations à mémoire tampon unique ont une mémoire tampon front-left et une mémoire tampon avant droite si stéréo, et uniquement une mémoire tampon front-left si nonstereo. Il s’agit d’une erreur de spécification d’une mémoire tampon inexistante sur glReadBuffer.

Par défaut, le mode est GL_FRONT dans les configurations à mémoire tampon unique et GL_BACK dans les configurations à double mémoire tampon.

La fonction suivante récupère les informations relatives à glReadBuffer :

glGet avec l’argument GL_READ_BUFFER

Spécifications

Besoin Valeur
Client minimum pris en charge
Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimum pris en charge
Windows 2000 Server [applications de bureau uniquement]
En-tête de page
Gl.h
Bibliothèque
Opengl32.lib
DLL
Opengl32.dll

Voir aussi

glBegin

glCopyPixels

glDrawBuffer

glEnd

glReadPixels