glCopyColorSubTable(3G)	       OpenGL Reference	       glCopyColorSubTable(3G)

NAME    [Toc]    [Back]

     glCopyColorSubTable - respecify a portion of a color table

C SPECIFICATION    [Toc]    [Back]

     void glCopyColorSubTable( GLenum target,
			       GLsizei start,
			       GLint x,
			       GLint y,
			       GLsizei width )

PARAMETERS    [Toc]    [Back]

     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    [Toc]    [Back]

     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    [Toc]    [Back]

     glCopyColorSubTable is present only if GL_ARB_imaging is returned when
     glGetString is called with	an argument of GL_EXTENSIONS.

ERRORS    [Toc]    [Back]

     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.






									Page 1






glCopyColorSubTable(3G)	       OpenGL Reference	       glCopyColorSubTable(3G)

ASSOCIATED GETS    [Toc]    [Back]

     glGetColorTable, glGetColorTableParameter

SEE ALSO    [Toc]    [Back]

     glColorSubTable, glColorTableParameter, glCopyColorTable,
     glCopyColorSubTable, glGetColorTable


									PPPPaaaaggggeeee 2222