glIndex

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);

Parameters

  • 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);

Parameters

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

Remarks

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

Requirements

**  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