glColorSubTable
Prev | GL | Next

## Name

glColorSubTable — respecify a portion of a color table

## C Specification

`void `glColorSubTable`` | `(` | `GLenum `target`, GLsizei `start`, GLsizei `count`, GLenum `format`, GLenum `type`, const GLvoid *`data`);`

## Python Specification

`void `glColorSubTable`` | `(` | `GLenum `target`, GLsizei `start`, GLsizei `count`, GLenum `format`, GLenum `type`, const GLvoid *`data`);`

## 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.
`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.

## Description

`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.

## Notes

`glColorSubTable` is present only if `GL_ARB_imaging` is returned when `glGetString` is called with an argument of `GL_EXTENSIONS`.

## Errors

`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`.

## Associated Gets

`glGetColorTable`, `glGetColorTableParameter`

## See Also

glColorSubTable, glColorTableParameter, glCopyColorTable, glCopyColorSubTable, glGetColorTable

Prev | Up | Next
glColorPointer | Home | glColorTable