glGetRenderbufferParameteriv — return parameters of a renderbuffer object
void glGetRenderbufferParameteriv( | GLenum target, |
GLenum pname, | |
GLint * params) ; |
target
Specifies the target renderbuffer object. The symbolic constant must be GL_RENDERBUFFER
.
pname
Specifies the symbolic name of a renderbuffer object parameter. Accepted values are GL_RENDERBUFFER_WIDTH
, GL_RENDERBUFFER_HEIGHT
, GL_RENDERBUFFER_INTERNAL_FORMAT
, 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 requested parameter.
glGetRenderbufferParameteriv
returns in params
a selected parameter of the currently bound renderbuffer object.
pname
names a specific renderbuffer object parameter, as follows:
GL_RENDERBUFFER_WIDTH
params
returns the width in pixels of the image of the currently bound renderbuffer. The initial value is 0.
GL_RENDERBUFFER_HEIGHT
params
returns the height in pixels of the image of the currently bound renderbuffer. The initial value is 0.
GL_RENDERBUFFER_INTERNAL_FORMAT
params
returns the internal format of the image of the currently bound renderbuffer. The initial value is GL_RGBA4
.
GL_RENDERBUFFER_RED_SIZE
params
returns the resolution in bits for the red component of the image of the currently bound renderbuffer. The initial value is 0.
GL_RENDERBUFFER_GREEN_SIZE
params
returns the resolution in bits for the green component of the image of the currently bound renderbuffer. The initial value is 0.
GL_RENDERBUFFER_BLUE_SIZE
params
returns the resolution in bits for the blue component of the image of the currently bound renderbuffer. The initial value is 0.
GL_RENDERBUFFER_ALPHA_SIZE
params
returns the resolution in bits for the alpha component of the image of the currently bound renderbuffer. The initial value is 0.
GL_RENDERBUFFER_DEPTH_SIZE
params
returns the resolution in bits for the depth component of the image of the currently bound renderbuffer. The initial value is 0.
GL_RENDERBUFFER_STENCIL_SIZE
params
returns the resolution in bits for the stencil component of the image of the currently bound renderbuffer. The initial value is 0.
The resolution of components reported by glGetRenderbufferParameteriv
are the actual resolutions at which the components are stored, which may be different than those requested by the internalformat
parameter of glRenderbufferStorage.
If an error is generated, no change is made to the contents of params
.
GL_INVALID_ENUM
is generated if target
is not GL_RENDERBUFFER
.
GL_INVALID_ENUM
is generated if pname
is not GL_RENDERBUFFER_WIDTH
, GL_RENDERBUFFER_HEIGHT
, GL_RENDERBUFFER_INTERNAL_FORMAT
, 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
.
GL_INVALID_OPERATION
is generated if the reserved renderbuffer object name 0 is bound.
Copyright © 2008 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/.