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