glColorSubTableEXT

NAME

glColorSubTableEXT - define a portion of a color lookup table

C SPECIFICATION

void glColorSubTableEXT(GLenum target,
                        GLsizei start,
                        GLsizei count,
                        GLenum format,
                        GLenum type,
                        const GLvoid *table)

PARAMETERS

target	Must be one of the following: GL_COLOR_TABLE_EXT, GL_POST_CONVOLUTION_COLOR_TABLE_EXT, GL_POST_COLOR_MATRIX_COLOR_TABLE_EXT, or GL_TEXTURE_COLOR_TABLE_EXT.
start	The index of the first entry in the table to load. start must be nonnegative.
count	The number of entries in the table to load. start + count must not be greater than the width of the color table.
format	The format of the pixel data. The allowable values are GL_RED, GL_GREEN, GL_BLUE, GL_ALPHA, GL_LUMINANCE, GL_LUMINANCE_ALPHA, GL_RGB, GL_RGBA, GL_BGR_EXT, GL_BGRA_EXT, GL_422_EXT, GL_422_REV_EXT, GL_422_AVERAGE_EXT, and GL_422_REV_AVERAGE_EXT.
type	Specifies the data type for pixel 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_EXT, GL_UNSIGNED_BYTE_2_3_3_REV_EXT, GL_UNSIGNED_SHORT_5_6_5_EXT, GL_UNSIGNED_SHORT_5_6_5_REV_EXT, GL_UNSIGNED_SHORT_4_4_4_4_EXT, GL_UNSIGNED_SHORT_4_4_4_4_REV_EXT, GL_UNSIGNED_SHORT_5_5_5_1_EXT, GL_UNSIGNED_SHORT_1_5_5_5_REV_EXT, GL_UNSIGNED_INT_8_8_8_8_EXT, GL_UNSIGNED_INT_8_8_8_8_REV_EXT, GL_UNSIGNED_INT_10_10_10_2_EXT, and GL_UNSIGNED_INT_2_10_10_10_REV_EXT.
table	Pointer to a onedimensional array of pixel data that is processed to replace the specified region of the existing color table.

DESCRIPTION

glColorSubTableEXT is used to replace a portion of a previously defined color lookup table. Entries in the range [start,start + count - 1] are replaced. This region may not include any entries outside the range of the color table as it was originally specified. The pixel array specified by format, type, and table is extracted from memory and processed just as if glColorTableEXT were called. No change is made to the internal format or the width of the color table.

EXTENSIONS

Some routines and constants for this function are part of an extension, not part of the core GL command set. The following extension names must be present in the string returned by glGetString when called with argument GL_EXTENSIONS to use these routines and constants.

GL_EXT_422_pixels: GL_422_EXT, GL_422_REV_EXT, GL_422_AVERAGE_EXT, and GL_422_REV_AVERAGE_EXT are part of the EXT_422_pixels extension.
GL_EXT_bgra: GL_BGR_EXT and GL_BGRA_EXT are part of the EXT_bgra extension.
GL_EXT_color_table: GL_COLOR_TABLE_EXT, GL_POST_CONVOLUTION_COLOR_TABLE_EXT, and GL_POST_COLOR_MATRIX_COLOR_TABLE_EXT are part of the EXT_color_table extension.
GL_EXT_color_subtable: glColorSubTableEXT is part of the EXT_color_subtable extension.
GL_EXT_packed_pixels: GL_UNSIGNED_BYTE_3_3_2_EXT, GL_UNSIGNED_BYTE_2_3_3_REV_EXT, GL_UNSIGNED_SHORT_5_6_5_EXT, GL_UNSIGNED_SHORT_5_6_5_REV_EXT, GL_UNSIGNED_SHORT_4_4_4_4_EXT, GL_UNSIGNED_SHORT_4_4_4_4_REV_EXT, GL_UNSIGNED_SHORT_5_5_5_1_EXT, GL_UNSIGNED_SHORT_1_5_5_5_REV_EXT, GL_UNSIGNED_INT_8_8_8_8_EXT, GL_UNSIGNED_INT_8_8_8_8_REV_EXT, GL_UNSIGNED_INT_10_10_10_2_EXT, and GL_UNSIGNED_INT_2_10_10_10_REV_EXT are part of the EXT_packed_pixels extension.
GL_EXT_texture_color_table: GL_TEXTURE_COLOR_TABLE_EXT is part of the EXT_texture_color_table extension.

ERRORS

GL_INVALID_ENUM is generated if target is not an accepted value.

GL_INVALID_VALUE is generated if start is less than zero.

GL_INVALID_VALUE is generated if count is less than zero.

GL_INVALID_VALUE is generated if start + count is greater than the width.

GL_INVALID_ENUM is generated if format is not an accepted value.

GL_INVALID_ENUM is generated if type is not an accepted value.

GL_INVALID_OPERATION is generated if glColorSubTableEXT is executed between the execution of glEnd.

ASSOCIATED GETS

glGetColorTableEXT
glGetColorTableParameterEXT