glCopyColorSubTable(3) glCopyColorSubTable(3)
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(3), glColorTableParameter(3), glCopyColorTable(3),
glCopyColorSubTable(3), glGetColorTable(3)
glCopyColorSubTable(3)
Mac OS X 10.6 - Generated Thu Sep 17 20:20:16 CDT 2009