Qt OpenGL QGLFramebufferObject帧缓冲不完整附件远端报错适配问询

根因定位 #

问题核心是不同NVIDIA驱动版本对OpenGL格式的支持度差异：

• 本地460.91驱动支持OpenGL核心模式下无显式位宽声明的GL_RED/GL_RGBA作为纹理内部格式，会自动匹配默认通道位宽
• 远端435.21驱动的GL上下文如果是兼容性配置，不接受无位宽声明的内部格式，且单通道格式需要用GL_LUMINANCE代替GL_RED，直接用原写法会导致FBO附着不完整。

修复方案 #

1. 新增格式兼容性检测逻辑 #

先实现工具函数自动测试当前GL环境支持的FBO格式，按优先级自动降级适配：

#include <QList>
// 按优先级排序的候选格式列表，优先用高版本标准格式，不支持自动降级到兼容格式
struct FormatCandidate {
    GlowFormat glowFmt;
    GLint internalFmt; // 内部格式必须带位宽声明
    GLenum dataFmt; // 数据传输格式
};
static const QList<FormatCandidate> g_formatCandidates = {
    {GLOW_R, GL_R8, GL_RED},
    {GLOW_R, GL_LUMINANCE, GL_LUMINANCE}, // 老版本GL单通道兼容格式
    {GLOW_RGBA, GL_RGBA8, GL_RGBA},
    {GLOW_RGBA, GL_RGBA, GL_RGBA} // 兜底通用格式
};

// 检测指定格式是否可用于创建FBO
bool isFboFormatSupported(int width, int height, GLint internalFmt, GLenum dataFmt, GLenum filter) {
    GLuint tempTex = 0, tempFbo = 0;
    bool supported = false;

    glGenTextures(1, &tempTex);
    glBindTexture(GL_TEXTURE_2D, tempTex);
    glTexImage2D(GL_TEXTURE_2D, 0, internalFmt, width, height, 0, dataFmt, GL_UNSIGNED_BYTE, nullptr);
    glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, filter);
    glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, filter);

    glGenFramebuffers(1, &tempFbo);
    glBindFramebuffer(GL_FRAMEBUFFER, tempFbo);
    glFramebufferTexture2D(GL_FRAMEBUFFER, GL_COLOR_ATTACHMENT0, GL_TEXTURE_2D, tempTex, 0);
    
    if (glCheckFramebufferStatus(GL_FRAMEBUFFER) == GL_FRAMEBUFFER_COMPLETE) {
        supported = true;
    }

    // 清理临时资源
    glDeleteFramebuffers(1, &tempFbo);
    glDeleteTextures(1, &tempTex);
    return supported;
}

2. 修改CopyMultiTexture的格式选择逻辑 #

创建纹理前遍历候选格式，选择当前环境第一个可用的格式：

int GlowFramebuffer::CopyMultiTexture(GlowFilter filter, GlowFormat format) {
    GLint width = m_framebuffer->width(); 
    GLint height = m_framebuffer->height();
    GLenum glfilter = (filter == GLOW_NEAREST) ? GL_NEAREST : GL_LINEAR;

    // 自动匹配兼容格式
    GLint selectedInternalFmt;
    GLenum selectedDataFmt;
    bool findValidFormat = false;
    for (const auto& cand : g_formatCandidates) {
        if (cand.glowFmt != format) continue;
        if (isFboFormatSupported(width, height, cand.internalFmt, cand.dataFmt, glfilter)) {
            selectedInternalFmt = cand.internalFmt;
            selectedDataFmt = cand.dataFmt;
            findValidFormat = true;
            break;
        }
    }
    if (!findValidFormat) {
        qCritical() << "No supported FBO format found in current GL environment";
        return 0;
    }

    GLuint FramebufferName = 0;
    glGenFramebuffers(1, &FramebufferName);
    glBindFramebuffer(GL_FRAMEBUFFER, FramebufferName); 

    GLuint renderedTexture;
    glGenTextures(1, &renderedTexture);
    glBindTexture(GL_TEXTURE_2D, renderedTexture);
    // 替换原glformat为匹配到的兼容格式
    glTexImage2D(GL_TEXTURE_2D, 0, selectedInternalFmt, width, height, 0, selectedDataFmt, GL_UNSIGNED_BYTE, 0);
    glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, glfilter);
    glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, glfilter);
    glFramebufferTexture2D(GL_FRAMEBUFFER, GL_COLOR_ATTACHMENT0, GL_TEXTURE_2D, renderedTexture, 0);

    GLenum DrawBuffers[1] = {GL_COLOR_ATTACHMENT0};
    glDrawBuffers(1, DrawBuffers);

    GLenum status = glCheckFramebufferStatus(GL_FRAMEBUFFER);
    if (status != GL_FRAMEBUFFER_COMPLETE) {
        qCritical() << "Error with framebuffer!";
        glDeleteTextures(1, &renderedTexture);
        glDeleteFramebuffers(1, &FramebufferName);
        return 0;
    }

    GLuint handle = m_framebuffer->handle();
    GLClear();

    glBindFramebuffer(GL_DRAW_FRAMEBUFFER, FramebufferName);
    glBindFramebuffer(GL_READ_FRAMEBUFFER, handle);
    // 删除多余的glDrawBuffer(GL_BACK)，该行会强制把绘制缓冲区指向默认窗口后缓冲，导致FBO绘制失效
    glBlitFramebuffer(0, 0, width, height, 0, 0, width, height, GL_COLOR_BUFFER_BIT, GL_NEAREST);
   
    glBindTexture(GL_TEXTURE_2D, 0);
    glBindFramebuffer(GL_FRAMEBUFFER, handle);
    glDeleteFramebuffers(1, &FramebufferName);

    return renderedTexture;
}

3. 同步修改GlowFramebuffer::Create的格式逻辑 #

将单通道格式设置逻辑和上面的检测逻辑对齐：

void GlowFramebuffer::Create(int width, int height) {
    QGLFramebufferObjectFormat format;
    if (m_format == GLOW_R) {
        // 优先用GL_R8，不支持自动降级到GL_LUMINANCE
        if (isFboFormatSupported(width, height, GL_R8, GL_RED, GL_NEAREST)) {
            format.setInternalTextureFormat(GL_R8);
        } else {
            format.setInternalTextureFormat(GL_LUMINANCE);
        }
        m_framebuffer = QSharedPointer<QGLFramebufferObject>(new QGLFramebufferObject(width, height, format));
    } else if (m_attachment == GLOW_DEPTH_STENCIL) {
        format.setAttachment(QGLFramebufferObject::CombinedDepthStencil);
        m_framebuffer = QSharedPointer<QGLFramebufferObject>(new QGLFramebufferObject(width, height, format));
    } else {
        m_framebuffer = QSharedPointer<QGLFramebufferObject>(new QGLFramebufferObject(width, height));
    }
    SetClearColor(m_clear_color); 
}

4. 额外适配点 #

图像处理部分使用的QImage::Format_RGBA8888要和FBO的RGBA格式通道顺序对齐，确认QGLWidget::convertToGLFormat转换后的格式和你FBO的RGBA格式匹配，避免纹理上传时出现通道错位。

内容的提问来源于stack exchange，提问作者transcendnation