名称
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.youkuaiyun.com/flycatdeng
Copyright © 1991-2006 Silicon Graphics, Inc.本文档的许可是根据SGI Free Software B License.详见http://oss.sgi.com/projects/FreeB/.
