glGetBufferSubData, glGetNamedBufferSubData — returns a subset of a buffer object's data store
void glGetBufferSubData(
|
GLenum target, |
GLintptr offset, | |
GLsizeiptr size, | |
void * data) ; |
void glGetNamedBufferSubData(
|
GLuint buffer, |
GLintptr offset, | |
GLsizeiptr size, | |
void *data) ; |
target
Specifies the target to which the buffer object is bound
for glGetBufferSubData
, which must
be one of the buffer binding targets in the following
table:
Buffer Binding Target | Purpose |
---|---|
GL_ARRAY_BUFFER
|
Vertex attributes |
GL_ATOMIC_COUNTER_BUFFER
|
Atomic counter storage |
GL_COPY_READ_BUFFER
|
Buffer copy source |
GL_COPY_WRITE_BUFFER
|
Buffer copy destination |
GL_DISPATCH_INDIRECT_BUFFER
|
Indirect compute dispatch commands |
GL_DRAW_INDIRECT_BUFFER
|
Indirect command arguments |
GL_ELEMENT_ARRAY_BUFFER
|
Vertex array indices |
GL_PIXEL_PACK_BUFFER
|
Pixel read target |
GL_PIXEL_UNPACK_BUFFER
|
Texture data source |
GL_QUERY_BUFFER
|
Query result buffer |
GL_SHADER_STORAGE_BUFFER
|
Read-write storage for shaders |
GL_TEXTURE_BUFFER
|
Texture data buffer |
GL_TRANSFORM_FEEDBACK_BUFFER
|
Transform feedback buffer |
GL_UNIFORM_BUFFER
|
Uniform block storage |
buffer
Specifies the name of the buffer object for
glGetNamedBufferSubData
.
offset
Specifies the offset into the buffer object's data store from which data will be returned, measured in bytes.
size
Specifies the size in bytes of the data store region being returned.
data
Specifies a pointer to the location where buffer object data is returned.
glGetBufferSubData
and
glGetNamedBufferSubData
return some or all
of the data contents of the data store of the specified buffer
object. Data starting at byte offset
offset
and extending for
size
bytes is copied from the buffer
object's data store to the memory pointed to by
data
. An error is thrown if the buffer
object is currently mapped, or if offset
and size
together define a range beyond
the bounds of the buffer object's data store.
If an error is generated, no change is made to the contents of
data
.
The GL_ATOMIC_COUNTER_BUFFER
target is
available only if the GL version is 4.2 or greater.
The GL_DISPATCH_INDIRECT_BUFFER
and
GL_SHADER_STORAGE_BUFFER
targets are
available only if the GL version is 4.3 or greater.
The GL_QUERY_BUFFER
target is available
only if the GL version is 4.4 or greater.
GL_INVALID_ENUM
is generated by
glGetBufferSubData
if target
is not one of the generic
buffer binding targets.
GL_INVALID_OPERATION
is generated by
glGetBufferSubData
if zero is bound to
target
.
GL_INVALID_OPERATION
is generated by
glGetNamedBufferSubData
if
buffer
is not the name of an existing
buffer object.
GL_INVALID_VALUE
is generated if
offset
or size
is
negative, or if $offset + size$ is greater than the value of
GL_BUFFER_SIZE
for the buffer object.
GL_INVALID_OPERATION
is generated if the
buffer object is mapped with
glMapBufferRange
or
glMapBuffer,
unless it was mapped with the
GL_MAP_PERSISTENT_BIT
bit set in the
glMapBufferRange
access
flags.
OpenGL Version | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Function / Feature Name | 2.0 | 2.1 | 3.0 | 3.1 | 3.2 | 3.3 | 4.0 | 4.1 | 4.2 | 4.3 | 4.4 | 4.5 |
glGetBufferSubData
|
✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
glGetNamedBufferSubData
|
- | - | - | - | - | - | - | - | - | - | - | ✔ |
glBindBuffer, glBufferData, glBufferSubData, glMapBuffer, glUnmapBuffer
Copyright © 2005 Addison-Wesley. Copyright © 2011-2014 Khronos Group. This material may be distributed subject to the terms and conditions set forth in the Open Publication License, v 1.0, 8 June 1999. https://opencontent.org/openpub/.