1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
|
// Copyright (C) 2017 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
#include <private/qvulkanfunctions_p.h>
QT_BEGIN_NAMESPACE
/*!
\class QVulkanFunctions
\since 5.10
\ingroup painting-3D
\inmodule QtGui
\wrapper
\brief The QVulkanFunctions class provides cross-platform access to the
instance level core Vulkan 1.3 API.
Qt and Qt applications do not link to any Vulkan libraries by default.
Instead, all functions are resolved dynamically at run time. Each
QVulkanInstance provides a QVulkanFunctions object retrievable via
QVulkanInstance::functions(). This does not contain device level functions
in order to avoid the potential overhead of an internal dispatching.
Instead, functions that rely on a device, or a dispatchable child object of
a device, are exposed via QVulkanDeviceFunctions and
QVulkanInstance::deviceFunctions(). QVulkanFunctions and
QVulkanDeviceFunctions together provides access to the full core Vulkan
API, excluding any extensions.
\note QVulkanFunctions instances cannot be constructed directly.
The typical usage is the following:
\snippet code/src_gui_vulkan_qvulkanfunctions.cpp 0
\note Windowing system interface (WSI) specifics and extensions are
excluded. This class only covers core Vulkan commands, with the exception
of instance creation, destruction, and function resolving, since such
functionality is covered by QVulkanInstance itself.
To access additional functions, applications can use
QVulkanInstance::getInstanceProcAddr() and vkGetDeviceProcAddr().
Applications can also decide to link to a Vulkan library directly, as
platforms with an appropriate loader will typically export function symbols
for the core commands. See
\l{https://www.khronos.org/registry/vulkan/specs/1.0/man/html/vkGetInstanceProcAddr.html}{the
man page for vkGetInstanceProcAddr} for more information.
\note The member function prototypes for Vulkan 1.1, 1.2, and 1.3 commands
are \c ifdefed with the appropriate \c{VK_VERSION_1_x} that is defined by
the Vulkan headers. As such, these functions will only be callable by an
application when the system's (on which the application is built) Vulkan
header is new enough and it contains 1.1, 1.2, or 1.3 Vulkan API
definitions. When building Qt from source, this has an additional
consequence: the Vulkan headers on the build environment must also be 1.1,
1.2, and 1.3 compatible to get a Qt build that supports resolving
the 1.1, 1.2, and 1.3 API commands. If neither of these conditions is met,
applications will only be able to call the Vulkan 1.0 commands through
QVulkanFunctions and QVulkanDeviceFunctions.
\sa QVulkanInstance, QVulkanDeviceFunctions, QWindow::setVulkanInstance(), QWindow::setSurfaceType()
*/
/*!
\class QVulkanDeviceFunctions
\since 5.10
\ingroup painting-3D
\inmodule QtGui
\wrapper
\brief The QVulkanDeviceFunctions class provides cross-platform access to
the device level core Vulkan 1.3 API.
Qt and Qt applications do not link to any Vulkan libraries by default.
Instead, all functions are resolved dynamically at run time. Each
QVulkanInstance provides a QVulkanFunctions object retrievable via
QVulkanInstance::functions(). This does not contain device level functions
in order to avoid the potential overhead of an internal dispatching.
Instead, functions that rely on a device, or a dispatchable child object of
a device, are exposed via QVulkanDeviceFunctions and
QVulkanInstance::deviceFunctions(). QVulkanFunctions and
QVulkanDeviceFunctions together provides access to the full core Vulkan
API, excluding any extensions.
\note QVulkanDeviceFunctions instances cannot be constructed directly.
The typical usage is the following:
\snippet code/src_gui_vulkan_qvulkanfunctions.cpp 1
The QVulkanDeviceFunctions object specific to the provided VkDevice is
created when QVulkanInstance::deviceFunctions() is first called with the
device in question. The object is then cached internally.
To access additional functions, applications can use
QVulkanInstance::getInstanceProcAddr() and vkGetDeviceProcAddr().
Applications can also decide to link to a Vulkan library directly, as many
implementations export function symbols for the core commands. See
\l{https://www.khronos.org/registry/vulkan/specs/1.0/man/html/vkGetInstanceProcAddr.html}{the
man page for vkGetInstanceProcAddr} for more information.
\sa QVulkanInstance, QVulkanFunctions, QWindow::setVulkanInstance(), QWindow::setSurfaceType()
*/
/*
Constructs a new QVulkanFunctions for \a inst.
\internal
*/
QVulkanFunctions::QVulkanFunctions(QVulkanInstance *inst)
: d_ptr(new QVulkanFunctionsPrivate(inst))
{
}
/*
Destructor.
*/
QVulkanFunctions::~QVulkanFunctions()
{
}
/*
Constructs a new QVulkanDeviceFunctions for \a inst and the given \a device.
\internal
*/
QVulkanDeviceFunctions::QVulkanDeviceFunctions(QVulkanInstance *inst, VkDevice device)
: d_ptr(new QVulkanDeviceFunctionsPrivate(inst, device))
{
}
/*
Destructor.
*/
QVulkanDeviceFunctions::~QVulkanDeviceFunctions()
{
}
QT_END_NAMESPACE
|
