2 * Copyright © 2017 Intel Corporation
4 * Permission is hereby granted, free of charge, to any person obtaining a
5 * copy of this software and associated documentation files (the "Software"),
6 * to deal in the Software without restriction, including without limitation
7 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8 * and/or sell copies of the Software, and to permit persons to whom the
9 * Software is furnished to do so, subject to the following conditions:
11 * The above copyright notice and this permission notice (including the next
12 * paragraph) shall be included in all copies or substantial portions of the
15 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
18 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
20 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
26 /* common inlines and macros for vulkan drivers */
28 #include <vulkan/vulkan.h>
30 #define vk_foreach_struct(__iter, __start) \
31 for (struct VkBaseOutStructure *__iter = (struct VkBaseOutStructure *)(__start); \
32 __iter; __iter = __iter->pNext)
34 #define vk_foreach_struct_const(__iter, __start) \
35 for (const struct VkBaseInStructure *__iter = (const struct VkBaseInStructure *)(__start); \
36 __iter; __iter = __iter->pNext)
39 * A wrapper for a Vulkan output array. A Vulkan output array is one that
40 * follows the convention of the parameters to
41 * vkGetPhysicalDeviceQueueFamilyProperties().
46 * vkGetPhysicalDeviceQueueFamilyProperties(
47 * VkPhysicalDevice physicalDevice,
48 * uint32_t* pQueueFamilyPropertyCount,
49 * VkQueueFamilyProperties* pQueueFamilyProperties)
51 * VK_OUTARRAY_MAKE(props, pQueueFamilyProperties,
52 * pQueueFamilyPropertyCount);
54 * vk_outarray_append(&props, p) {
55 * p->queueFlags = ...;
56 * p->queueCount = ...;
59 * vk_outarray_append(&props, p) {
60 * p->queueFlags = ...;
61 * p->queueCount = ...;
64 * return vk_outarray_status(&props);
67 struct __vk_outarray
{
72 * Capacity, in number of elements. Capacity is unlimited (UINT32_MAX) if
78 * Count of elements successfully written to the array. Every write is
79 * considered successful if data is null.
84 * Count of elements that would have been written to the array if its
85 * capacity were sufficient. Vulkan functions often return VK_INCOMPLETE
86 * when `*filled_len < wanted_len`.
92 __vk_outarray_init(struct __vk_outarray
*a
,
93 void *data
, uint32_t *restrict len
)
105 static inline VkResult
106 __vk_outarray_status(const struct __vk_outarray
*a
)
108 if (*a
->filled_len
< a
->wanted_len
)
109 return VK_INCOMPLETE
;
115 __vk_outarray_next(struct __vk_outarray
*a
, size_t elem_size
)
121 if (*a
->filled_len
>= a
->cap
)
125 p
= a
->data
+ (*a
->filled_len
) * elem_size
;
132 #define vk_outarray(elem_t) \
134 struct __vk_outarray base; \
138 #define vk_outarray_typeof_elem(a) __typeof__((a)->meta[0])
139 #define vk_outarray_sizeof_elem(a) sizeof((a)->meta[0])
141 #define vk_outarray_init(a, data, len) \
142 __vk_outarray_init(&(a)->base, (data), (len))
144 #define VK_OUTARRAY_MAKE(name, data, len) \
145 vk_outarray(__typeof__((data)[0])) name; \
146 vk_outarray_init(&name, (data), (len))
148 #define vk_outarray_status(a) \
149 __vk_outarray_status(&(a)->base)
151 #define vk_outarray_next(a) \
152 ((vk_outarray_typeof_elem(a) *) \
153 __vk_outarray_next(&(a)->base, vk_outarray_sizeof_elem(a)))
156 * Append to a Vulkan output array.
158 * This is a block-based macro. For example:
160 * vk_outarray_append(&a, elem) {
165 * The array `a` has type `vk_outarray(elem_t) *`. It is usually declared with
166 * VK_OUTARRAY_MAKE(). The variable `elem` is block-scoped and has type
169 * The macro unconditionally increments the array's `wanted_len`. If the array
170 * is not full, then the macro also increment its `filled_len` and then
171 * executes the block. When the block is executed, `elem` is non-null and
172 * points to the newly appended element.
174 #define vk_outarray_append(a, elem) \
175 for (vk_outarray_typeof_elem(a) *elem = vk_outarray_next(a); \
176 elem != NULL; elem = NULL)
179 __vk_find_struct(void *start
, VkStructureType sType
)
181 vk_foreach_struct(s
, start
) {
182 if (s
->sType
== sType
)
189 #define vk_find_struct(__start, __sType) \
190 __vk_find_struct((__start), VK_STRUCTURE_TYPE_##__sType)
192 #define vk_find_struct_const(__start, __sType) \
193 (const void *)__vk_find_struct((void *)(__start), VK_STRUCTURE_TYPE_##__sType)
195 uint32_t vk_get_driver_version(void);
197 uint32_t vk_get_version_override(void);
199 #define VK_EXT_OFFSET (1000000000UL)
200 #define VK_ENUM_EXTENSION(__enum) \
201 ((__enum) >= VK_EXT_OFFSET ? ((((__enum) - VK_EXT_OFFSET) / 1000UL) + 1) : 0)
202 #define VK_ENUM_OFFSET(__enum) \
203 ((__enum) >= VK_EXT_OFFSET ? ((__enum) % 1000) : (__enum))
205 #endif /* VK_UTIL_H */