GLES2.0中文API-glVertexAttribPointer

名称

glVertexAttribPointer - 定义通用顶点属性数据的数组

C规范

void glVertexAttribPointer（GLuint index,

                                           GLint size,

                                           GLenum type,

                                           GLboolean normalized,

                                           GLsizei stride,

                                           const GLvoid * pointer）;

参数

index

指定要修改的通用顶点属性的索引。

size

指定每个通用顶点属性的组件数。 必须为1,2,3或4.初始值为4。

type

指定数组中每个组件的数据类型。 接受符号常量GL_BYTE，GL_UNSIGNED_BYTE，GL_SHORT，GL_UNSIGNED_SHORT，GL_FIXED或GL_FLOAT。 初始值为GL_FLOAT。

normalized

指定在访问定点数据值时是应将其标准化（GL_TRUE）还是直接转换为定点值（GL_FALSE）。

stride

指定连续通用顶点属性之间的字节偏移量。 如果stride为0，则通用顶点属性被理解为紧密打包在数组中的。 初始值为0。

pointer

指定指向数组中第一个通用顶点属性的第一个组件的指针。 初始值为0。

描述

glVertexAttribPointer指定索引index处的通用顶点属性数组的位置和数据格式，以便在渲染时使用。size指定每个属性的组件数，并且必须为1,2,3或4。type指定每个组件的数据类型，stride指定从一个属性到下一个属性的字节跨度，允许将顶点和属性打包到单个数组中或存储在单独的数组中。如果设置为GL_TRUE，则normalized表示以整数格式存储的值将被映射到范围[-1,1]（对于有符号值）或[0,1]（对于无符号值），当它们被访问并转换为 浮点。 否则，值将直接转换为浮点数而不进行标准化。

如果在指定通用顶点属性数组时将非零命名VBOid绑定到GL_ARRAY_BUFFER目标（请参阅glBindBuffer），则将pointer视为VBO的数据存储中的字节偏移量。 此外，VBO绑定（GL_ARRAY_BUFFER_BINDING）被保存为索引index的通用顶点属性数组客户端状态（GL_VERTEX_ATTRIB_ARRAY_BUFFER_BINDING）。

指定通用顶点属性数组时，除了当前顶点数组VBO绑定外，还将size，type，normalized，stride和pointer保存为客户端状态。

要启用和禁用通用顶点属性数组，请使用index调用glEnableVertexAttribArray和glDisableVertexAttribArray。 如果启用，则在调用glDrawArrays或glDrawElements时使用通用顶点属性数组。

注意

每个通用顶点属性数组最初都被禁用，并且在调用glDrawElements或glDrawArrays时不会被访问。

glVertexAttribPointer通常在客户端实现。

错误

GL_INVALID_ENUM：type不是可接收的值；

GL_INVALID_VALUE：index大于或等于GL_MAX_VERTEX_ATTRIBS。

GL_INVALID_VALUE：size的值不是1,2,3,4

GL_INVALID_VALUE：stride是负数

相关Gets

glGet 参数GL_MAX_VERTEX_ATTRIBS

glGetVertexAttrib 参数index和GL_VERTEX_ATTRIB_ARRAY_ENABLED

glGetVertexAttrib 参数index和GL_VERTEX_ATTRIB_ARRAY_SIZE

glGetVertexAttrib 参数index和GL_VERTEX_ATTRIB_ARRAY_TYPE

glGetVertexAttrib 参数index和GL_VERTEX_ATTRIB_ARRAY_NORMALIZED

glGetVertexAttrib 参数index和GL_VERTEX_ATTRIB_ARRAY_STRIDE

glGetVertexAttrib 参数index和GL_VERTEX_ATTRIB_ARRAY_BUFFER_BINDING

glGet 参数GL_ARRAY_BUFFER_BINDING

glGetVertexAttribPointerv 参数index和GL_VERTEX_ATTRIB_ARRAY_POINTER

另见

glBindAttribLocation，glBindBuffer，glEnableVertexAttribArray，glDisableVertexAttribArray，glDrawElements，glDrawArrays，glVertexAttrib

版权

https://www.khronos.org/registry/OpenGL-Refpages/es2.0/xhtml/glVertexAttribPointer.xml

https://blog.csdn.net/flycatdeng

Copyright © 1991-2006 Silicon Graphics, Inc.本文档的许可是根据SGI Free Software B License.详见http://oss.sgi.com/projects/FreeB/.

Android,OpenGL ES,图形学