summaryrefslogtreecommitdiff
path: root/src/mesa/main
diff options
context:
space:
mode:
authorBrian Paul <brian.paul@tungstengraphics.com>2005-08-31 21:38:53 +0000
committerBrian Paul <brian.paul@tungstengraphics.com>2005-08-31 21:38:53 +0000
commit527835977a3f22d7a01f8d835d73ced5b13d0991 (patch)
treeeb3270737249c90b1756d0550f795c77b11d1f73 /src/mesa/main
parent36603539ccdb1c507724d8a1c314e6c9cc9863d9 (diff)
Just additional comments.
Diffstat (limited to 'src/mesa/main')
-rw-r--r--src/mesa/main/buffers.c13
-rw-r--r--src/mesa/main/framebuffer.c7
2 files changed, 20 insertions, 0 deletions
diff --git a/src/mesa/main/buffers.c b/src/mesa/main/buffers.c
index 2be0fba430..7eafaf88fc 100644
--- a/src/mesa/main/buffers.c
+++ b/src/mesa/main/buffers.c
@@ -433,6 +433,11 @@ _mesa_DrawBuffersARB(GLsizei n, const GLenum *buffers)
* output, but fragment programs can now have several distinct color
* outputs (see GL_ARB_draw_buffers). This function sets the state
* for one such color output.
+ * \param ctx current context
+ * \param output which fragment program output
+ * \param buffer buffer to write to (like GL_LEFT)
+ * \param destMask BUFFER_* bitmask
+ * (like BUFFER_BIT_FRONT_LEFT | BUFFER_BIT_BACK_LEFT).
*/
static void
set_color_output(GLcontext *ctx, GLuint output, GLenum buffer, GLuint destMask)
@@ -457,6 +462,14 @@ set_color_output(GLcontext *ctx, GLuint output, GLenum buffer, GLuint destMask)
/**
* Helper routine used by _mesa_DrawBuffer, _mesa_DrawBuffersARB and
* _mesa_PopAttrib to set drawbuffer state.
+ * All error checking will have been done prior to calling this function
+ * so nothing should go wrong at this point.
+ * \param ctx current context
+ * \param n number of color outputs to set
+ * \param buffers array[n] of colorbuffer names, like GL_LEFT.
+ * \param destMask array[n] of BUFFER_* bitmasks which correspond to the
+ * colorbuffer names. (i.e. GL_FRONT_AND_BACK =>
+ * BUFFER_BIT_FRONT_LEFT | BUFFER_BIT_BACK_LEFT).
*/
void
_mesa_drawbuffers(GLcontext *ctx, GLsizei n, const GLenum *buffers,
diff --git a/src/mesa/main/framebuffer.c b/src/mesa/main/framebuffer.c
index c23c60948c..271790c1ca 100644
--- a/src/mesa/main/framebuffer.c
+++ b/src/mesa/main/framebuffer.c
@@ -460,7 +460,14 @@ get_renderbuffer(struct gl_framebuffer *fb, GLuint bufferBit)
/**
* Update state related to the current draw/read framebuffers.
+ * Specifically, update these framebuffer fields:
+ * _ColorDrawBuffers
+ * _ColorDrawBit
+ * _NumColorDrawBuffers
+ * _ColorReadBuffer
* If the current framebuffer is user-created, make sure it's complete.
+ * The following functions can effect this state: glReadBuffer,
+ * glDrawBuffer, glDrawBuffersARB, glFramebufferRenderbufferEXT.
*/
void
_mesa_update_framebuffer(GLcontext *ctx)