Difference between revisions of "GLAPI/glInvalidateBufferSubData"

From OpenGL.org
Jump to: navigation, search
(Bot: Adding better formatting.)
(See Also)
Line 36: Line 36:
== See Also ==
== See Also ==
{{apifunc|glInvalidateTexSubImage}},, {{apifunc|glInvalidateTexImage}}, {{apifunc|glInvalidateBufferData}}, {{apifunc|glInvalidateFramebuffer}}, {{apifunc|glInvalidateSubFramebuffer}}.
{{apifunc|glBufferData}}, {{apifunc|glInvalidateBufferData}}, {{apifunc|glMapBufferRange}}, {{apifunc|glUnmapBuffer}}
== Copyright ==
== Copyright ==

Revision as of 10:55, 6 September 2012

Core in version 4.5
Core since version 4.3
Core ARB extension ARB_invalidate_subdata

glInvalidateBufferSubData: invalidate a region of a buffer object's data store

Function Definition

 void glInvalidateBufferSubData(GLuint buffer​, GLintptr offset​, GLsizeiptr length​);
The name of a buffer object, a subrange of whose data store to invalidate.
The offset within the buffer's data store of the start of the range to be invalidated.
The length of the range within the buffer's data store to be invalidated.


glInvalidateBufferSubData invalidates all or part of the content of the data store of a buffer object. After invalidation, the content of the specified range of the buffer's data store becomes undefined. The start of the range is given by offset​ and its size is given by length​, both measured in basic machine units.


GL_INVALID_VALUE is generated if offset​ or length​ is negative, or if offset​ + length​ is greater than the value of GL_BUFFER_SIZE for buffer​.

GL_INVALID_VALUE is generated if buffer​ is not the name of an existing buffer object.

GL_INVALID_OPERATION is generated if any part of buffer​ is currently mapped.

Associated Gets

glGetBufferParameter with argument GL_BUFFER_SIZE

See Also

glBufferData, glInvalidateBufferData, glMapBufferRange, glUnmapBuffer


Copyright © 2012 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. http://opencontent.org/openpub/.