include/vulkan/vk_icd.h

   1 //
   2 // File: vk_icd.h
   3 //
   4 /*
   5  * Copyright (c) 2015-2016 The Khronos Group Inc.
   6  * Copyright (c) 2015-2016 Valve Corporation
   7  * Copyright (c) 2015-2016 LunarG, Inc.
   8  *
   9  * Licensed under the Apache License, Version 2.0 (the "License");
  10  * you may not use this file except in compliance with the License.
  11  * You may obtain a copy of the License at
  12  *
  13  *     http://www.apache.org/licenses/LICENSE-2.0
  14  *
  15  * Unless required by applicable law or agreed to in writing, software
  16  * distributed under the License is distributed on an "AS IS" BASIS,
  17  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  18  * See the License for the specific language governing permissions and
  19  * limitations under the License.
  20  *
  21  */
  22
  23 #ifndef VKICD_H
  24 #define VKICD_H
  25
  26 #include "vulkan.h"
  27 #include <stdbool.h>
  28
  29 // Loader-ICD version negotiation API.  Versions add the following features:
  30 //   Version 0 - Initial.  Doesn't support vk_icdGetInstanceProcAddr
  31 //               or vk_icdNegotiateLoaderICDInterfaceVersion.
  32 //   Version 1 - Add support for vk_icdGetInstanceProcAddr.
  33 //   Version 2 - Add Loader/ICD Interface version negotiation
  34 //               via vk_icdNegotiateLoaderICDInterfaceVersion.
  35 //   Version 3 - Add ICD creation/destruction of KHR_surface objects.
  36 //   Version 4 - Add unknown physical device extension qyering via
  37 //               vk_icdGetPhysicalDeviceProcAddr.
  38 //   Version 5 - Tells ICDs that the loader is now paying attention to the
  39 //               application version of Vulkan passed into the ApplicationInfo
  40 //               structure during vkCreateInstance.  This will tell the ICD
  41 //               that if the loader is older, it should automatically fail a
  42 //               call for any API version > 1.0.  Otherwise, the loader will
  43 //               manually determine if it can support the expected version.
  44 #define CURRENT_LOADER_ICD_INTERFACE_VERSION 5
  45 #define MIN_SUPPORTED_LOADER_ICD_INTERFACE_VERSION 0
  46 #define MIN_PHYS_DEV_EXTENSION_ICD_INTERFACE_VERSION 4
  47 typedef VkResult(VKAPI_PTR *PFN_vkNegotiateLoaderICDInterfaceVersion)(uint32_t *pVersion);
  48
  49 // This is defined in vk_layer.h which will be found by the loader, but if an ICD is building against this
  50 // file directly, it won't be found.
  51 #ifndef PFN_GetPhysicalDeviceProcAddr
  52 typedef PFN_vkVoidFunction(VKAPI_PTR *PFN_GetPhysicalDeviceProcAddr)(VkInstance instance, const char *pName);
  53 #endif
  54
  55 /*
  56  * The ICD must reserve space for a pointer for the loader's dispatch
  57  * table, at the start of <each object>.
  58  * The ICD must initialize this variable using the SET_LOADER_MAGIC_VALUE macro.
  59  */
  60
  61 #define ICD_LOADER_MAGIC 0x01CDC0DE
  62
  63 typedef union {
  64     uintptr_t loaderMagic;
  65     void *loaderData;
  66 } VK_LOADER_DATA;
  67
  68 static inline void set_loader_magic_value(void *pNewObject) {
  69     VK_LOADER_DATA *loader_info = (VK_LOADER_DATA *)pNewObject;
  70     loader_info->loaderMagic = ICD_LOADER_MAGIC;
  71 }
  72
  73 static inline bool valid_loader_magic_value(void *pNewObject) {
  74     const VK_LOADER_DATA *loader_info = (VK_LOADER_DATA *)pNewObject;
  75     return (loader_info->loaderMagic & 0xffffffff) == ICD_LOADER_MAGIC;
  76 }
  77
  78 /*
  79  * Windows and Linux ICDs will treat VkSurfaceKHR as a pointer to a struct that
  80  * contains the platform-specific connection and surface information.
  81  */
  82 typedef enum {
  83     VK_ICD_WSI_PLATFORM_MIR,
  84     VK_ICD_WSI_PLATFORM_WAYLAND,
  85     VK_ICD_WSI_PLATFORM_WIN32,
  86     VK_ICD_WSI_PLATFORM_XCB,
  87     VK_ICD_WSI_PLATFORM_XLIB,
  88     VK_ICD_WSI_PLATFORM_ANDROID,
  89     VK_ICD_WSI_PLATFORM_MACOS,
  90     VK_ICD_WSI_PLATFORM_IOS,
  91     VK_ICD_WSI_PLATFORM_DISPLAY,
  92     VK_ICD_WSI_PLATFORM_HEADLESS
  93 } VkIcdWsiPlatform;
  94
  95 typedef struct {
  96     VkIcdWsiPlatform platform;
  97 } VkIcdSurfaceBase;
  98
  99 #ifdef VK_USE_PLATFORM_MIR_KHR
 100 typedef struct {
 101     VkIcdSurfaceBase base;
 102     MirConnection *connection;
 103     MirSurface *mirSurface;
 104 } VkIcdSurfaceMir;
 105 #endif  // VK_USE_PLATFORM_MIR_KHR
 106
 107 #ifdef VK_USE_PLATFORM_WAYLAND_KHR
 108 typedef struct {
 109     VkIcdSurfaceBase base;
 110     struct wl_display *display;
 111     struct wl_surface *surface;
 112 } VkIcdSurfaceWayland;
 113 #endif  // VK_USE_PLATFORM_WAYLAND_KHR
 114
 115 #ifdef VK_USE_PLATFORM_WIN32_KHR
 116 typedef struct {
 117     VkIcdSurfaceBase base;
 118     HINSTANCE hinstance;
 119     HWND hwnd;
 120 } VkIcdSurfaceWin32;
 121 #endif  // VK_USE_PLATFORM_WIN32_KHR
 122
 123 #ifdef VK_USE_PLATFORM_XCB_KHR
 124 typedef struct {
 125     VkIcdSurfaceBase base;
 126     xcb_connection_t *connection;
 127     xcb_window_t window;
 128 } VkIcdSurfaceXcb;
 129 #endif  // VK_USE_PLATFORM_XCB_KHR
 130
 131 #ifdef VK_USE_PLATFORM_XLIB_KHR
 132 typedef struct {
 133     VkIcdSurfaceBase base;
 134     Display *dpy;
 135     Window window;
 136 } VkIcdSurfaceXlib;
 137 #endif  // VK_USE_PLATFORM_XLIB_KHR
 138
 139 #ifdef VK_USE_PLATFORM_ANDROID_KHR
 140 typedef struct {
 141     VkIcdSurfaceBase base;
 142     struct ANativeWindow *window;
 143 } VkIcdSurfaceAndroid;
 144 #endif  // VK_USE_PLATFORM_ANDROID_KHR
 145
 146 #ifdef VK_USE_PLATFORM_MACOS_MVK
 147 typedef struct {
 148     VkIcdSurfaceBase base;
 149     const void *pView;
 150 } VkIcdSurfaceMacOS;
 151 #endif  // VK_USE_PLATFORM_MACOS_MVK
 152
 153 #ifdef VK_USE_PLATFORM_IOS_MVK
 154 typedef struct {
 155     VkIcdSurfaceBase base;
 156     const void *pView;
 157 } VkIcdSurfaceIOS;
 158 #endif  // VK_USE_PLATFORM_IOS_MVK
 159
 160 typedef struct {
 161     VkIcdSurfaceBase base;
 162     VkDisplayModeKHR displayMode;
 163     uint32_t planeIndex;
 164     uint32_t planeStackIndex;
 165     VkSurfaceTransformFlagBitsKHR transform;
 166     float globalAlpha;
 167     VkDisplayPlaneAlphaFlagBitsKHR alphaMode;
 168     VkExtent2D imageExtent;
 169 } VkIcdSurfaceDisplay;
 170
 171 typedef struct {
 172     VkIcdSurfaceBase base;
 173 } VkIcdSurfaceHeadless;
 174
 175 #endif  // VKICD_H