Scene Graph Adaptations
Originally, Qt Quick always relied on OpenGL (OpenGL ES 2.0 or OpenGL 2.0) to parse the scene graph and render the results to a render target. From Qt 5.8 onwards, Qt Quick also supports rendering in software and with Direct3D 12.
The default rendering backend is still OpenGL, but in Qt builds with OpenGL support disabled, the default is the software renderer. You can override this in one of two ways:
- Use an environment variable - Set the
QT_QUICK_BACKENDor the legacy
QMLSCENE_DEVICEenvironment variable before launching applications.
- Use a C++ API - Call QQuickWindow::setSceneGraphBackend() early on in the application's main() function.
The following backends are supported:
- OpenGL - Request with the
""string or the QSGRendererInterface::OpenGL enum value.
- Software - Request with the
"software"string or the QSGRendererInterface::Software enum value.
- Direct3D 12 - Request with the
"d3d12"string or the QSGRendererInterface::Direct3D12 enum value.
- OpenVG - Request with the
"openvg"string or the QSGRendererInterface::OpenVG enum value.
To find out which backend is in use, you can enable basic scene graph information logging via the
QSG_INFO environment variable or the
qt.scenegraph.general logging category. This results in some information being printed onto the debug output, during application startup.
Note: Typically, adaptations other than OpenGL come with a set of limitations as they are unlikely to provide a feature set that's 100% compatible with OpenGL. However, these adaptations may provide their own specific advantages in certain areas. For more information on the various adaptations, refer to the sections below.
The OpenGL adaptation is the default adaptation, which is capable of providing the full Qt Quick 2 feature set. For more details, see OpenGL Adaptation.
The OpenVG adaptation is an alternative renderer for Qt Quick 2 that renders the contents of the scene graph using OpenVG commands to provide hardware-accelerated 2D vector and raster graphics. For more details, see OpenVG Adaptation.
© 2020 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.