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 GLCOLORTABLE, GLPOSTCONVOLUTIONCOLORTABLE,
               or GLPOSTCOLORMATRIXCOLORTABLE.

       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 GLARBimaging is returned  when
       glGetString is called with an argument of GLEXTENSIONS.


ERORS
       GLINVALIDVALUE  is  generated  if  target is not a previously defined
       color table.

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

       GLINVALIDVALUE is generated if start ] x > width.

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

ASOCIATED GETS
       glGetColorTable, glGetColorTableParameter

SEE ALSO
       glColorSubTable,        glColorTableParameter,        glCopyColorTable,
       glCopyColorSubTable, glGetColorTable



                                                       GLCOPYCOLORSUBTABLE(3G)