2 * Copyright © 2015 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
30 #include <vulkan/vulkan.h>
31 #include <vulkan/vk_icd.h>
33 /* This is guaranteed to not collide with anything because it's in the
34 * VK_KHR_swapchain namespace but not actually used by the extension.
36 #define VK_STRUCTURE_TYPE_WSI_IMAGE_CREATE_INFO_MESA (VkStructureType)1000001002
37 #define VK_STRUCTURE_TYPE_WSI_MEMORY_ALLOCATE_INFO_MESA (VkStructureType)1000001003
38 #define VK_STRUCTURE_TYPE_WSI_SURFACE_SUPPORTED_COUNTERS_MESA (VkStructureType)1000001005
39 #define VK_STRUCTURE_TYPE_WSI_MEMORY_SIGNAL_SUBMIT_INFO_MESA (VkStructureType)1000001006
41 struct wsi_image_create_info
{
42 VkStructureType sType
;
47 struct wsi_memory_allocate_info
{
48 VkStructureType sType
;
53 /* To be chained into VkSurfaceCapabilities2KHR */
54 struct wsi_surface_supported_counters
{
55 VkStructureType sType
;
58 VkSurfaceCounterFlagsEXT supported_surface_counters
;
62 /* To be chained into VkSubmitInfo */
63 struct wsi_memory_signal_submit_info
{
64 VkStructureType sType
;
66 VkDeviceMemory memory
;
71 const struct wsi_device
*wsi_device
;
73 const VkAllocationCallbacks
*alloc
;
74 VkResult (*wait
)(struct wsi_fence
*fence
, uint64_t abs_timeout
);
75 void (*destroy
)(struct wsi_fence
*fence
);
80 struct driOptionCache
;
82 #define VK_ICD_WSI_PLATFORM_MAX (VK_ICD_WSI_PLATFORM_DISPLAY + 1)
85 /* Allocator for the instance */
86 VkAllocationCallbacks instance_alloc
;
88 VkPhysicalDevice pdevice
;
89 VkPhysicalDeviceMemoryProperties memory_props
;
90 uint32_t queue_family_count
;
92 VkPhysicalDevicePCIBusInfoPropertiesEXT pci_bus_info
;
94 bool supports_modifiers
;
95 uint32_t maxImageDimension2D
;
96 VkPresentModeKHR override_present_mode
;
97 bool force_bgra8_unorm_first
;
99 /* Whether to enable adaptive sync for a swapchain if implemented and
100 * available. Not all window systems might support this. */
101 bool enable_adaptive_sync
;
104 /* Override the minimum number of images on the swapchain.
106 uint32_t override_minImageCount
;
108 /* Forces strict number of image on the swapchain using application
109 * provided VkSwapchainCreateInfoKH::RminImageCount.
111 bool strict_imageCount
;
113 /* Ensures to create at least the number of image specified by the
114 * driver in VkSurfaceCapabilitiesKHR::minImageCount.
116 bool ensure_minImageCount
;
119 /* Signals the semaphore such that any wait on the semaphore will wait on
120 * any reads or writes on the give memory object. This is used to
121 * implement the semaphore signal operation in vkAcquireNextImage.
123 void (*signal_semaphore_for_memory
)(VkDevice device
,
124 VkSemaphore semaphore
,
125 VkDeviceMemory memory
);
127 /* Signals the fence such that any wait on the fence will wait on any reads
128 * or writes on the give memory object. This is used to implement the
129 * semaphore signal operation in vkAcquireNextImage.
131 void (*signal_fence_for_memory
)(VkDevice device
,
133 VkDeviceMemory memory
);
136 * This sets the ownership for a WSI memory object:
138 * The ownership is true if and only if the application is allowed to submit
139 * command buffers that reference the buffer.
141 * This can be used to prune BO lists without too many adverse affects on
144 * Side note: care needs to be taken for internally delayed submissions wrt
145 * timeline semaphores.
147 void (*set_memory_ownership
)(VkDevice device
,
148 VkDeviceMemory memory
,
151 #define WSI_CB(cb) PFN_vk##cb cb
152 WSI_CB(AllocateMemory
);
153 WSI_CB(AllocateCommandBuffers
);
154 WSI_CB(BindBufferMemory
);
155 WSI_CB(BindImageMemory
);
156 WSI_CB(BeginCommandBuffer
);
157 WSI_CB(CmdCopyImageToBuffer
);
158 WSI_CB(CreateBuffer
);
159 WSI_CB(CreateCommandPool
);
162 WSI_CB(DestroyBuffer
);
163 WSI_CB(DestroyCommandPool
);
164 WSI_CB(DestroyFence
);
165 WSI_CB(DestroyImage
);
166 WSI_CB(EndCommandBuffer
);
168 WSI_CB(FreeCommandBuffers
);
169 WSI_CB(GetBufferMemoryRequirements
);
170 WSI_CB(GetImageDrmFormatModifierPropertiesEXT
);
171 WSI_CB(GetImageMemoryRequirements
);
172 WSI_CB(GetImageSubresourceLayout
);
173 WSI_CB(GetMemoryFdKHR
);
174 WSI_CB(GetPhysicalDeviceFormatProperties
);
175 WSI_CB(GetPhysicalDeviceFormatProperties2KHR
);
176 WSI_CB(GetPhysicalDeviceImageFormatProperties2
);
179 WSI_CB(WaitForFences
);
182 struct wsi_interface
* wsi
[VK_ICD_WSI_PLATFORM_MAX
];
185 typedef PFN_vkVoidFunction (VKAPI_PTR
*WSI_FN_GetPhysicalDeviceProcAddr
)(VkPhysicalDevice physicalDevice
, const char* pName
);
188 wsi_device_init(struct wsi_device
*wsi
,
189 VkPhysicalDevice pdevice
,
190 WSI_FN_GetPhysicalDeviceProcAddr proc_addr
,
191 const VkAllocationCallbacks
*alloc
,
193 const struct driOptionCache
*dri_options
);
196 wsi_device_finish(struct wsi_device
*wsi
,
197 const VkAllocationCallbacks
*alloc
);
199 #define ICD_DEFINE_NONDISP_HANDLE_CASTS(__VkIcdType, __VkType) \
201 static inline __VkIcdType * \
202 __VkIcdType ## _from_handle(__VkType _handle) \
204 return (__VkIcdType *)(uintptr_t) _handle; \
207 static inline __VkType \
208 __VkIcdType ## _to_handle(__VkIcdType *_obj) \
210 return (__VkType)(uintptr_t) _obj; \
213 #define ICD_FROM_HANDLE(__VkIcdType, __name, __handle) \
214 __VkIcdType *__name = __VkIcdType ## _from_handle(__handle)
216 ICD_DEFINE_NONDISP_HANDLE_CASTS(VkIcdSurfaceBase
, VkSurfaceKHR
)
219 wsi_common_get_surface_support(struct wsi_device
*wsi_device
,
220 uint32_t queueFamilyIndex
,
221 VkSurfaceKHR surface
,
222 VkBool32
* pSupported
);
225 wsi_common_get_surface_capabilities(struct wsi_device
*wsi_device
,
226 VkSurfaceKHR surface
,
227 VkSurfaceCapabilitiesKHR
*pSurfaceCapabilities
);
230 wsi_common_get_surface_capabilities2(struct wsi_device
*wsi_device
,
231 const VkPhysicalDeviceSurfaceInfo2KHR
*pSurfaceInfo
,
232 VkSurfaceCapabilities2KHR
*pSurfaceCapabilities
);
235 wsi_common_get_surface_formats(struct wsi_device
*wsi_device
,
236 VkSurfaceKHR surface
,
237 uint32_t *pSurfaceFormatCount
,
238 VkSurfaceFormatKHR
*pSurfaceFormats
);
241 wsi_common_get_surface_formats2(struct wsi_device
*wsi_device
,
242 const VkPhysicalDeviceSurfaceInfo2KHR
*pSurfaceInfo
,
243 uint32_t *pSurfaceFormatCount
,
244 VkSurfaceFormat2KHR
*pSurfaceFormats
);
247 wsi_common_get_surface_present_modes(struct wsi_device
*wsi_device
,
248 VkSurfaceKHR surface
,
249 uint32_t *pPresentModeCount
,
250 VkPresentModeKHR
*pPresentModes
);
253 wsi_common_get_present_rectangles(struct wsi_device
*wsi
,
254 VkSurfaceKHR surface
,
255 uint32_t* pRectCount
,
259 wsi_common_get_surface_capabilities2ext(
260 struct wsi_device
*wsi_device
,
261 VkSurfaceKHR surface
,
262 VkSurfaceCapabilities2EXT
*pSurfaceCapabilities
);
265 wsi_common_get_images(VkSwapchainKHR _swapchain
,
266 uint32_t *pSwapchainImageCount
,
267 VkImage
*pSwapchainImages
);
270 wsi_common_acquire_next_image2(const struct wsi_device
*wsi
,
272 const VkAcquireNextImageInfoKHR
*pAcquireInfo
,
273 uint32_t *pImageIndex
);
276 wsi_common_create_swapchain(struct wsi_device
*wsi
,
278 const VkSwapchainCreateInfoKHR
*pCreateInfo
,
279 const VkAllocationCallbacks
*pAllocator
,
280 VkSwapchainKHR
*pSwapchain
);
282 wsi_common_destroy_swapchain(VkDevice device
,
283 VkSwapchainKHR swapchain
,
284 const VkAllocationCallbacks
*pAllocator
);
287 wsi_common_queue_present(const struct wsi_device
*wsi
,
290 int queue_family_index
,
291 const VkPresentInfoKHR
*pPresentInfo
);
294 wsi_common_get_current_time(void);