GLCOPYCOLORSUBTABLE(3UNIX Programmer's ManGLCOPYCOLORSUBTABLE(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 por-
tion 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 sub-
texture 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
MirBSD #10-current Printed 2021-12-07 1
GLCOPYCOLORSUBTABLE(3UNIX Programmer's ManGLCOPYCOLORSUBTABLE(3G)
corresponding execution of glEnd.
ASSOCIATED GETS
glGetColorTable, glGetColorTableParameter
SEE ALSO
glColorSubTable(3G), glColorTableParameter(3G),
glCopyColorTable(3G), glCopyColorSubTable(3G),
glGetColorTable(3G)
MirBSD #10-current Printed 2021-12-07 2