glGetFramebufferParameteriv — retrieve a named parameter from a framebuffer
void glGetFramebufferParameteriv( | GLenum target, |
GLenum pname, | |
GLint * params) ; |
target
The target of the operation, which must be GL_READ_FRAMEBUFFER
, GL_DRAW_FRAMEBUFFER
or GL_FRAMEBUFFER
.
pname
A token indicating the parameter to be retrieved.
params
The address of a variable to receive the value of the parameter named pname
.
glGetFramebufferParameteriv
retrieves the current value of the parameter named pname
from the framebuffer bound to target
. target
must be GL_READ_FRAMEBFUFFER
, GL_DRAW_FRAMEBUFFER
or GL_FRAMEBUFFER
. The token GL_FRAMEBUFFER
is treated as GL_DRAW_FRAMEBUFFER
. A non-default framebuffer must be bound to target
.
pname
specifies the parameter to be retrieved. The values retrieved from the framebuffer are written into the variable whose address is given by params
. The following symbols are accepted in pname
:
GL_FRAMEBUFFER_DEFAULT_WIDTH
The value of GL_FRAMEBUFFER_DEFAULT_WIDTH
for the framebuffer is written to the single integer variable whose address is given by params
.
GL_FRAMEBUFFER_DEFAULT_HEIGHT
The value of GL_FRAMEBUFFER_DEFAULT_HEIGHT
for the framebuffer is written to the single integer variable whose address is given by params
.
GL_FRAMEBUFFER_DEFAULT_SAMPLES
The value of GL_FRAMEBUFFER_DEFAULT_SAMPLES
for the framebuffer is written to the single integer variable whose address is given by params
.
GL_FRAMEBUFFER_DEFAULT_FIXED_SAMPLE_LOCATIONS
If the value of GL_FRAMEBUFFER_DEFAULT_FIXED_SAMPLE_LOCATIONS
for the framebuffer is GL_TRUE
then the single integer variable whose address is in params
is set to one, otherwise it is set to zero.
GL_INVALID_ENUM
is generated if target
is not one of the accepted framebuffer targets.
GL_INVALID_ENUM
is generated if pname
is not one of the accepted parameter names.
GL_INVALID_OPERATION
is generated if the default framebuffer is bound to target
.
params
should be the address of a variable to which the client has write access otherwise undefined behavior, including process termination may occur.
OpenGL ES API Version | |||
---|---|---|---|
Function Name | 2.0 | 3.0 | 3.1 |
glGetFramebufferParameteriv | - | - | ✔ |
Copyright © 2012-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/.