1// Copyright 2017-2024 The Khronos Group Inc. 2// 3// SPDX-License-Identifier: CC-BY-4.0 4 5include::{generated}/meta/{refprefix}VK_KHR_get_surface_capabilities2.adoc[] 6 7=== Other Extension Metadata 8 9*Last Modified Date*:: 10 2017-02-27 11*IP Status*:: 12 No known IP claims. 13*Contributors*:: 14 - Ian Elliott, Google 15 - James Jones, NVIDIA 16 - Alon Or-bach, Samsung 17 18=== Description 19 20This extension provides new queries for device surface capabilities that can 21be easily extended by other extensions, without introducing any further 22queries. 23This extension can be considered the `apiext:VK_KHR_surface` equivalent of 24the `apiext:VK_KHR_get_physical_device_properties2` extension. 25 26include::{generated}/interfaces/VK_KHR_get_surface_capabilities2.adoc[] 27 28=== Issues 29 301) What should this extension be named? 31 32*RESOLVED*: `VK_KHR_get_surface_capabilities2`. 33Other alternatives: 34 35 * `VK_KHR_surface2` 36 * One extension, combining a separate display-specific query extension. 37 382) Should additional WSI query functions be extended? 39 40*RESOLVED*: 41 42 * flink:vkGetPhysicalDeviceSurfaceCapabilitiesKHR: Yes. 43 The need for this motivated the extension. 44 * flink:vkGetPhysicalDeviceSurfaceSupportKHR: No. 45 Currently only has boolean output. 46 Extensions should instead extend 47 flink:vkGetPhysicalDeviceSurfaceCapabilities2KHR. 48 * flink:vkGetPhysicalDeviceSurfaceFormatsKHR: Yes. 49 * flink:vkGetPhysicalDeviceSurfacePresentModesKHR: No. 50 Recent discussion concluded this introduced too much variability for 51 applications to deal with. 52 Extensions should instead extend 53 flink:vkGetPhysicalDeviceSurfaceCapabilities2KHR. 54 * flink:vkGetPhysicalDeviceXlibPresentationSupportKHR: Not in this 55 extension. 56 * flink:vkGetPhysicalDeviceXcbPresentationSupportKHR: Not in this 57 extension. 58 * flink:vkGetPhysicalDeviceWaylandPresentationSupportKHR: Not in this 59 extension. 60 * flink:vkGetPhysicalDeviceWin32PresentationSupportKHR: Not in this 61 extension. 62 63=== Version History 64 65 * Revision 1, 2017-02-27 (James Jones) 66 ** Initial draft. 67