如何使用PySide6切换QML渲染器为Qt Quick 2D渲染器

核心实现步骤 #

• 在实例化QGuiApplication/QApplication之前，设置环境变量QT_QUICK_BACKEND为software即可完成渲染接口切换，不需要额外调用QSGRendererInterface的底层配置接口。

完整代码示例 #

import sys
import os
from PySide6.QtGui import QGuiApplication
from PySide6.QtQml import QQmlApplicationEngine

if __name__ == "__main__":
    # 配置Qt Quick使用2D软件渲染器
    os.environ["QT_QUICK_BACKEND"] = "software"

    app = QGuiApplication(sys.argv)
    engine = QQmlApplicationEngine()
    engine.load("你的QML文件路径.qml")

    if not engine.rootObjects():
        sys.exit(-1)
    sys.exit(app.exec())

验证配置生效方法 #

• 应用启动后可通过如下代码输出当前使用的渲染接口：

from PySide6.QtQuick import QSGRendererInterface

current_api = engine.rendererInterface().graphicsApi()
print(current_api)
# 输出为 QSGRendererInterface.GraphicsApi.Software 即代表配置生效

注意事项 #

• 环境变量必须在Qt应用实例化之前设置，实例化后修改不会生效
• 2D软件渲染器兼容性更强，可解决大部分不同Windows版本下的硬件渲染异常问题，但性能略低于硬件加速渲染
• 该配置为全局生效，不需要对单个QML窗口单独设置

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