渲染至FBO时深度测试失效问题排查求助

问题描述 #

尝试在帧缓冲（FBO）中渲染3D金字塔，并将其显示在ImGui窗口内，但深度测试失效，呈现错误效果。已尝试调整循环中两次Clear()的颜色清除与深度清除组合，结果始终一致。

代码实现 #

glEnable(GL_DEPTH_TEST);
while (!glfwWindowShouldClose(mainwin))
{
    glClearColor(0.5f, 0.5f, 0.5f, 1.0f);

    ImGui_ImplOpenGL3_NewFrame();
    ImGui_ImplGlfw_NewFrame();
    ImGui::NewFrame();

    glEnable(GL_DEPTH_TEST);
    glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT);
   

    fbo.bind();//framebufferobject bind

    glClearColor(0.8f, 0.8f, 0.8f, 1.0f);

    glEnable(GL_DEPTH_TEST);
    glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT);

    /* Render here */       
    defaultshader.Activate();

    // Handles camera inputs
    camera1.Inputs(mainwin);
    // Updates and exports the camera matrix to the Vertex Shader
    camera1.Matrix(45.0f, 0.1f, 100.0f, defaultshader, "camMatrix");

    tex1.Bind();
    VAO1.Bind();
    // Draw primitives, number of indices, datatype of indices, index of indices
    glDrawElements(GL_TRIANGLES, sizeof(indices) / sizeof(int), GL_UNSIGNED_INT, 0);
    //---------------------------------------------------------------------------------------------------------------------------
    fbo.unbind();

    ImGui::Begin("Viewport");

    AppImguiAddImage(fbtex.FBtexID);//adds image to imgui drawlist

    ImGui::End();

    AppImguiFrameEnd();

    /* Swap front and back buffers */
    glfwSwapBuffers(mainwin);

    /* Poll for and process events */
    glfwPollEvents();

}

问题原因与解决方法 #

核心问题 #

你的自定义FBO未绑定深度缓冲附件。默认帧缓冲由系统提供了深度缓冲，但自定义FBO如果只配置了颜色纹理，没有关联深度缓冲（渲染缓冲或深度纹理），渲染时没有存储深度信息的载体，深度测试完全无法生效。

次要冗余操作 #

• 循环内重复调用glEnable(GL_DEPTH_TEST)无意义，只需在初始化时调用一次即可。
• 绑定FBO前执行的glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT)是清理默认帧缓冲，和FBO渲染无关，属于多余操作，可移除。

解决步骤 #

1. 为FBO添加深度缓冲附件，二选一即可：
   • 使用渲染缓冲（RBO）：

     // 创建渲染缓冲对象
     GLuint rbo;
     glGenRenderbuffers(1, &rbo);
     glBindRenderbuffer(GL_RENDERBUFFER, rbo);
     // 分配深度缓冲存储空间（尺寸需和颜色纹理一致）
     glRenderbufferStorage(GL_RENDERBUFFER, GL_DEPTH_COMPONENT, width, height);
     // 将RBO关联到FBO的深度附件
     glFramebufferRenderbuffer(GL_FRAMEBUFFER, GL_DEPTH_ATTACHMENT, GL_RENDERBUFFER, rbo);
     

   • 使用深度纹理：

     // 创建深度纹理
     GLuint depthTex;
     glGenTextures(1, &depthTex);
     glBindTexture(GL_TEXTURE_2D, depthTex);
     glTexImage2D(GL_TEXTURE_2D, 0, GL_DEPTH_COMPONENT, width, height, 0, GL_DEPTH_COMPONENT, GL_FLOAT, NULL);
     // 设置纹理过滤参数
     glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_NEAREST);
     glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_NEAREST);
     // 将深度纹理关联到FBO的深度附件
     glFramebufferTexture2D(GL_FRAMEBUFFER, GL_DEPTH_ATTACHMENT, GL_TEXTURE_2D, depthTex, 0);
     

2. 验证FBO完整性：绑定FBO后调用以下代码，确保返回值为GL_FRAMEBUFFER_COMPLETE，否则说明配置有误：

   if (glCheckFramebufferStatus(GL_FRAMEBUFFER) != GL_FRAMEBUFFER_COMPLETE)
       std::cout << "Framebuffer is not complete!" << std::endl;
   

3. 移除循环中绑定FBO前的glClear操作，减少不必要的性能开销。

内容的提问来源于stack exchange，提问作者Subham Swostik Pradhan