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
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
|
Name
ANGLE_device_vulkan
Name Strings
EGL_ANGLE_device_vulkan
Contributors
Peng Huang (penghuang 'at' google.com)
Shahbaz Youssefi (syoussefi 'at' google.com)
Contact
Peng Huang (penghuang 'at' google.com)
Status
Draft
Version
Version 1, Oct 28, 2021
Number
EGL Extension #XXX
Extension Type
EGL device extension
Dependencies
This extension is written against the language of EGL 1.5 as
modified by EGL_EXT_device_query.
EGL_EXT_device_query is required.
Overview
ANGLE has the ability to run GPU commands on a native Vulkan device.
This extension defines a mapping from an EGL device to a Vulkan
device, after it's queried from an EGL display.
IP Status
No known claims.
New Types
None.
New Procedures and Functions
void eglLockVulkanQueueANGLE(EGLDisplay dpy);
void eglUnlockVulkanQueueANGLE(EGLDisplay dpy);
New Tokens
Accepted as a queried <attribute> in eglQueryDeviceAttribEXT:
EGL_VULKAN_VERSION_ANGLE 0x34A8
EGL_VULKAN_INSTANCE_ANGLE 0x34A9
EGL_VULKAN_INSTANCE_EXTENSIONS_ANGLE 0x34AA
EGL_VULKAN_PHYSICAL_DEVICE_ANGLE 0x34AB
EGL_VULKAN_DEVICE_ANGLE 0x34AC
EGL_VULKAN_DEVICE_EXTENSIONS_ANGLE 0x34AD
EGL_VULKAN_FEATURES_ANGLE 0x34AE
EGL_VULKAN_QUEUE_ANGLE 0x34AF
EGL_VULKAN_QUEUE_FAMILIY_INDEX_ANGLE 0x34D0
EGL_VULKAN_GET_INSTANCE_PROC_ADDR 0x34D1
Add a new section 2.1.3 (Vulkan Devices) after 2.1.2 (Devices)
Somewhat analogous to an EGL device, a Vulkan device establishes a
namespace for Vulkan operations. In the Vulkan APIs, such devices are
represented by pointers. For more details, see the Vulkan
documentation.
Changes to section 3.2 (Devices)
Replace the paragraph immediately following the prototype for
eglQueryDeviceAttribEXT:
<attribute> may be EGL_VULKAN_VERSION_ANGLE.
On success, EGL_TRUE is returned, and the Vulkan versionbcorresponding to
the EGL device is returned in <value>. If the EGL device is not currently
associated with a Vulkan device and <attribute> is EGL_VULKAN_VERSION_ANGLE,
EGL_BAD_ATTRIBUTE is returned, and <value> is left unchanged.
<attribute> may be EGL_VULKAN_INSTANCE_ANGLE.
On success, EGL_TRUE is returned, and a valid Vulkan instance handle
VkInstance corresponding to the EGL device is returned in <value>.
This handle is compatible with Vulkan API functions. If the EGL device is
not currently associated with a Vulkan device and <attribute> is
EGL_VULKAN_INSTANCE_ANGLE, EGL_BAD_ATTRIBUTE is returned, and <value> is
left unchanged.
<attribute> may be EGL_VULKAN_INSTANCE_EXTENSIONS_ANGLE.
On success, EGL_TRUE is returned, and a pointer to a null terminated static
string array is returned in <value>. The array contains enabled Vulkan
instance extensions for the Vulkan device used by the display.
If the EGL device is not currently associated with a Vulkan device and
<attribute> is EGL_VULKAN_INSTANCE_EXTENSIONS_ANGLE, EGL_BAD_ATTRIBUTE is
returned, and <value> is left unchanged.
<attribute> may be EGL_VULKAN_PHYSICAL_DEVICE_ANGLE.
On success, EGL_TRUE is returned, and a valid Vulkan physical device handle
VkPhysicalDevice corresponding to the EGL device is returned in <value>.
This handle is compatible with Vulkan API functions. If the EGL device is
not currently associated with a Vulkan device and <attribute> is
EGL_VULKAN_PHYSICAL_DEVICE_ANGLE, EGL_BAD_ATTRIBUTE is returned,
and <value> is left unchanged.
<attribute> may be EGL_VULKAN_DEVICE_ANGLE.
On success, EGL_TRUE is returned, and a valid Vulkan device handle VkDevice
corresponding to the EGL device is returned in <value>. This handle is
compatible with Vulkan API functions. If the EGL device is not currently
associated with a Vulkan device and <attribute> is EGL_VULKAN_DEVICE_ANGLE,
EGL_BAD_ATTRIBUTE is returned, and <value> is left unchanged.
<attribute> may be EGL_VULKAN_DEVICE_EXTENSIONS_ANGLE.
On success, EGL_TRUE is returned, and a pointer to a null terminated static
string array is returned in <value>. The array contains enabled Vulkan
device extensions for the Vulkan device used by the display. If the EGL
device is not currently associated with a Vulkan device and <attribute> is
EGL_VULKAN_DEVICE_EXTENSIONS_ANGLE, EGL_BAD_ATTRIBUTE is returned, and
<value> is left unchanged.
<attribute> may be EGL_VULKAN_FEATURES_ANGLE.
On success, EGL_TRUE is returned, and a pointer to a static
VkPhysicalDeviceFeatures2KHR struct is returned in <value>. The structure
contains enabled Vulkan device features for the Vulkan device used by the
display. If the EGL device is not currently associated with a Vulkan device
and <attribute> is EGL_VULKAN_FEATURES_ANGLE, EGL_BAD_ATTRIBUTE is returned,
and <value> is left unchanged.
<attribute> may be EGL_VULKAN_QUEUE_ANGLE.
On success, EGL_TRUE is returned, and a valid Vulkan device queue handle
VkQueue corresponding to the EGL device is returned in <value>. This handle
is compatible with Vulkan API functions. If the EGL device is not currently
associated with a Vulkan device and <attribute> is EGL_VULKAN_QUEUE_ANGLE,
EGL_BAD_ATTRIBUTE is returned, and <value> is left unchanged.
<attribute> may be EGL_VULKAN_QUEUE_FAMILIY_INDEX_ANGLE.
On success, EGL_TRUE is returned, and the Vulkan queue familiy index
corresponding to the EGL device is returned in <value>. If the EGL device
is not currently associated with a Vulkan device and <attribute> is
EGL_VULKAN_QUEUE_FAMILIY_INDEX_ANGLE, EGL_BAD_ATTRIBUTE is returned, and
<value> is left unchanged.
<attribute> may be EGL_VULKAN_GET_INSTANCE_PROC_ADDR.
On success, EGL_TRUE is returned, and the vkGetInstanceProcAddr function
pointer corresponding to the EGL device is returned in <value>. If the EGL
device is not currently associated with a Vulkan device and <attribute> is
EGL_VULKAN_GET_INSTANCE_PROC_ADDR, EGL_BAD_ATTRIBUTE is returned, and
<value> is left unchanged.
Add the following after the eglQueryDeviceAttribEXT entry point:
The Vulkan queue queried via EGL_VULKAN_QUEUE_ANGLE can be locked using
void eglLockVulkanQueueANGLE(EGLDisplay dpy);
This function provides exclusive access to the Vulkan queue to the caller,
as if an internal mutex that is used to protect the queue is locked.
If 'dpy' is not a valid display an EGL_BAD_DISPLAY error is generated.
No error is generated if the EGL device is not currently associated with a
Vulkan device, in which case the function does nothing.
Each call to eglLockVulkanQueueANGLE must be paired with a following
eglUnlockVulkanQueueANGLE on the same thread, otherwise behavior is
undefined.
void eglUnlockVulkanQueueANGLE(EGLDisplay dpy);
This function releases exclusive access to the Vulkan queue that was
previously acquired via eglLockVulkanQueueANGLE, as if an internal mutex
that is used to protect the queue is unlocked.
If 'dpy' is not a valid display an EGL_BAD_DISPLAY error is generated.
No error is generated if the EGL device is not currently associated with a
Vulkan device, in which case the function does nothing.
Each call to eglUnlockVulkanQueueANGLE must be preceeded by a call to
eglLockVulkanQueueANGLE on the same thread, otherwise behavior is
undefined.
Issues
None
Revision History
Version 1, Oct 28, 2021 (Peng Huang)
- Initial Draft
Version 2, Dec 27, 2024 (Shahbaz Youssefi)
- Add entry points for Vulkan queue lock/unlock
|
