This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

GLCOPYCOLORSUBTABLE(3G)                                                              GLCOPYCOLORSUBTABLE(3G)



NAME
       glCopyColorSubTable - respecify a portion of a color table


C SPECIFICATION
       void glCopyColorSubTable( GLenum target,
                                 GLsizei start,
                                 GLint x,
                                 GLint y,
                                 GLsizei width )


PARAMETERS
       target  Must      be      one      of     GL_COLOR_TABLE,     GL_POST_CONVOLUTION_COLOR_TABLE,     or
               GL_POST_COLOR_MATRIX_COLOR_TABLE.

       start   The starting index of the portion of the color table to be replaced.

       x, y    The window coordinates of the left corner of the row of pixels to be copied.

       width   The number of table entries to replace.

DESCRIPTION
       glCopyColorSubTable is used to respecify a contiguous portion of a  color  table  previously  defined
       using glColorTable.  The pixels copied from the framebuffer replace the portion of the existing table
       from indices start to start + x - 1, inclusive.  This region may not include any entries outside  the
       range  of  the  color table, as was originally specified.  It is not an error to specify a subtexture
       with width of 0, but such a specification has no effect.

NOTES
       glCopyColorSubTable is present only if GL_ARB_imaging is returned when glGetString is called with  an
       argument of GL_EXTENSIONS.


ERRORS
       GL_INVALID_VALUE is generated if target is not a previously defined color table.

       GL_INVALID_VALUE is generated if target is not one of the allowable values.

       GL_INVALID_VALUE is generated if start + x > width.

       GL_INVALID_OPERATION is generated if glCopyColorSubTable is executed between the execution of glBegin
       and the corresponding execution of glEnd.

ASSOCIATED GETS
       glGetColorTable, glGetColorTableParameter

SEE ALSO
       glColorSubTable(3G), glColorTableParameter(3G), glCopyColorTable(3G), glCopyColorSubTable(3G), glGetColorTable(3G)




                                                                                     GLCOPYCOLORSUBTABLE(3G)