Table of Contents
glColorSubTable - respecify a portion of a color table 
 
void
glColorSubTable( GLenum target, 
    GLsizei start,
    GLsizei count,
    GLenum format,
    GLenum type,
    const GLvoid *data )
 
- 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. 
- count 
- The number of table entries to
replace. 
- format 
- The  of the pixel data in data. The allowable values are
GL_RED, GL_GREEN, GL_BLUE, GL_ALPHA, GL_LUMINANCE, GL_LUMINANCE_ALPHA,
GL_RGB, GL_BGR, GL_RGBA, and GL_BGRA. 
- type 
- The type of the pixel data in
data. The allowable values are GL_UNSIGNED_BYTE, GL_BYTE, GL_UNSIGNED_SHORT,
GL_SHORT, GL_UNSIGNED_INT, GL_INT, GL_FLOAT, GL_UNSIGNED_BYTE_3_3_2, GL_UNSIGNED_BYTE_2_3_3_REV,
GL_UNSIGNED_SHORT_5_6_5, GL_UNSIGNED_SHORT_5_6_5_REV, GL_UNSIGNED_SHORT_4_4_4_4,
GL_UNSIGNED_SHORT_4_4_4_4_REV, GL_UNSIGNED_SHORT_5_5_5_1, GL_UNSIGNED_SHORT_1_5_5_5_REV,
GL_UNSIGNED_INT_8_8_8_8, GL_UNSIGNED_INT_8_8_8_8_REV, GL_UNSIGNED_INT_10_10_10_2,
and GL_UNSIGNED_INT_2_10_10_10_REV. 
- data 
- Pointer to a one-dimensional array
of pixel data that is processed to replace the specified region of the
color table. 
glColorSubTable is used to respecify a contiguous
portion of a color table previously defined using glColorTable.  The pixels
referenced by data replace the portion of the existing table from indices
start to $"start"~+~"count"~-~1$, inclusive.  This region may not include
any entries outside the range of the color table as it was originally specified.
It is not an error to specify a subtexture with width of 0, but such a
specification has no effect. 
glColorSubTable is present only if GL_ARB_imaging
is returned when glGetString is called with an argument of GL_EXTENSIONS.
GL_INVALID_ENUM is generated if target is not one of the allowable
values. 
GL_INVALID_VALUE is generated if $"start"~+~"count"~>~width$. 
GL_INVALID_ENUM
is generated if format is not one of the allowable values. 
GL_INVALID_ENUM
is generated if type is not one of the allowable values. 
GL_INVALID_OPERATION
is generated if glColorSubTable is executed between the execution of glBegin
and the corresponding execution of glEnd. 
glGetColorTable,
glGetColorTableParameter 
glColorSubTable(3G)
, glColorTableParameter(3G)
,
glCopyColorTable(3G)
, glCopyColorSubTable(3G)
, glGetColorTable(3G)
 
Table of Contents