glGetRenderbufferParameteriv, glGetNamedRenderbufferParameteriv — query a named parameter of a renderbuffer object
void glGetRenderbufferParameteriv( | GLenum target, |
GLenum pname, | |
GLint *params) ; |
void glGetNamedRenderbufferParameteriv( | GLuint renderbuffer, |
GLenum pname, | |
GLint *params) ; |
target
Specifies the target to which the renderbuffer object is bound for glGetRenderbufferParameteriv
. target
must be GL_RENDERBUFFER
.
renderbuffer
Specifies the name of the renderbuffer object for glGetNamedRenderbufferParameteriv
.
pname
Specifies the parameter of the renderbuffer object to query.
params
Returns the value of parameter pname
for the renderbuffer object.
glGetRenderbufferParameteriv
and glGetNamedRenderbufferParameteriv
query parameters of a specified renderbuffer object.
For glGetRenderbufferParameteriv
, the renderbuffer object is that bound to target
, which must be GL_RENDERBUFFER
.
For glGetNamedRenderbufferParameteriv
, renderbuffer
is the name of the renderbuffer object.
Upon successful return, param
will contain the value of the renderbuffer parameter specified by pname
, as described below.
GL_RENDERBUFFER_WIDTH
, GL_RENDERBUFFER_HEIGHT
, GL_RENDERBUFFER_INTERNAL_FORMAT
or GL_RENDERBUFFER_SAMPLES
params
returns the width in pixels, the height in pixels, internal format, or the number of samples, respectively, of the image of the specified renderbuffer object.
GL_RENDERBUFFER_RED_SIZE
, GL_RENDERBUFFER_GREEN_SIZE
, GL_RENDERBUFFER_BLUE_SIZE
, GL_RENDERBUFFER_ALPHA_SIZE
, GL_RENDERBUFFER_DEPTH_SIZE
or GL_RENDERBUFFER_STENCIL_SIZE
params
returns the actual resolution in bits (not the resolution specified when the image was defined) for the red, green, blue, alpha, depth or stencil components, respectively, of the image of the renderbuffer object.
GL_INVALID_ENUM
is generated by glGetRenderbufferParameteriv
if target
is not GL_RENDERBUFFER
.
GL_INVALID_OPERATION
is generated by glGetRenderbufferParameteriv
if zero is bound to target
.
GL_INVALID_OPERATION
is generated by glGetNamedRenderbufferParameteriv
if renderbuffer
is not the name of an existing renderbuffer object.
GL_INVALID_ENUM
is generated if pname
is not one of the accepted parameter names described above.
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 |
glGetNamedRenderbufferParameteriv | - | - | - | - | - | - | - | - | - | - | - | ✔ |
glGetRenderbufferParameteriv | - | - | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
glGenRenderbuffers, glFramebufferRenderbuffer, glBindRenderbuffer, glRenderbufferStorage, glRenderbufferStorageMultisample
Copyright © 2010-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/.