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 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(3G), glColorTableParameter(3G), glCopyColorTable(3G), glCopyColorSubTable(3G), glGetColorTable(3G)

															   GLCOPYCOLORSUBTABLE(3G)