GLGETBUFFERPARAMETER(3G) OpenGL Manual GLGETBUFFERPARAMETER(3G)
NAME
glGetBufferParameteriv - return parameters of a buffer object
C SPECIFICATION
void glGetBufferParameteriv(GLenum target, GLenum value, GLint * data);
void glGetBufferParameteri64v(GLenum target, GLenum value, GLint64 * data);
PARAMETERS
target
Specifies the target buffer object. The symbolic constant must be GL_ARRAY_BUFFER, GL_ATOMIC_COUNTER_BUFFER, GL_COPY_READ_BUFFER,
GL_COPY_WRITE_BUFFER, GL_DRAW_INDIRECT_BUFFER, GL_DISPATCH_INDIRECT_BUFFER, GL_ELEMENT_ARRAY_BUFFER, GL_PIXEL_PACK_BUFFER,
GL_PIXEL_UNPACK_BUFFER, GL_SHADER_STORAGE_BUFFER, GL_TEXTURE_BUFFER, GL_TRANSFORM_FEEDBACK_BUFFER, or GL_UNIFORM_BUFFER.
value
Specifies the symbolic name of a buffer object parameter. Accepted values are GL_BUFFER_ACCESS, GL_BUFFER_MAPPED, GL_BUFFER_SIZE, or
GL_BUFFER_USAGE.
data
Returns the requested parameter.
DESCRIPTION
glGetBufferParameteriv returns in data a selected parameter of the buffer object specified by target.
value names a specific buffer object parameter, as follows:
GL_BUFFER_ACCESS
params returns the access policy set while mapping the buffer object. The initial value is GL_READ_WRITE.
GL_BUFFER_MAPPED
params returns a flag indicating whether the buffer object is currently mapped. The initial value is GL_FALSE.
GL_BUFFER_SIZE
params returns the size of the buffer object, measured in bytes. The initial value is 0.
GL_BUFFER_USAGE
params returns the buffer object's usage pattern. The initial value is GL_STATIC_DRAW.
NOTES
If an error is generated, no change is made to the contents of data.
The GL_ATOMIC_COUNTER_BUFER 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.
ERRORS
GL_INVALID_ENUM is generated if target or value is not an accepted value.
GL_INVALID_OPERATION is generated if the reserved buffer object name 0 is bound to target.
SEE ALSO
glBindBuffer(), glBufferData(), glMapBuffer(), glUnmapBuffer()
COPYRIGHT
Copyright (C) 2005 Addison-Wesley. 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/.
AUTHORS
opengl.org
opengl.org 06/10/2014 GLGETBUFFERPARAMETER(3G)