glIndexPointer 函数
glIndexPointer 函数定义颜色索引数组。
语法
void WINAPI glIndexPointer(
GLenum type,
GLsizei stride,
const GLvoid *pointer
);
参数
-
type
-
数组中每个颜色索引的数据类型使用以下符号常量：GL_SHORT、GL_INT、GL_FLOAT、GL_DOUBLE。
-
大步
-
连续颜色索引之间的字节偏移量。 当 步幅 为零时，颜色索引将紧密地打包在数组中。
-
pointer
-
指向数组中第一个颜色索引的指针。
返回值
此函数不返回值。
错误代码
glGetError 函数可以检索以下错误代码。
| 名称 | 含义 |
|---|---|
|
type 不是接受的值。 |
|
步幅 或 计数 为负数。 |
备注
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 [仅限桌面应用] |
| 标头 |
|
| 库 |
|
| DLL |
|