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 def _bool_to_c_expr(b
):
40 def __init__(self
, name
, ext_version
, enable
):
42 self
.ext_version
= int(ext_version
)
43 self
.enable
= _bool_to_c_expr(enable
)
46 def __init__(self
, version
, enable
):
47 self
.version
= version
48 self
.enable
= _bool_to_c_expr(enable
)
50 API_PATCH_VERSION
= 96
52 # Supported API versions. Each one is the maximum patch version for the given
53 # version. Version come in increasing order and each version is available if
54 # it's provided "enable" condition is true and all previous versions are
57 ApiVersion('1.0', True),
59 # DRM_IOCTL_SYNCOBJ_WAIT is required for VK_KHR_external_fence which is a
60 # required core feature in Vulkan 1.1
61 ApiVersion('1.1', 'device->has_syncobj_wait'),
64 MAX_API_VERSION
= None # Computed later
66 # On Android, we disable all surface and swapchain extensions. Android's Vulkan
67 # loader implements VK_KHR_surface and VK_KHR_swapchain, and applications
68 # cannot access the driver's implementation. Moreoever, if the driver exposes
69 # the those extension strings, then tests dEQP-VK.api.info.instance.extensions
70 # and dEQP-VK.api.info.device fail due to the duplicated strings.
72 Extension('VK_KHR_8bit_storage', 1, 'device->info.gen >= 8'),
73 Extension('VK_KHR_16bit_storage', 1, 'device->info.gen >= 8'),
74 Extension('VK_KHR_bind_memory2', 1, True),
75 Extension('VK_KHR_create_renderpass2', 1, True),
76 Extension('VK_KHR_dedicated_allocation', 1, True),
77 Extension('VK_KHR_depth_stencil_resolve', 1, True),
78 Extension('VK_KHR_descriptor_update_template', 1, True),
79 Extension('VK_KHR_device_group', 1, True),
80 Extension('VK_KHR_device_group_creation', 1, True),
81 Extension('VK_KHR_display', 23, 'VK_USE_PLATFORM_DISPLAY_KHR'),
82 Extension('VK_KHR_draw_indirect_count', 1, True),
83 Extension('VK_KHR_driver_properties', 1, True),
84 Extension('VK_KHR_external_fence', 1,
85 'device->has_syncobj_wait'),
86 Extension('VK_KHR_external_fence_capabilities', 1, True),
87 Extension('VK_KHR_external_fence_fd', 1,
88 'device->has_syncobj_wait'),
89 Extension('VK_KHR_external_memory', 1, True),
90 Extension('VK_KHR_external_memory_capabilities', 1, True),
91 Extension('VK_KHR_external_memory_fd', 1, True),
92 Extension('VK_KHR_external_semaphore', 1, True),
93 Extension('VK_KHR_external_semaphore_capabilities', 1, True),
94 Extension('VK_KHR_external_semaphore_fd', 1, True),
95 Extension('VK_KHR_get_display_properties2', 1, 'VK_USE_PLATFORM_DISPLAY_KHR'),
96 Extension('VK_KHR_get_memory_requirements2', 1, True),
97 Extension('VK_KHR_get_physical_device_properties2', 1, True),
98 Extension('VK_KHR_get_surface_capabilities2', 1, 'ANV_HAS_SURFACE'),
99 Extension('VK_KHR_image_format_list', 1, True),
100 Extension('VK_KHR_incremental_present', 1, 'ANV_HAS_SURFACE'),
101 Extension('VK_KHR_maintenance1', 1, True),
102 Extension('VK_KHR_maintenance2', 1, True),
103 Extension('VK_KHR_maintenance3', 1, True),
104 Extension('VK_KHR_multiview', 1, True),
105 Extension('VK_KHR_push_descriptor', 1, True),
106 Extension('VK_KHR_relaxed_block_layout', 1, True),
107 Extension('VK_KHR_sampler_mirror_clamp_to_edge', 1, True),
108 Extension('VK_KHR_sampler_ycbcr_conversion', 1, True),
109 Extension('VK_KHR_shader_draw_parameters', 1, True),
110 Extension('VK_KHR_storage_buffer_storage_class', 1, True),
111 Extension('VK_KHR_surface', 25, 'ANV_HAS_SURFACE'),
112 Extension('VK_KHR_swapchain', 68, 'ANV_HAS_SURFACE'),
113 Extension('VK_KHR_variable_pointers', 1, True),
114 Extension('VK_KHR_wayland_surface', 6, 'VK_USE_PLATFORM_WAYLAND_KHR'),
115 Extension('VK_KHR_xcb_surface', 6, 'VK_USE_PLATFORM_XCB_KHR'),
116 Extension('VK_KHR_xlib_surface', 6, 'VK_USE_PLATFORM_XLIB_KHR'),
117 Extension('VK_EXT_acquire_xlib_display', 1, 'VK_USE_PLATFORM_XLIB_XRANDR_EXT'),
118 Extension('VK_EXT_buffer_device_address', 1,
119 'device->use_softpin && device->info.gen >= 8'),
120 Extension('VK_EXT_calibrated_timestamps', 1, True),
121 Extension('VK_EXT_conditional_rendering', 1, 'device->info.gen >= 8 || device->info.is_haswell'),
122 Extension('VK_EXT_debug_report', 8, True),
123 Extension('VK_EXT_depth_clip_enable', 1, True),
124 Extension('VK_EXT_direct_mode_display', 1, 'VK_USE_PLATFORM_DISPLAY_KHR'),
125 Extension('VK_EXT_display_control', 1, 'VK_USE_PLATFORM_DISPLAY_KHR'),
126 Extension('VK_EXT_display_surface_counter', 1, 'VK_USE_PLATFORM_DISPLAY_KHR'),
127 Extension('VK_EXT_external_memory_dma_buf', 1, True),
128 Extension('VK_EXT_global_priority', 1,
129 'device->has_context_priority'),
130 Extension('VK_EXT_pci_bus_info', 2, True),
131 Extension('VK_EXT_post_depth_coverage', 1, 'device->info.gen >= 9'),
132 Extension('VK_EXT_sampler_filter_minmax', 1, 'device->info.gen >= 9'),
133 Extension('VK_EXT_scalar_block_layout', 1, True),
134 Extension('VK_EXT_shader_stencil_export', 1, 'device->info.gen >= 9'),
135 Extension('VK_EXT_shader_viewport_index_layer', 1, True),
136 Extension('VK_EXT_transform_feedback', 1, True),
137 Extension('VK_EXT_vertex_attribute_divisor', 3, True),
138 Extension('VK_ANDROID_external_memory_android_hardware_buffer', 3, 'ANDROID'),
139 Extension('VK_ANDROID_native_buffer', 5, 'ANDROID'),
140 Extension('VK_GOOGLE_decorate_string', 1, True),
141 Extension('VK_GOOGLE_hlsl_functionality1', 1, True),
144 # Sort the extension list the way we expect: KHR, then EXT, then vendors
145 # alphabetically. For digits, read them as a whole number sort that.
146 # eg.: VK_KHR_8bit_storage < VK_KHR_16bit_storage < VK_EXT_acquire_xlib_display
147 def extension_order(ext
):
149 for substring
in re
.split('(KHR|EXT|[0-9]+)', ext
.name
):
150 if substring
== 'KHR':
152 if substring
== 'EXT':
154 elif substring
.isdigit():
155 order
.append(int(substring
))
157 order
.append(substring
)
159 for i
in range(len(EXTENSIONS
) - 1):
160 if extension_order(EXTENSIONS
[i
+ 1]) < extension_order(EXTENSIONS
[i
]):
161 print(EXTENSIONS
[i
+ 1].name
+ ' should come before ' + EXTENSIONS
[i
].name
)
165 def __init__(self
, string
):
166 split
= string
.split('.')
167 self
.major
= int(split
[0])
168 self
.minor
= int(split
[1])
170 assert len(split
) == 3
171 self
.patch
= int(split
[2])
175 # Sanity check. The range bits are required by the definition of the
176 # VK_MAKE_VERSION macro
177 assert self
.major
< 1024 and self
.minor
< 1024
178 assert self
.patch
is None or self
.patch
< 4096
179 assert str(self
) == string
182 ver_list
= [str(self
.major
), str(self
.minor
)]
183 if self
.patch
is not None:
184 ver_list
.append(str(self
.patch
))
185 return '.'.join(ver_list
)
187 def c_vk_version(self
):
188 patch
= self
.patch
if self
.patch
is not None else 0
189 ver_list
= [str(self
.major
), str(self
.minor
), str(patch
)]
190 return 'VK_MAKE_VERSION(' + ', '.join(ver_list
) + ')'
193 # This is just an expansion of VK_VERSION
194 patch
= self
.patch
if self
.patch
is not None else 0
195 return (self
.major
<< 22) |
(self
.minor
<< 12) | patch
197 def __gt__(self
, other
):
198 # If only one of them has a patch version, "ignore" it by making
199 # other's patch version match self.
200 if (self
.patch
is None) != (other
.patch
is None):
201 other
= copy
.copy(other
)
202 other
.patch
= self
.patch
204 return self
.__int
_ver
() > other
.__int
_ver
()
208 MAX_API_VERSION
= VkVersion('0.0.0')
209 for version
in API_VERSIONS
:
210 version
.version
= VkVersion(version
.version
)
211 version
.version
.patch
= API_PATCH_VERSION
212 assert version
.version
> MAX_API_VERSION
213 MAX_API_VERSION
= version
.version