GLCOPYCOLORSUBTABLE(3G) |
|
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(3G), glColorTableParameter(3G), glCopyColorTable(3G), glCopyColorSubTable(3G), glGetColorTable(3G)