src/vulkan/wsi/wsi_common.h

   1 /*
   2  * Copyright © 2015 Intel Corporation
   3  *
   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:
  10  *
  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
  13  * Software.
  14  *
  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
  21  * IN THE SOFTWARE.
  22  */
  23 #ifndef WSI_COMMON_H
  24 #define WSI_COMMON_H
  25
  26 #include <stdint.h>
  27 #include <stdbool.h>
  28
  29 #include "vk_alloc.h"
  30 #include <vulkan/vulkan.h>
  31 #include <vulkan/vk_icd.h>
  32
  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.
  35  */
  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_FORMAT_MODIFIER_PROPERTIES_LIST_MESA (VkStructureType)1000001004
  39 #define VK_STRUCTURE_TYPE_WSI_SURFACE_SUPPORTED_COUNTERS_MESA (VkStructureType)1000001005
  40
  41 struct wsi_image_create_info {
  42     VkStructureType sType;
  43     const void *pNext;
  44     bool scanout;
  45
  46     uint32_t modifier_count;
  47     const uint64_t *modifiers;
  48 };
  49
  50 struct wsi_memory_allocate_info {
  51     VkStructureType sType;
  52     const void *pNext;
  53     bool implicit_sync;
  54 };
  55
  56 struct wsi_format_modifier_properties {
  57    uint64_t modifier;
  58    uint32_t modifier_plane_count;
  59 };
  60
  61 /* Chain in for vkGetPhysicalDeviceFormatProperties2KHR */
  62 struct wsi_format_modifier_properties_list {
  63    VkStructureType sType;
  64    const void *pNext;
  65
  66    uint32_t modifier_count;
  67    struct wsi_format_modifier_properties *modifier_properties;
  68 };
  69
  70 /* To be chained into VkSurfaceCapabilities2KHR */
  71 struct wsi_surface_supported_counters {
  72    VkStructureType sType;
  73    const void *pNext;
  74
  75    VkSurfaceCounterFlagsEXT supported_surface_counters;
  76
  77 };
  78
  79 struct wsi_fence {
  80    VkDevice                     device;
  81    const struct wsi_device      *wsi_device;
  82    VkDisplayKHR                 display;
  83    const VkAllocationCallbacks  *alloc;
  84    VkResult                     (*wait)(struct wsi_fence *fence, uint64_t abs_timeout);
  85    void                         (*destroy)(struct wsi_fence *fence);
  86 };
  87
  88 struct wsi_interface;
  89
  90 struct driOptionCache;
  91
  92 #define VK_ICD_WSI_PLATFORM_MAX (VK_ICD_WSI_PLATFORM_DISPLAY + 1)
  93
  94 struct wsi_device {
  95    /* Allocator for the instance */
  96    VkAllocationCallbacks instance_alloc;
  97
  98    VkPhysicalDevice pdevice;
  99    VkPhysicalDeviceMemoryProperties memory_props;
 100    uint32_t queue_family_count;
 101
 102    VkPhysicalDevicePCIBusInfoPropertiesEXT pci_bus_info;
 103
 104    bool supports_modifiers;
 105    uint32_t maxImageDimension2D;
 106    VkPresentModeKHR override_present_mode;
 107
 108    /* Whether to enable adaptive sync for a swapchain if implemented and
 109     * available. Not all window systems might support this. */
 110    bool enable_adaptive_sync;
 111
 112    uint64_t (*image_get_modifier)(VkImage image);
 113
 114 #define WSI_CB(cb) PFN_vk##cb cb
 115    WSI_CB(AllocateMemory);
 116    WSI_CB(AllocateCommandBuffers);
 117    WSI_CB(BindBufferMemory);
 118    WSI_CB(BindImageMemory);
 119    WSI_CB(BeginCommandBuffer);
 120    WSI_CB(CmdCopyImageToBuffer);
 121    WSI_CB(CreateBuffer);
 122    WSI_CB(CreateCommandPool);
 123    WSI_CB(CreateFence);
 124    WSI_CB(CreateImage);
 125    WSI_CB(DestroyBuffer);
 126    WSI_CB(DestroyCommandPool);
 127    WSI_CB(DestroyFence);
 128    WSI_CB(DestroyImage);
 129    WSI_CB(EndCommandBuffer);
 130    WSI_CB(FreeMemory);
 131    WSI_CB(FreeCommandBuffers);
 132    WSI_CB(GetBufferMemoryRequirements);
 133    WSI_CB(GetImageMemoryRequirements);
 134    WSI_CB(GetImageSubresourceLayout);
 135    WSI_CB(GetMemoryFdKHR);
 136    WSI_CB(GetPhysicalDeviceFormatProperties);
 137    WSI_CB(GetPhysicalDeviceFormatProperties2KHR);
 138    WSI_CB(ResetFences);
 139    WSI_CB(QueueSubmit);
 140    WSI_CB(WaitForFences);
 141 #undef WSI_CB
 142
 143     struct wsi_interface *                  wsi[VK_ICD_WSI_PLATFORM_MAX];
 144 };
 145
 146 typedef PFN_vkVoidFunction (VKAPI_PTR *WSI_FN_GetPhysicalDeviceProcAddr)(VkPhysicalDevice physicalDevice, const char* pName);
 147
 148 VkResult
 149 wsi_device_init(struct wsi_device *wsi,
 150                 VkPhysicalDevice pdevice,
 151                 WSI_FN_GetPhysicalDeviceProcAddr proc_addr,
 152                 const VkAllocationCallbacks *alloc,
 153                 int display_fd,
 154                 const struct driOptionCache *dri_options);
 155
 156 void
 157 wsi_device_finish(struct wsi_device *wsi,
 158                   const VkAllocationCallbacks *alloc);
 159
 160 #define ICD_DEFINE_NONDISP_HANDLE_CASTS(__VkIcdType, __VkType)             \
 161                                                                            \
 162    static inline __VkIcdType *                                             \
 163    __VkIcdType ## _from_handle(__VkType _handle)                           \
 164    {                                                                       \
 165       return (__VkIcdType *)(uintptr_t) _handle;                           \
 166    }                                                                       \
 167                                                                            \
 168    static inline __VkType                                                  \
 169    __VkIcdType ## _to_handle(__VkIcdType *_obj)                            \
 170    {                                                                       \
 171       return (__VkType)(uintptr_t) _obj;                                   \
 172    }
 173
 174 #define ICD_FROM_HANDLE(__VkIcdType, __name, __handle) \
 175    __VkIcdType *__name = __VkIcdType ## _from_handle(__handle)
 176
 177 ICD_DEFINE_NONDISP_HANDLE_CASTS(VkIcdSurfaceBase, VkSurfaceKHR)
 178
 179 VkResult
 180 wsi_common_get_surface_support(struct wsi_device *wsi_device,
 181                                uint32_t queueFamilyIndex,
 182                                VkSurfaceKHR surface,
 183                                VkBool32* pSupported);
 184
 185 VkResult
 186 wsi_common_get_surface_capabilities(struct wsi_device *wsi_device,
 187                                     VkSurfaceKHR surface,
 188                                     VkSurfaceCapabilitiesKHR *pSurfaceCapabilities);
 189
 190 VkResult
 191 wsi_common_get_surface_capabilities2(struct wsi_device *wsi_device,
 192                                      const VkPhysicalDeviceSurfaceInfo2KHR *pSurfaceInfo,
 193                                      VkSurfaceCapabilities2KHR *pSurfaceCapabilities);
 194
 195 VkResult
 196 wsi_common_get_surface_formats(struct wsi_device *wsi_device,
 197                                VkSurfaceKHR surface,
 198                                uint32_t *pSurfaceFormatCount,
 199                                VkSurfaceFormatKHR *pSurfaceFormats);
 200
 201 VkResult
 202 wsi_common_get_surface_formats2(struct wsi_device *wsi_device,
 203                                 const VkPhysicalDeviceSurfaceInfo2KHR *pSurfaceInfo,
 204                                 uint32_t *pSurfaceFormatCount,
 205                                 VkSurfaceFormat2KHR *pSurfaceFormats);
 206
 207 VkResult
 208 wsi_common_get_surface_present_modes(struct wsi_device *wsi_device,
 209                                      VkSurfaceKHR surface,
 210                                      uint32_t *pPresentModeCount,
 211                                      VkPresentModeKHR *pPresentModes);
 212
 213 VkResult
 214 wsi_common_get_present_rectangles(struct wsi_device *wsi,
 215                                   VkSurfaceKHR surface,
 216                                   uint32_t* pRectCount,
 217                                   VkRect2D* pRects);
 218
 219 VkResult
 220 wsi_common_get_surface_capabilities2ext(
 221    struct wsi_device *wsi_device,
 222    VkSurfaceKHR surface,
 223    VkSurfaceCapabilities2EXT *pSurfaceCapabilities);
 224
 225 VkResult
 226 wsi_common_get_images(VkSwapchainKHR _swapchain,
 227                       uint32_t *pSwapchainImageCount,
 228                       VkImage *pSwapchainImages);
 229
 230 VkResult
 231 wsi_common_acquire_next_image2(const struct wsi_device *wsi,
 232                                VkDevice device,
 233                                const VkAcquireNextImageInfoKHR *pAcquireInfo,
 234                                uint32_t *pImageIndex);
 235
 236 VkResult
 237 wsi_common_create_swapchain(struct wsi_device *wsi,
 238                             VkDevice device,
 239                             const VkSwapchainCreateInfoKHR *pCreateInfo,
 240                             const VkAllocationCallbacks *pAllocator,
 241                             VkSwapchainKHR *pSwapchain);
 242 void
 243 wsi_common_destroy_swapchain(VkDevice device,
 244                              VkSwapchainKHR swapchain,
 245                              const VkAllocationCallbacks *pAllocator);
 246
 247 VkResult
 248 wsi_common_queue_present(const struct wsi_device *wsi,
 249                          VkDevice device_h,
 250                          VkQueue queue_h,
 251                          int queue_family_index,
 252                          const VkPresentInfoKHR *pPresentInfo);
 253
 254 uint64_t
 255 wsi_common_get_current_time(void);
 256
 257 #endif