glArrayElement 函数

glArrayElement 函数指定用于呈现顶点的数组元素。

语法

void WINAPI glArrayElement(
   GLint index
);

此函数不返回值。

使用 glBegin 和 glEnd 对中的 glArrayElement 函数为点、线和多边形基元指定顶点和属性数据。 glArrayElement 函数使用位于已启用顶点数组索引处的顶点和属性数据指定单个顶点的数据。

可以使用 glArrayElement 通过为顶点数据编制索引来构造基元，而不是按从头到尾的顺序流式传输数据数组。由于 glArrayElement 仅指定单个顶点，因此可以显式指定单个基元的属性。例如，可以为每个单独的三角形设置单个法线。

在显示列表中包括对 glArrayElement 的调用时，还会在显示列表中输入由数组指针和启用值确定的必要数组数据。数组指针和启用值是在创建显示列表时确定的，而不是在执行显示列表时确定的。

可以随时使用 glArrayElement 读取和缓存静态数组数据。在不再次指定数组的情况下修改静态数组的元素时，对 glArrayElement 的任何后续调用的结果都是未定义的。

调用 glArrayElement 而不首先调用 glEnableClientState (GL_VERTEX_ARRAY) 时，不会进行绘制，但会修改与已启用的数组对应的属性。虽然在 glBegin 和 glEnd 对中指定数组时不会生成错误，但结果未定义。

注意

glArrayElement 函数仅在 OpenGL 版本 1.1 或更高版本中可用。

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