glIndexPointer 函数

  • 项目

glIndexPointer 函数定义颜色索引数组。

语法

void WINAPI glIndexPointer(
         GLenum  type,
         GLsizei stride,
   const GLvoid  *pointer
);

参数

type

数组中每个颜色索引的数据类型使用以下符号常量：GL_SHORT、GL_INT、GL_FLOAT、GL_DOUBLE。

大步

连续颜色索引之间的字节偏移量。 当 步幅 为零时，颜色索引将紧密地打包在数组中。

pointer

指向数组中第一个颜色索引的指针。

返回值

此函数不返回值。

错误代码

glGetError 函数可以检索以下错误代码。

名称 含义
GL_INVALID_ENUM
 type 不是接受的值。
GL_INVALID_VALUE
 步幅 或 计数 为负数。

备注

glIndexPointer 函数指定呈现时要使用的颜色索引数组的位置和数据。 type 参数指定每个颜色索引的数据类型，步幅确定从一个颜色索引到下一个颜色索引的字节偏移量，从而允许将顶点和属性打包在单个数组中或在单独的数组中存储。 在某些实现中，将顶点和属性存储在单个数组中比使用单独的数组更高效。 有关详细信息，请参阅 glInterleavedArrays。

使用 glEnableClientState 指定GL_INDEX_ARRAY常量时，将启用颜色索引数组。 启用时， glDrawArrays 和 glArrayElement 使用颜色索引数组。 默认情况下，颜色索引数组处于禁用状态。

不能在显示列表中包括 glIndexPointer 。

使用 glIndexPointer 指定颜色索引数组时，函数的所有颜色索引数组参数的值都保存为客户端状态，并且可以缓存静态数组元素。 由于颜色索引数组参数是客户端状态，因此其值不会由 glPushAttrib 和 glPopAttrib 保存或还原。

虽然在 glBegin 和 glEnd 对中调用 glIndexPointer 时不会生成错误，但结果未定义。

以下函数检索与 glIndexPointer 相关的信息：

glIsEnabled with argument GL_INDEX_ARRAY

带参数GL_INDEX_ARRAY_STRIDE的 glGet

带参数GL_INDEX_ARRAY_COUNT的 glGet

带参数GL_INDEX_ARRAY_TYPE的 glGet

带参数GL_INDEX_ARRAY_SIZE的 glGet

带参数的 glGetPointerv GL_INDEX_ARRAY_POINTER

要求

要求 值
最低受支持的客户端
 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器
 Windows 2000 Server [仅限桌面应用]
标头
Gl.h
库
Opengl32.lib
DLL
Opengl32.dll

另请参阅

glArrayElement

glColorPointer

glDrawArrays

glEdgeFlagPointer

glGetPointerv

glGetString

glNormalPointer

glPushAttrib

glTexCoordPointer

glVertexPointer