aboutsummaryrefslogtreecommitdiffstats
path: root/src/quick/items/qquickrendercontrol.cpp
diff options
context:
space:
mode:
authorLaszlo Agocs <laszlo.agocs@qt.io>2021-01-15 18:38:06 +0100
committerLaszlo Agocs <laszlo.agocs@qt.io>2021-01-21 10:19:01 +0100
commit3fadfb2c3fa7d4b22d0d0269c645c1086fa56619 (patch)
treea5bf744b7a54a20fb793b25479648e3f94bf1137 /src/quick/items/qquickrendercontrol.cpp
parent6a156540004c9e6260490bacb6544322d22d9d32 (diff)
Expose the list of preferred instance extensions to rendercontrol users
As all QRhi stuff is private, it needs to have a public counterpart in Qt Quick in order to fully support the case of Vulkan-based QQuickRenderControl usage. Change-Id: Iaf9a7aa56022acd31af6ebf16de6b83a04966ff4 Reviewed-by: Andy Nichols <andy.nichols@qt.io>
Diffstat (limited to 'src/quick/items/qquickrendercontrol.cpp')
-rw-r--r--src/quick/items/qquickrendercontrol.cpp13
1 files changed, 8 insertions, 5 deletions
diff --git a/src/quick/items/qquickrendercontrol.cpp b/src/quick/items/qquickrendercontrol.cpp
index c7a1ad973d..d71af669f0 100644
--- a/src/quick/items/qquickrendercontrol.cpp
+++ b/src/quick/items/qquickrendercontrol.cpp
@@ -273,10 +273,13 @@ int QQuickRenderControl::samples() const
To configure which device extensions to enable (for example, for Vulkan),
call QQuickWindow::setGraphicsConfiguration() before this function.
- \note When using Vulkan, QQuickRenderControl does not create a
- QVulkanInstance automatically. Rather, it is the application's
- responsibility to create a suitable QVulkanInstance and
- \l{QWindow::setVulkanInstance()}{associate it} with the QQuickWindow.
+ \note When using Vulkan, QQuickRenderControl does not create a QVulkanInstance
+ automatically. Rather, it is the application's responsibility to create a
+ suitable QVulkanInstance and \l{QWindow::setVulkanInstance()}{associate it} with
+ the QQuickWindow. Before initializing the QVulkanInstance, it is strongly
+ encouraged to query the list of Qt Quick's desired instance extensions by calling
+ the static function QQuickGraphicsConfiguration::preferredInstanceExtensions()
+ and to pass the returned list to QVulkanInstance::setExtensions().
Returns \c true on success, \c false otherwise.
@@ -285,7 +288,7 @@ int QQuickRenderControl::samples() const
\since 6.0
- \sa QQuickRenderTarget, QQuickGraphicsDevice
+ \sa QQuickRenderTarget, QQuickGraphicsDevice, QQuickGraphicsConfiguration::preferredInstanceExtensions()
*/
bool QQuickRenderControl::initialize()
{