---

Manual Reference Pages  - GLCOLORSUBTABLE (3G)

---

glColorSubTable - respecify a portion of a color table

CONTENTS

C Specification
Parameters
Description
Notes
Errors
Associated Gets
See Also

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)

Jump to page    or go to Top of page |  Section 3G |  Main Index.