1// Copyright (c) 2017-2018 Khronos Group. This work is licensed under a 2// Creative Commons Attribution 4.0 International License; see 3// http://creativecommons.org/licenses/by/4.0/ 4 5include::meta/VK_KHR_get_surface_capabilities2.txt[] 6 7*Last Modified Date*:: 8 2017-02-27 9*IP Status*:: 10 No known IP claims. 11*Contributors*:: 12 - Ian Elliott, Google 13 - James Jones, NVIDIA 14 - Alon Or-bach, Samsung 15 16This extension provides new entry points to query device surface 17capabilities in a way that can be easily extended by other extensions, 18without introducing any further entry points. 19This extension can be considered the `<<VK_KHR_surface>>` equivalent of the 20`<<VK_KHR_get_physical_device_properties2>>` extension. 21 22=== New Object Types 23 24None. 25 26=== New Enum Constants 27 28 * Extending elink:VkStructureType: 29 ** ename:VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SURFACE_INFO_2_KHR 30 ** ename:VK_STRUCTURE_TYPE_SURFACE_CAPABILITIES_2_KHR 31 ** ename:VK_STRUCTURE_TYPE_SURFACE_FORMAT_2_KHR 32 33=== New Enums 34 35None. 36 37=== New Structures 38 39 * slink:VkPhysicalDeviceSurfaceInfo2KHR 40 * slink:VkSurfaceCapabilities2KHR 41 * slink:VkSurfaceFormat2KHR 42 43=== New Functions 44 45 * flink:vkGetPhysicalDeviceSurfaceCapabilities2KHR 46 * flink:vkGetPhysicalDeviceSurfaceFormats2KHR 47 48=== Issues 49 501) What should this extension be named? 51 52*RESOLVED*: `VK_KHR_get_surface_capabilities2`. 53Other alternatives: 54 55 * `VK_KHR_surface2` 56 * One extension, combining a separate display-specific query extension. 57 582) Should additional WSI query functions be extended? 59 60*RESOLVED*: 61 62 * flink:vkGetPhysicalDeviceSurfaceCapabilitiesKHR: Yes. 63 The need for this motivated the extension. 64 * flink:vkGetPhysicalDeviceSurfaceSupportKHR: No. 65 Currently only has boolean output. 66 Extensions should instead extend 67 flink:vkGetPhysicalDeviceSurfaceCapabilities2KHR. 68 * flink:vkGetPhysicalDeviceSurfaceFormatsKHR: Yes. 69 * flink:vkGetPhysicalDeviceSurfacePresentModesKHR: No. 70 Recent discussion concluded this introduced too much variability for 71 applications to deal with. 72 Extensions should instead extend 73 flink:vkGetPhysicalDeviceSurfaceCapabilities2KHR. 74 * flink:vkGetPhysicalDeviceXlibPresentationSupportKHR: Not in this 75 extension. 76 * flink:vkGetPhysicalDeviceXcbPresentationSupportKHR: Not in this 77 extension. 78 * flink:vkGetPhysicalDeviceWaylandPresentationSupportKHR: Not in this 79 extension. 80 * flink:vkGetPhysicalDeviceMirPresentationSupportKHR: Not in this 81 extension. 82 * flink:vkGetPhysicalDeviceWin32PresentationSupportKHR: Not in this 83 extension. 84 85=== Version History 86 87 * Revision 1, 2017-02-27 (James Jones) 88 - Initial draft. 89