Función glReadBuffer

La función glReadBuffer selecciona un origen de búfer de color para píxeles.

Sintaxis

void WINAPI glReadBuffer(
   GLenum mode
);

Parámetros

mode

Un búfer de color. Los valores aceptados son GL_FRONT_LEFT, GL_FRONT_RIGHT, GL_BACK_LEFT, GL_BACK_RIGHT, GL_FRONT, GL_BACK, GL_LEFT, GL_RIGHT y GL_AUX i, donde i está entre 0 y GL_AUX_BUFFERS 1.

Valor devuelto

Esta función no devuelve ningún valor.

Códigos de error

La función glGetError puede recuperar los siguientes códigos de error.

Nombre	Significado
GL_INVALID_ENUM	mode no era uno de los doce (o más) valores aceptados.
GL_INVALID_OPERATION	el modo especificó un búfer que no existe.
GL_INVALID_OPERATION	Se llamó a la función entre una llamada a glBegin y la llamada correspondiente a glEnd.

Comentarios

La función glReadBuffer especifica un búfer de color como origen para los comandos glReadPixels y glCopyPixels posteriores. El parámetro mode acepta uno de los doce o más valores predefinidos. (GL_AUX0 a través de GL_AUX3 siempre se definen). En un sistema totalmente configurado, GL_FRONT, GL_LEFT y GL_FRONT_LEFT asigne un nombre al búfer de front-left, GL_FRONT_RIGHT y GL_RIGHT el nombre del búfer front-right y GL_BACK_LEFT y GL_BACK el búfer back-left.

Las configuraciones no almacenadas en búfer doble tienen solo un búfer de front-left y un búfer back-left. Las configuraciones de un solo búfer tienen un búfer de front-left y un búfer front-right si es estéreo, y solo un búfer de front-left si no es así. Es un error especificar un búfer inexistente en glReadBuffer.

De forma predeterminada, el modo se GL_FRONT en configuraciones de búfer único y GL_BACK en configuraciones de búfer doble.

La siguiente función recupera información relacionada con glReadBuffer:

glGet con GL_READ_BUFFER de argumentos

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Gl.h
Biblioteca	Opengl32.lib
Archivo DLL	Opengl32.dll

Consulte también

glBegin

glCopyPixels

glDrawBuffer

glEnd

glReadPixels