glIndexfv function

The glIndexfv function sets the current color index.

Syntax

void WINAPI glIndexfv(
   const GLfloat *c
);

Parameters

c

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

Return value

This function does not return a value.

Remarks

The glIndexfv 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, glIndexfv can be called between a call to glBegin and the corresponding call to glEnd.

The following function retrieves information related to glIndexfv:

glGet with argument GL_CURRENT_INDEX

Requirements

Requirement Value
Minimum supported client
Windows 2000 Professional [desktop apps only]
Minimum supported server
Windows 2000 Server [desktop apps only]
Header
Gl.h
Library
Opengl32.lib
DLL
Opengl32.dll

See also

glBegin

glColor

glEnd

glGet