glCopyColorSubTable

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 orig-
       inally 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)