图形渲染与 Shader / 系统课时
配置深度模板附件
配置深度模板附件
离屏帧缓冲如果只有颜色附件,深度测试和模板测试就没有对应的存储目标。本节为 FBO 添加组合深度模板附件,并区分 Renderbuffer 与纹理两种方案,让离屏场景能够正确执行遮挡和模板操作。
学习目标
- 为 FBO 创建并绑定深度模板组合附件
- 理解
GL_DEPTH24_STENCIL8与GL_DEPTH_STENCIL_ATTACHMENT的配合方式 - 根据后续是否需要采样深度数据选择 Renderbuffer 或纹理
选择深度模板附件
深度附件保存每个像素的深度值,模板附件保存模板测试使用的整数值。实际项目经常把两者组合在一个 GL_DEPTH24_STENCIL8 存储对象中,其中深度占 24 位、模板占 8 位,再通过 GL_DEPTH_STENCIL_ATTACHMENT 一次挂到帧缓冲。
如果深度和模板只参与测试、不需要被后处理着色器读取,Renderbuffer 通常最直接。若后续需要根据深度实现景深、雾效、边缘检测或位置重建,则应改用可采样的深度纹理。

创建组合深度模板附件
下面是片段示例,假设 OpenGL 3.3 上下文和 GLAD、GLEW 等函数加载器已经初始化。代码同时创建颜色纹理和深度模板 Renderbuffer,确保 FBO 具备完整的离屏渲染目标。
#include <iostream>
#include <stdexcept>
struct OffscreenFbo {
GLuint fbo = 0;
GLuint colorTexture = 0;
GLuint depthStencilRbo = 0;
};
OffscreenFbo createOffscreenFbo(GLsizei width, GLsizei height) {
OffscreenFbo target;
glGenFramebuffers(1, &target.fbo);
glBindFramebuffer(GL_FRAMEBUFFER, target.fbo);
// 颜色附件稍后可作为屏幕后处理的输入纹理。
glGenTextures(1, &target.colorTexture);
glBindTexture(GL_TEXTURE_2D, target.colorTexture);
glTexImage2D(GL_TEXTURE_2D, 0, GL_RGBA8, width, height,
0, GL_RGBA, GL_UNSIGNED_BYTE, nullptr);
glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_LINEAR);
glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_LINEAR);
glFramebufferTexture2D(GL_FRAMEBUFFER, GL_COLOR_ATTACHMENT0,
GL_TEXTURE_2D, target.colorTexture, 0);
// 一个 Renderbuffer 同时提供深度和模板存储。
glGenRenderbuffers(1, &target.depthStencilRbo);
glBindRenderbuffer(GL_RENDERBUFFER, target.depthStencilRbo);
glRenderbufferStorage(GL_RENDERBUFFER, GL_DEPTH24_STENCIL8,
width, height);
glFramebufferRenderbuffer(GL_FRAMEBUFFER,
GL_DEPTH_STENCIL_ATTACHMENT,
GL_RENDERBUFFER,
target.depthStencilRbo);
if (glCheckFramebufferStatus(GL_FRAMEBUFFER) != GL_FRAMEBUFFER_COMPLETE) {
throw std::runtime_error("Framebuffer is incomplete");
}
std::cout << "Framebuffer complete" << std::endl;
glBindFramebuffer(GL_FRAMEBUFFER, 0);
return target;
}预期输出:当附件格式、尺寸和绑定关系正确时,完整性检查通过。
Framebuffer complete实际 OpenGL 对象 ID 由驱动分配,因此不应依赖固定 ID。渲染到这个 FBO 时仍需根据需要启用 GL_DEPTH_TEST 或 GL_STENCIL_TEST;创建附件本身不会自动打开测试功能。
需要采样深度时改用纹理
Renderbuffer 适合只由固定功能测试阶段读写的数据,但不能直接作为普通纹理交给屏幕后处理着色器采样。若后续需要读取深度,应创建深度纹理,例如采用 GL_DEPTH_COMPONENT24 内部格式,并绑定到 GL_DEPTH_ATTACHMENT。
如果既要保存模板值又希望把组合数据放在纹理中,也可以使用 GL_DEPTH24_STENCIL8 纹理并挂到 GL_DEPTH_STENCIL_ATTACHMENT。是否值得这样做取决于后处理是否真的需要读取这些数据;没有采样需求时使用 Renderbuffer 可以保持设计简单。
验证附件是否可靠
glCheckFramebufferStatus 应在所有附件完成绑定后执行。常见失败原因包括颜色附件和深度模板附件尺寸不一致、附件没有分配存储、使用了不兼容的格式,或者窗口尺寸变化后只调整了颜色纹理却忘记重新分配 Renderbuffer。
窗口发生缩放时,应让颜色附件和深度模板附件始终采用同一有效渲染尺寸。只要 FBO 保持 GL_FRAMEBUFFER_COMPLETE,并在离屏绘制阶段正确清除和启用深度、模板测试,它就能像默认帧缓冲一样承担完整的深度与模板处理。