图形渲染与 Shader / 系统课时

配置深度模板附件

配置深度模板附件

离屏帧缓冲如果只有颜色附件,深度测试和模板测试就没有对应的存储目标。本节为 FBO 添加组合深度模板附件,并区分 Renderbuffer 与纹理两种方案,让离屏场景能够正确执行遮挡和模板操作。

学习目标

  • 为 FBO 创建并绑定深度模板组合附件
  • 理解 GL_DEPTH24_STENCIL8 与 GL_DEPTH_STENCIL_ATTACHMENT 的配合方式
  • 根据后续是否需要采样深度数据选择 Renderbuffer 或纹理

选择深度模板附件

深度附件保存每个像素的深度值,模板附件保存模板测试使用的整数值。实际项目经常把两者组合在一个 GL_DEPTH24_STENCIL8 存储对象中,其中深度占 24 位、模板占 8 位,再通过 GL_DEPTH_STENCIL_ATTACHMENT 一次挂到帧缓冲。

如果深度和模板只参与测试、不需要被后处理着色器读取,Renderbuffer 通常最直接。若后续需要根据深度实现景深、雾效、边缘检测或位置重建,则应改用可采样的深度纹理。

FBO 颜色附件与深度模板附件关系

创建组合深度模板附件

下面是片段示例,假设 OpenGL 3.3 上下文和 GLAD、GLEW 等函数加载器已经初始化。代码同时创建颜色纹理和深度模板 Renderbuffer,确保 FBO 具备完整的离屏渲染目标。

cpp
#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;
}

预期输出:当附件格式、尺寸和绑定关系正确时,完整性检查通过。

text
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,并在离屏绘制阶段正确清除和启用深度、模板测试,它就能像默认帧缓冲一样承担完整的深度与模板处理。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

配置深度模板附件

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通