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 函数可以检索以下错误代码。

名称 含义
GL_INVALID_VALUE
 大小 不是 2、3 或 4。
GL_INVALID_ENUM
 type 不是接受的值。
GL_INVALID_VALUE
 步幅 或 计数 为负数。

备注

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 [仅限桌面应用]
标头
Gl.h
库
Opengl32.lib
DLL
Opengl32.dll

另请参阅

glArrayElement

glColorPointer

glDrawArrays

glEdgeFlagPointer

glEnableClientState

glGetPointerv

glGetString

glIndexPointer

glIsEnabled

glNormalPointer

glTexCoordPointer