3 * Copyright 2017 Intel Corporation
5 * Permission is hereby granted, free of charge, to any person obtaining a
6 * copy of this software and associated documentation files (the
7 * "Software"), to deal in the Software without restriction, including
8 * without limitation the rights to use, copy, modify, merge, publish,
9 * distribute, sub license, and/or sell copies of the Software, and to
10 * permit persons to whom the Software is furnished to do so, subject to
11 * the following conditions:
13 * The above copyright notice and this permission notice (including the
14 * next paragraph) shall be included in all copies or substantial portions
17 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
18 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
19 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
20 * IN NO EVENT SHALL VMWARE AND/OR ITS SUPPLIERS BE LIABLE FOR
21 * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
22 * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
23 * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
30 import xml
.etree
.cElementTree
as et
32 from mako
.template
import Template
34 MAX_API_VERSION
= '1.1.82'
37 def __init__(self
, name
, ext_version
, enable
):
39 self
.ext_version
= int(ext_version
)
43 self
.enable
= 'false';
47 # On Android, we disable all surface and swapchain extensions. Android's Vulkan
48 # loader implements VK_KHR_surface and VK_KHR_swapchain, and applications
49 # cannot access the driver's implementation. Moreoever, if the driver exposes
50 # the those extension strings, then tests dEQP-VK.api.info.instance.extensions
51 # and dEQP-VK.api.info.device fail due to the duplicated strings.
53 Extension('VK_KHR_bind_memory2', 1, True),
54 Extension('VK_KHR_create_renderpass2', 1, True),
55 Extension('VK_KHR_dedicated_allocation', 1, True),
56 Extension('VK_KHR_get_display_properties2', 1, 'VK_USE_PLATFORM_DISPLAY_KHR'),
57 Extension('VK_KHR_get_memory_requirements2', 1, True),
58 Extension('VK_KHR_get_physical_device_properties2', 1, True),
59 Extension('VK_KHR_get_surface_capabilities2', 1, 'TU_HAS_SURFACE'),
60 Extension('VK_KHR_maintenance1', 1, True),
61 Extension('VK_KHR_maintenance2', 1, True),
62 Extension('VK_KHR_maintenance3', 1, True),
63 Extension('VK_KHR_surface', 25, 'TU_HAS_SURFACE'),
64 Extension('VK_KHR_swapchain', 68, 'TU_HAS_SURFACE'),
65 Extension('VK_KHR_wayland_surface', 6, 'VK_USE_PLATFORM_WAYLAND_KHR'),
66 Extension('VK_KHR_xcb_surface', 6, 'VK_USE_PLATFORM_XCB_KHR'),
67 Extension('VK_KHR_xlib_surface', 6, 'VK_USE_PLATFORM_XLIB_KHR'),
68 Extension('VK_KHR_display', 23, 'VK_USE_PLATFORM_DISPLAY_KHR'),
69 Extension('VK_EXT_direct_mode_display', 1, 'VK_USE_PLATFORM_DISPLAY_KHR'),
70 Extension('VK_EXT_acquire_xlib_display', 1, 'VK_USE_PLATFORM_XLIB_XRANDR_EXT'),
71 Extension('VK_EXT_display_surface_counter', 1, 'VK_USE_PLATFORM_DISPLAY_KHR'),
72 Extension('VK_EXT_display_control', 1, 'VK_USE_PLATFORM_DISPLAY_KHR'),
73 Extension('VK_EXT_debug_report', 9, True),
74 Extension('VK_KHR_external_memory_capabilities', 1, True),
78 def __init__(self
, string
):
79 split
= string
.split('.')
80 self
.major
= int(split
[0])
81 self
.minor
= int(split
[1])
83 assert len(split
) == 3
84 self
.patch
= int(split
[2])
88 # Sanity check. The range bits are required by the definition of the
89 # VK_MAKE_VERSION macro
90 assert self
.major
< 1024 and self
.minor
< 1024
91 assert self
.patch
is None or self
.patch
< 4096
92 assert(str(self
) == string
)
95 ver_list
= [str(self
.major
), str(self
.minor
)]
96 if self
.patch
is not None:
97 ver_list
.append(str(self
.patch
))
98 return '.'.join(ver_list
)
100 def c_vk_version(self
):
101 patch
= self
.patch
if self
.patch
is not None else 0
102 ver_list
= [str(self
.major
), str(self
.minor
), str(patch
)]
103 return 'VK_MAKE_VERSION(' + ', '.join(ver_list
) + ')'
106 # This is just an expansion of VK_VERSION
107 patch
= self
.patch
if self
.patch
is not None else 0
108 return (self
.major
<< 22) |
(self
.minor
<< 12) | patch
110 def __gt__(self
, other
):
111 # If only one of them has a patch version, "ignore" it by making
112 # other's patch version match self.
113 if (self
.patch
is None) != (other
.patch
is None):
114 other
= copy
.copy(other
)
115 other
.patch
= self
.patch
117 return self
.__int
_ver
() > other
.__int
_ver
()
119 MAX_API_VERSION
= VkVersion(MAX_API_VERSION
)
121 def _init_exts_from_xml(xml
):
122 """ Walk the Vulkan XML and fill out extra extension information. """
127 for ext
in EXTENSIONS
:
128 ext_name_map
[ext
.name
] = ext
130 for ext_elem
in xml
.findall('.extensions/extension'):
131 ext_name
= ext_elem
.attrib
['name']
132 if ext_name
not in ext_name_map
:
135 ext
= ext_name_map
[ext_name
]
136 ext
.type = ext_elem
.attrib
['type']
138 _TEMPLATE_H
= Template(COPYRIGHT
+ """
139 #ifndef TU_EXTENSIONS_H
140 #define TU_EXTENSIONS_H
143 TU_INSTANCE_EXTENSION_COUNT = ${len(instance_extensions)},
144 TU_DEVICE_EXTENSION_COUNT = ${len(device_extensions)},
147 struct tu_instance_extension_table {
149 bool extensions[TU_INSTANCE_EXTENSION_COUNT];
151 %for ext in instance_extensions:
152 bool ${ext.name[3:]};
158 struct tu_device_extension_table {
160 bool extensions[TU_DEVICE_EXTENSION_COUNT];
162 %for ext in device_extensions:
163 bool ${ext.name[3:]};
169 extern const VkExtensionProperties tu_instance_extensions[TU_INSTANCE_EXTENSION_COUNT];
170 extern const VkExtensionProperties tu_device_extensions[TU_DEVICE_EXTENSION_COUNT];
171 extern const struct tu_instance_extension_table tu_supported_instance_extensions;
174 struct tu_physical_device;
176 void tu_fill_device_extension_table(const struct tu_physical_device *device,
177 struct tu_device_extension_table* table);
181 _TEMPLATE_C
= Template(COPYRIGHT
+ """
182 #include "tu_private.h"
186 /* Convert the VK_USE_PLATFORM_* defines to booleans */
187 %for platform in ['ANDROID_KHR', 'WAYLAND_KHR', 'XCB_KHR', 'XLIB_KHR', 'DISPLAY_KHR', 'XLIB_XRANDR_EXT']:
188 #ifdef VK_USE_PLATFORM_${platform}
189 # undef VK_USE_PLATFORM_${platform}
190 # define VK_USE_PLATFORM_${platform} true
192 # define VK_USE_PLATFORM_${platform} false
196 /* And ANDROID too */
199 # define ANDROID true
201 # define ANDROID false
204 #define TU_HAS_SURFACE (VK_USE_PLATFORM_WAYLAND_KHR || \\
205 VK_USE_PLATFORM_XCB_KHR || \\
206 VK_USE_PLATFORM_XLIB_KHR || \\
207 VK_USE_PLATFORM_DISPLAY_KHR)
210 const VkExtensionProperties tu_instance_extensions[TU_INSTANCE_EXTENSION_COUNT] = {
211 %for ext in instance_extensions:
212 {"${ext.name}", ${ext.ext_version}},
216 const VkExtensionProperties tu_device_extensions[TU_DEVICE_EXTENSION_COUNT] = {
217 %for ext in device_extensions:
218 {"${ext.name}", ${ext.ext_version}},
222 const struct tu_instance_extension_table tu_supported_instance_extensions = {
223 %for ext in instance_extensions:
224 .${ext.name[3:]} = ${ext.enable},
228 void tu_fill_device_extension_table(const struct tu_physical_device *device,
229 struct tu_device_extension_table* table)
231 %for ext in device_extensions:
232 table->${ext.name[3:]} = ${ext.enable};
236 VkResult tu_EnumerateInstanceVersion(
237 uint32_t* pApiVersion)
239 *pApiVersion = ${MAX_API_VERSION.c_vk_version()};
244 tu_physical_device_api_version(struct tu_physical_device *dev)
246 return VK_MAKE_VERSION(1, 1, 82);
250 if __name__
== '__main__':
251 parser
= argparse
.ArgumentParser()
252 parser
.add_argument('--out-c', help='Output C file.', required
=True)
253 parser
.add_argument('--out-h', help='Output H file.', required
=True)
254 parser
.add_argument('--xml',
255 help='Vulkan API XML file.',
259 args
= parser
.parse_args()
261 for filename
in args
.xml_files
:
262 _init_exts_from_xml(filename
)
264 for ext
in EXTENSIONS
:
265 assert ext
.type == 'instance' or ext
.type == 'device'
268 'MAX_API_VERSION': MAX_API_VERSION
,
269 'instance_extensions': [e
for e
in EXTENSIONS
if e
.type == 'instance'],
270 'device_extensions': [e
for e
in EXTENSIONS
if e
.type == 'device'],
273 with
open(args
.out_c
, 'w') as f
:
274 f
.write(_TEMPLATE_C
.render(**template_env
))
275 with
open(args
.out_h
, 'w') as f
:
276 f
.write(_TEMPLATE_H
.render(**template_env
))