These functions set the current color index.

glIndexd, glIndexf, glIndexi, glIndexs, glIndexdv, glIndexfv,
glIndexiv, glIndexsv

void glIndexd(
  GLdouble c

void glIndexf(
  GLfloat c

void glIndexi(
  GLint c

void glIndexs(
  GLshort c


The new value for the current color index.
void glIndexdv(
  const GLdouble *c

void glIndexfv(
  const GLfloat *c

void glIndexiv(
  const GLint *c

void glIndexsv(
  const GLshort *c


A pointer to a one-element array that contains the new value for the current color index.


The glIndex function updates the current (single-valued) color index. It takes one argument: the new value for the current color index.

The current index is stored as a floating-point value. Integer values are converted directly to floating-point values, with no special mapping.

Index values outside the representable range of the color-index buffer are not clamped. However, before an index is dithered (if enabled) and written to the framebuffer, it is converted to fixed-point format. Any bits in the integer portion of the resulting fixed-point value that do not correspond to bits in the framebuffer are masked out.

The current index can be updated at any time. In particular, glIndex can be called between a call to glBegin and the corresponding call to glEnd.

The following function retrieves information related to glIndex:

glGet with argument GL_CURRENT_INDEX


  Windows NT/2000: Requires Windows NT 3.5 or later.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in Gl.h.
  Library: Use Opengl32.lib.

See Also

glBegin, glColor, glEnd, glGet


Community Additions