GLGETBUFFERPARAMETER(3gl)GLGETBUFFERPARAMETER(3gl)NAME
glGetBufferParameteriv - return buffer parameter values
C SPECIFICATION
void glGetBufferParameteriv( GLenum target,
GLenum pname,
GLint *params )
PARAMETERS
target Specifies the symbolic name of the target buffer. Either
GL_ARRAY_BUFFER or GL_ELEMENT_ARRAY_BUFFER is accepted.
pname Specifies the symbolic name of a buffer parameter. GL_BUF‐
FER_SIZE, GL_BUFFER_USAGE, GL_BUFFER_ACCESS, and GL_BUF‐
FER_MAPPED are accepted.
params Returns the buffer parameters.
DESCRIPTION
glGetBufferParameter returns in params the value or values of the buf‐
fer parameter specified as pname. target defines the target buffer,
either GL_ARRAY_BUFFER or GL_ELEMENT_ARRAY_BUFFER. pname accepts the
symbols with the these interpretations:
GL_BUFFER_SIZE Returns the single-valued indicating
the buffer store size. The initial
value is 0.
GL_BUFFER_USAGE Returns the single-valued indicating
the buffer usage. The initial value
is GL_STATIC_DRAW.
GL_BUFFER_ACCESS Returns the single-valued indicating
the buffer access method. The ini‐
tial value is GL_READ_WRITE.
GL_BUFFER_MAPPED Returns the single-valued indicating
whether or not the buffer is an
mapped state. The initial value is
GL_FALSE.
NOTES
glGetBufferParameteriv is available if the GL version is 1.5 or
greater.
If an error is generated, no change is made to the contents of params.
ERRORS
GL_INVALID_ENUM is generated if target or pname is not an accepted
value.
GL_INVALID_OPERATION is generated if glGetBufferParameter is executed
between the execution of glBegin and the corresponding execution of
glEnd.
SEE ALSO
glBufferData, glBufferSubData, glMapBuffer, glUnmapBuffer
14 Jan 04 GLGETBUFFERPARAMETER(3gl)