GLCOPYCOLORSUBTABLE(3G)GLCOPYCOLORSUBTABLE(3G)NAMEglCopyColorSubTable - 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.
DESCRIPTIONglCopyColorSubTable 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.
NOTESglCopyColorSubTable 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 ALSOglColorSubTable(3G), glColorTableParameter(3G), glCopyColorTable(3G),
glCopyColorSubTable(3G), glGetColorTable(3G)
March 1, 2011
