Función glDrawBuffer
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 |
|---|---|
|
mode no era un valor aceptado. |
|
Ninguno de los búferes indicados por el modo existía. |
|
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 |
|
| Biblioteca |
|
| Archivo DLL |
|