C SPECIFICATION

       void GLAPIENTRY glCopyColorSubTable( GLenum target,
                                            GLsizei star )

PARAMETERS

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

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

       _param3, _param4
               The  window coordinates of the left corner of the row of pixels
               to be copied.

       _param5 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  star to $"star"~+~_eqnparam3~-~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 $"star"~+~_eqnparam3~>~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