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_display_properties2.txt[] 6 7*Last Modified Date*:: 8 2017-02-21 9*IP Status*:: 10 No known IP claims. 11*Contributors*:: 12 - Ian Elliott, Google 13 - James Jones, NVIDIA 14 15This extension provides new entry points to query device display properties 16and capabilities in a way that can be easily extended by other extensions, 17without introducing any further entry points. 18This extension can be considered the <<VK_KHR_display,VK_KHR_display>> 19equivalent of the <<VK_KHR_get_physical_device_properties2, 20VK_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_DISPLAY_PROPERTIES_2_KHR 30 ** ename:VK_STRUCTURE_TYPE_DISPLAY_PLANE_PROPERTIES_2_KHR 31 ** ename:VK_STRUCTURE_TYPE_DISPLAY_MODE_PROPERTIES_2_KHR 32 ** ename:VK_STRUCTURE_TYPE_DISPLAY_PLANE_INFO_2_KHR 33 ** ename:VK_STRUCTURE_TYPE_DISPLAY_PLANE_CAPABILITIES_2_KHR 34 35=== New Enums 36 37None. 38 39=== New Structures 40 41 * slink:VkDisplayProperties2KHR 42 * slink:VkDisplayPlaneProperties2KHR 43 * slink:VkDisplayModeProperties2KHR 44 * slink:VkDisplayPlaneInfo2KHR 45 * slink:VkDisplayPlaneCapabilities2KHR 46 47=== New Functions 48 49 * flink:vkGetPhysicalDeviceDisplayProperties2KHR 50 * flink:vkGetPhysicalDeviceDisplayPlaneProperties2KHR 51 * flink:vkGetDisplayModeProperties2KHR 52 * flink:vkGetDisplayPlaneCapabilities2KHR 53 54=== Issues 55 561) What should this extension be named? 57 58*RESOLVED*: VK_KHR_get_display_properties2. 59Other alternatives: 60 61 * VK_KHR_display2 62 * One extension, combined with VK_KHR_surface_capabilites2. 63 642) Should extensible input structs be added for these new functions: 65 66*RESOLVED*: 67 68 * flink:vkGetPhysicalDeviceDisplayProperties2KHR: No. 69 The only current input is a VkPhysicalDevice. 70 Other inputs wouldn't make sense. 71 * flink:vkGetPhysicalDeviceDisplayPlaneProperties2KHR: No. 72 The only current input is a VkPhysicalDevice. 73 Other inputs wouldn't make sense. 74 * flink:vkGetDisplayModeProperties2KHR: No. 75 The only curent inputs are a VkPhysicalDevice and a VkDisplayModeKHR. 76 Other inputs wouldn't make sense. 77 783) Should additional display query functions be extended? 79 80*RESOLVED*: 81 82 * flink:vkGetDisplayPlaneSupportedDisplaysKHR: No. 83 Extensions should instead extend 84 flink:vkGetDisplayPlaneCapabilitiesKHR(). 85 86=== Version History 87 88 * Revision 1, 2017-02-21 (James Jones) 89 - Initial draft. 90