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.
