Función glDrawBuffer

  • Artículo

La función glDrawBuffer especifica en qué búferes de color se van a dibujar.

Sintaxis

void WINAPI glDrawBuffer(
   GLenum mode
);

Parámetros

mode

Especifica hasta cuatro búferes de color en los que se van a dibujar con las siguientes constantes simbólicas aceptables.

Value Significado
GL_NONE
 No se escribe ningún búfer de color.
GL_FRONT_LEFT
 Solo se escribe el búfer de color de la izquierda frontal.
GL_FRONT_RIGHT
 Solo se escribe el búfer de color frontal derecho.
GL_BACK_LEFT
 Solo se escribe el búfer de color back-left.
GL_BACK_RIGHT
 Solo se escribe el búfer de color de atrás a la derecha.
GL_FRONT
 Solo se escriben los búferes de color front-left y front-right. Si no hay ningún búfer de color front-right, solo se escribe el búfer de color izquierdo frontal.
GL_BACK
 Solo se escriben los búferes de color back-left y back-right. Si no hay ningún búfer de color de retroceso a la derecha, solo se escribe el búfer de color de reserva izquierda.
GL_LEFT
 Solo se escriben los búferes de color front-left y back-left. Si no hay ningún búfer de color atrás a la izquierda, solo se escribe el búfer de color front-left.
GL_RIGHT
 Solo se escriben los búferes de color de derecha derecha y derecha. Si no hay ningún búfer de color de retroceso a la derecha, solo se escribe el búfer de color de la parte frontal derecha.
GL_FRONT_AND_BACK
 Se escriben todos los búferes de color frontal y trasero (front-left, front-right, back-left, back-right). Si no hay búferes de color de reserva, solo se escriben los búferes de color front-left y front-right. Si no hay búferes de color derecho, solo se escriben los búferes de color front-left y back-left. Si no hay búferes de color derecho o trasero, solo se escribe el búfer de color frontal izquierdo.
GL_AUXi
 Sólo se escribe el búfer de color auxiliar i ; i está entre 0 y GL_AUX_BUFFERS - 1. (GL_AUX_BUFFERS no es el límite superior; use glGet para consultar el número de búferes auxiliares disponibles).

El valor predeterminado es GL_FRONT para contextos con búfer único y GL_BACK para contextos con búfer doble.

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 un valor aceptado.
GL_INVALID_OPERATION
 Ninguno de los búferes indicados por el modo existía.
GL_INVALID_OPERATION
 Se llamó a la función entre una llamada a glBegin y la llamada correspondiente a glEnd.

Comentarios

Cuando los colores se escriben en el búfer de fotogramas, se escriben en los búferes de color especificados por glDrawBuffer.

Si se selecciona más de un búfer de color para dibujar, la combinación o las operaciones lógicas se calculan y se aplican de forma independiente para cada búfer de color y pueden generar resultados diferentes en cada búfer.

Los contextos monoscópicos incluyen solo búferes izquierdos y contextos estereoscópicos incluyen búferes izquierdo y derecho. Del mismo modo, los contextos con un solo búfer incluyen solo búferes frontales y contextos de doble búfer incluyen búferes delanteros y traseros. El contexto se selecciona en la inicialización de OpenGL.

Siempre es el caso de que GL_AUX i = GL_AUX0 + i.

Las siguientes funciones recuperan información relacionada con la función glDrawBuffer :

glGet con GL_DRAW_BUFFER de argumentos

glGet con GL_AUX_BUFFERS 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

glBlendFunc

glColorMask

glEnd

glGet

glIndexMask

glLogicOp

glReadBuffer