glVertexPointer 函数
glVertexPointer 函数定义顶点数据数组。
语法
void WINAPI glVertexPointer(
GLint size,
GLenum type,
GLsizei stride,
const GLvoid *pointer
);
parameters
-
大小
-
每个顶点的坐标数。 size 的值必须为 2、3 或 4。
-
type
-
使用以下符号常量数组中每个坐标的数据类型：GL_SHORT、GL_INT、GL_FLOAT和GL_DOUBLE。
-
大步
-
连续顶点之间的字节偏移量。 当 步幅 为零时，顶点将紧密地打包在数组中。
-
pointer
-
指向数组中第一个顶点的第一个坐标的指针。
返回值
此函数不返回值。
错误代码
glGetError 函数可以检索以下错误代码。
| 名称 | 含义 |
|---|---|
|
大小 不是 2、3 或 4。 |
|
type 不是接受的值。 |
|
步幅 或 计数 为负数。 |
备注
glVertexPointer 函数指定呈现时要使用的顶点坐标数组的位置和数据。 size 参数指定每个顶点的坐标数。 type 参数指定每个顶点坐标的数据类型。 stride 参数确定从一个顶点到另一个顶点的字节偏移量，从而允许将顶点和属性打包到单个数组中，或将顶点和属性打包到单独的数组中。 在某些实现中，将顶点和属性存储在单个数组中比使用单独的数组更高效 (请参阅 glInterleavedArrays) 。
使用 glEnableClientState 指定GL_VERTEX_ARRAY常量时，将启用顶点数组。 启用后， glDrawArrays、 glDrawElements 和 glArrayElement 使用顶点数组。 默认情况下，顶点数组处于禁用状态。
不能在显示列表中包括 glVertexPointer 。
使用 glVertexPointer 指定顶点数组时，函数的所有顶点数组参数的值都保存在客户端状态中，并且可以缓存静态数组元素。 由于顶点数组参数是客户端状态，因此 glPushAttrib 和 glPopAttrib 不会保存或还原其值。
虽然在 glBegin 和 glEnd 对中调用 glVertexPointer 不会生成错误，但结果未定义。
以下函数检索与 glVertexPointer 相关的信息：
带参数GL_VERTEX_ARRAY_SIZE的 glGet
带参数GL_VERTEX_ARRAY_STRIDE的 glGet
带参数GL_VERTEX_ARRAY_COUNT的 glGet
带参数GL_VERTEX_ARRAY_TYPE的 glGet
带参数GL_VERTEX_ARRAY_POINTER的 glGetPointerv
带参数GL_VERTEX_ARRAY的 glIsEnabled
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 |
Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 |
Windows 2000 Server [仅限桌面应用] |
| 标头 |
|
| 库 |
|
| DLL |
|