名称
glFramebufferParameteri — 设置帧缓冲区的命名参数
C 规范
void glFramebufferParameteri( GLenum target,
GLenum pname,
GLint param);
参数
target
操作的目标，必须为GL_READ_FRAMEBUFFER，GL_DRAW_FRAMEBUFFER或GL_FRAMEBUFFER。
pname
指示要修改的参数的令牌。
param
名为pname的参数的新值。
描述
glFramebufferParameteri修改绑定到目标的帧缓冲区中名为pname的参数的当前值。目标必须是GL_READ_FRAMEBFUFFER，GL_DRAW_FRAMEBUFFER或GL_FRAMEBUFFER。令牌GL_FRAMEBUFFER被视为GL_DRAW_FRAMEBUFFER。必须将非默认帧缓冲区绑定到目标。
pname指定要修改的参数。 pname接受以下符号：
GL_FRAMEBUFFER_DEFAULT_WIDTH
param为没有附件的帧缓冲区对象指定假定的。如果帧缓冲区具有附件，则使用这些附件的宽度，否则将GL_FRAMEBUFFER_DEFAULT_WIDTH的值用于帧缓冲区。参数必须大于或等于零且小于或等于GL_MAX_FRAMEBUFFER_WIDTH的值。
GL_FRAMEBUFFER_DEFAULT_HEIGHT
param指定没有附件的帧缓冲区对象的假定高度。如果帧缓冲区具有附件，则使用这些附件的高度，否则将GL_FRAMEBUFFER_DEFAULT_HEIGHT的值用于帧缓冲区。参数必须大于或等于零且小于或等于GL_MAX_FRAMEBUFFER_HEIGHT的值。
GL_FRAMEBUFFER_DEFAULT_SAMPLES
参数指定没有附件的帧缓冲区对象中的假定样本数。如果帧缓冲区包含附件，则使用这些附件的样本计数，否则将GL_FRAMEBUFFER_DEFAULT_SAMPLES的值用于帧缓冲区。参数必须大于或等于零且小于或等于GL_MAX_FRAMEBUFFER_SAMPLE的值。
GL_FRAMEBUFFER_DEFAULT_FIXED_SAMPLE_LOCATIONS
参数指定对于虚拟图像中的所有纹理像素，帧缓冲区是否应该假定相同的采样位置和相同数量的采样。如果参数为零，则该实现可以在虚拟图像中的像素之间改变像素的位置或数量，否则，它将对虚拟图像中的所有像素使用相同的采样位置和数量。
GL_FRAMEBUFFER_DEFAULT_LAYERS
param为没有附件的帧缓冲对象指定假定的层数。如果帧缓冲区包含附件，则使用这些附件的层数，否则将GL_FRAMEBUFFER_DEFAULT_LAYERS的值用于帧缓冲区。参数必须大于或等于零且小于或等于GL_MAX_FRAMEBUFFER_LAYERS的值。
失误
如果目标不是可接受的帧缓冲区目标之一，则生成GL_INVALID_ENUM。
如果pname为GL_FRAMEBUFFER_DEFAULT_WIDTH并且参数小于零或大于GL_MAX_FRAMEBUFFER_WIDTH的值，则生成GL_INVALID_VALUE。
如果pname为GL_FRAMEBUFFER_DEFAULT_HEIGHT并且参数小于零或大于GL_MAX_FRAMEBUFFER_HEIGHT的值，则生成GL_INVALID_VALUE。
如果pname为GL_FRAMEBUFFER_DEFAULT_SAMPLES并且参数小于零或大于GL_MAX_FRAMEBUFFER_SAMPLES的值，则生成GL_INVALID_VALUE。
如果pname为GL_FRAMEBUFFER_DEFAULT_LAYERS并且参数小于零或大于GL_MAX_FRAMEBUFFER_LAYERS的值，则生成GL_INVALID_VALUE。
如果默认帧缓冲区绑定到目标，则生成GL_INVALID_OPERATION。
相关Gets
glGetFramebufferParameteriv.
API 支持版本
| 函数名 | 2.0 | 3.0 | 3.1 | 3.2 |
|---|---|---|---|---|
| glFramebufferParameteri | - | - | ✔ | ✔ |
另见
glBindFramebuffer,
版权
https://www.khronos.org/registry/OpenGL-Refpages/es3/html/glFramebufferParameteri.xhtml
Copyright © 2012-2015 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. http://opencontent.org/openpub/.
