*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> glReadBuffer (3)              



NAME    [Toc]    [Back]

       glReadBuffer - select a color buffer source for pixels

SYNOPSIS    [Toc]    [Back]

       void glReadBuffer(
               GLenum mode );

PARAMETERS    [Toc]    [Back]

       Specifies    a   color   buffer.   Accepted   values   are
       GL_AUXi, where i is between 0 and GL_AUX_BUFFERS -1.

DESCRIPTION    [Toc]    [Back]

       glReadBuffer() specifies a color buffer as the source  for
       subsequent  glReadPixels(), glCopyTexImage1D(), glCopyTexImage2D(),
  glCopyTexSubImage1D(),  glCopyTexSubImage2D(),
       glCopyTexSubImage3D(),  and glCopyPixels() commands.  mode
       accepts one of twelve or more predefined values.  (GL_AUX0
       through  GL_AUX3  are always defined.)  In a fully configured
 system, GL_FRONT, GL_LEFT, and GL_FRONT_LEFT all name
       the  front  left  buffer, GL_FRONT_RIGHT and GL_RIGHT name
       the front right buffer, and GL_BACK_LEFT and GL_BACK  name
       the back left buffer.

       Nonstereo double-buffered configurations have only a front
       left and a back left  buffer.  Single-buffered  configurations
  have  a  front  left  and  a  front right buffer if
       stereo, and only a front left buffer if nonstereo.  It  is
       an  error  to  specify  a  nonexistent  buffer  to glReadBuffer().

       mode is initially GL_FRONT in  single-buffered  configurations,
 and GL_BACK in double-buffered configurations.

ERRORS    [Toc]    [Back]

       GL_INVALID_ENUM  is  generated  if  mode is not one of the
       twelve (or more) accepted values.

       GL_INVALID_OPERATION is  generated  if  mode  specifies  a
       buffer that does not exist.

       GL_INVALID_OPERATION  is  generated  if  glReadBuffer() is
       executed between the execution of glBegin() and the corresponding
 execution of glEnd().

ASSOCIATED GETS    [Toc]    [Back]

       glGet() with argument GL_READ_BUFFER

SEE ALSO    [Toc]    [Back]

       glCopyPixels(3), glCopyTexImage1D(3), glCopyTexImage2D(3),
       glCopyTexSubImage1D(3), glCopyTexSubImage2D(3), glCopyTexSubImage3D(3), glDrawBuffer(3), glReadPixels(3)

[ Back ]
 Similar pages
Name OS Title
readcomponent IRIX sets the component source within the framebuffer source for pixels that various routines read, useful primaril
readsource IRIX sets the source for pixels that various routines read
glcopycolortable IRIX copy pixels into a color table
glcopycolortablesgi IRIX copy pixels into a color table
glcopypixels IRIX copy pixels in the frame buffer
glCopyPixels Tru64 copy pixels in the frame buffer
glDrawPixels Tru64 write a block of pixels to the frame buffer
glReadPixels Tru64 read a block of pixels from the frame buffer
glreadpixels IRIX read a block of pixels from the frame buffer
gldrawpixels IRIX write a block of pixels to the frame buffer
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service