名称
glBufferData- 创建并初始化缓冲区对象的数据存储
C规范
void glBufferData(GLenum target,GLsizeiptr size,const GLvoid * data,GLenum usage);
参数
target
指定目标缓冲区对象。 符号常量必须为GL_ARRAY_BUFFER或GL_ELEMENT_ARRAY_BUFFER。
size
指定缓冲区对象的新数据存储的大小(以字节为单位)。
data
指定将复制到数据存储区以进行初始化的数据的指针,如果不复制数据,则指定NULL。
usage
指定数据存储的预期使用模式。 符号常量必须为GL_STREAM_DRAW,GL_STATIC_DRAW或GL_DYNAMIC_DRAW。
描述
glBufferData为当前绑定到target的缓冲区对象创建一个新的数据存储。 删除任何预先存在的数据存储。 使用指定的字节和usage创建新数据存储。 如果data不是NULL,则使用来自此指针的数据初始化数据存储。
usage是关于如何访问缓冲区对象的数据存储的GL实现的提示。这使GL实现能够做出更明智的决策,这可能会显着影响缓冲区对象的性能。 但是,它不会限制数据存储的实际使用。usage可以分为两部分:第一,访问频率(修改和使用),第二,访问的性质。 访问频率可能是以下之一:
STREAM
数据存储内容将被修改一次并最多使用几次。
STATIC
数据存储内容将被修改一次并多次使用。
DYNAMIC
数据存储内容将被重复修改并多次使用。
访问的性质必须是:
DRAW
数据存储内容由应用程序修改,并用作GL绘图和图像规范命令的源。
注意
如果data为NULL,则仍会创建指定大小的数据存储,但其内容仍未初始化,因此被视为未定义的。
客户端必须使数据元素与客户端平台的要求保持一致,并具有额外的基本级要求,即缓冲区内对包含N的数据的偏移量是N的倍数。
错误
GL_INVALID_ENUM
:target不是GL_ARRAY_BUFFER或GL_ELEMENT_ARRAY_BUFFER。
GL_INVALID_ENUM
:usage不是GL_STREAM_DRAW,GL_STATIC_DRAW或GL_DYNAMIC_DRAW。
GL_INVALID_VALUE
:size是负数
GL_INVALID_OPERATION
:如果保留的缓冲区对象名称0绑定到target。
GL_OUT_OF_MEMORY
:如果GL无法创建具有指定大小的数据存储
相关Gets
glGetBufferParameteriv 参数 GL_BUFFER_SIZE
或GL_BUFFER_USAGE
另见
glBindBuffer,glBufferSubData
版权
https://www.khronos.org/registry/OpenGL-Refpages/es2.0/xhtml/glBufferData.xml
https://blog.csdn.net/flycatdeng
Copyright © 1991-2006 Silicon Graphics, Inc.本文档的许可是根据SGI Free Software B License.详见http://oss.sgi.com/projects/FreeB/.
