如何创建支持alpha通道的QOffscreenSurface？渲染透明效果异常如何解决

解决方案 #

1. 显式设置FBO（帧缓冲对象）的alpha格式
   你当前只给QSurfaceFormat开了alpha通道，但离屏渲染用到的QOpenGLFramebufferObject默认可能不带alpha通道，需要在创建时显式指定带alpha的内部格式，配合你开启的sRGB颜色空间，配置代码如下：

QOpenGLFramebufferObjectFormat fboFormat;
// 开启sRGB + 8位alpha通道，和你的surface配置对应
fboFormat.setInternalTextureFormat(GL_SRGB8_ALPHA8);
fboFormat.setAttachment(QOpenGLFramebufferObject::CombinedDepthStencil);
// 用该格式创建FBO
QOpenGLFramebufferObject renderFbo(viewportWidth, viewportHeight, fboFormat);

2. 确认渲染结果读取格式正确
   如果你通过toImage()方法读取FBO的渲染结果，需要显式转换为带alpha通道的QImage格式，避免Qt自动丢弃alpha信息：

renderFbo.bind();
QImage renderResult = renderFbo.toImage().convertToFormat(QImage::Format_RGBA8888);
renderFbo.release();

如果要在Qt控件上直接展示渲染结果，需要给对应控件开启透明背景属性：

displayWidget->setAttribute(Qt::WA_TranslucentBackground);
displayWidget->setAutoFillBackground(false);

3. 提前设置全局默认SurfaceFormat
   Qt 6中QSurfaceFormat的配置需要在创建QApplication实例之前就设置为全局默认格式，否则后续创建的surface、FBO不会继承你自定义的配置：

int main(int argc, char *argv[])
{
    // 先配置format
    QSurfaceFormat surfaceFormat;
    surfaceFormat.setColorSpace(QSurfaceFormat::ColorSpace::sRGBColorSpace);
    surfaceFormat.setRenderableType(QSurfaceFormat::RenderableType::OpenGL);
    surfaceFormat.setMajorVersion(4);
    surfaceFormat.setMinorVersion(3);
    surfaceFormat.setAlphaBufferSize(8);
    // 设为全局默认
    QSurfaceFormat::setDefaultFormat(surfaceFormat);

    // 再创建QApplication
    QApplication a(argc, argv);
    // 后续业务逻辑
    ...
}

你补充测试里的混合、清屏配置都是正确的，调整以上三处配置即可解决alpha通道不生效的问题。

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