Qt6 Windows平台基于Direct3D RHI实现半透明窗口的问题

一、Direct3D后端实现半透明窗口 #

在Qt6 Windows默认的Direct3D RHI下，直接设置Window.color为带alpha的颜色无法生效，需要配合窗口属性和表面格式配置：

步骤1：修改C++代码配置窗口属性 #

在engine.load(url)之后，获取并配置QQuickWindow实例：

#include <QQuickWindow>

// ... 原有代码 ...

engine.load(url);

// 配置窗口属性
auto rootObjects = engine.rootObjects();
if (!rootObjects.isEmpty()) {
    QQuickWindow* window = qobject_cast<QQuickWindow*>(rootObjects.first());
    if (window) {
        // 启用半透明背景属性
        window->setAttribute(Qt::WA_TranslucentBackground);
        // 设置表面格式包含8位alpha通道（Direct3D必需）
        QSurfaceFormat format = window->format();
        format.setAlphaBufferSize(8);
        window->setFormat(format);
        // 若需要保留窗口边框，可跳过FramelessWindowHint；否则添加以避免边框干扰半透明
        // window->setFlags(window->flags() | Qt::FramelessWindowHint);
    }
}

步骤2：保留QML中的颜色设置 #

确保QML的Window保持原有配置：

Window {
    width: 640
    height: 480
    visible: true
    color: "#88000000"
}

二、消除OpenGL后端的白色闪烁 #

若坚持使用OpenGL后端，可通过延迟窗口显示、提前配置透明背景解决闪烁：

方法1：延迟窗口可见性直到渲染完成 #

C++端修改：

// ... 获取window实例后 ...

// 初始隐藏窗口
window->setVisible(false);
// 监听场景图初始化完成信号，再显示窗口
QObject::connect(window, &QQuickWindow::sceneGraphInitialized, [window]() {
    window->setVisible(true);
});

QML端配合：

将visible设为false（C++端已设置的话可省略）：

Window {
    width: 640
    height: 480
    visible: false
    color: "#88000000"
}

方法2：启用透明背景属性 #

在C++中为窗口添加WA_TranslucentBackground属性，避免初始化时显示白色背景：

window->setAttribute(Qt::WA_TranslucentBackground);

同时确保强制启用OpenGL后端：

// 在QGuiApplication初始化前设置
QQuickWindow::setSceneGraphBackend(QSGRendererInterface::OpenGL);

三、其他注意事项 #

• 若窗口需要边框，Direct3D方案下需额外处理边框的半透明（默认边框不支持alpha，建议用FramelessWindowHint配合自定义QML边框）
• 全屏模式下，Direct3D方案的兼容性更好，推荐优先使用
• Qt 6.5+版本对Direct3D半透明的支持有所优化，若使用旧版本建议升级

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