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, glColorTableParameter, glCopyColorTable, glCopyColorSubTable, glGetColorTable