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, glColorTableParameter, glCopyColorTable,
     glCopyColorSubTable, glGetColorTable