// Copyright (c) 2017-2018 Khronos Group. This work is licensed under a
// Creative Commons Attribution 4.0 International License; see
// http://creativecommons.org/licenses/by/4.0/

include::meta/VK_KHR_get_surface_capabilities2.txt[]

*Last Modified Date*::
    2017-02-27
*IP Status*::
    No known IP claims.
*Contributors*::
  - Ian Elliott, Google
  - James Jones, NVIDIA
  - Alon Or-bach, Samsung

This extension provides new entry points to query device surface
capabilities in a way that can be easily extended by other extensions,
without introducing any further entry points.
This extension can be considered the `<<VK_KHR_surface>>` equivalent of the
`<<VK_KHR_get_physical_device_properties2>>` extension.

=== New Object Types

None.

=== New Enum Constants

  * Extending elink:VkStructureType:
  ** ename:VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SURFACE_INFO_2_KHR
  ** ename:VK_STRUCTURE_TYPE_SURFACE_CAPABILITIES_2_KHR
  ** ename:VK_STRUCTURE_TYPE_SURFACE_FORMAT_2_KHR

=== New Enums

None.

=== New Structures

  * slink:VkPhysicalDeviceSurfaceInfo2KHR
  * slink:VkSurfaceCapabilities2KHR
  * slink:VkSurfaceFormat2KHR

=== New Functions

  * flink:vkGetPhysicalDeviceSurfaceCapabilities2KHR
  * flink:vkGetPhysicalDeviceSurfaceFormats2KHR

=== Issues

1) What should this extension be named?

*RESOLVED*: `VK_KHR_get_surface_capabilities2`.
Other alternatives:

  * `VK_KHR_surface2`
  * One extension, combining a separate display-specific query extension.

2) Should additional WSI query functions be extended?

*RESOLVED*:

  * flink:vkGetPhysicalDeviceSurfaceCapabilitiesKHR: Yes.
    The need for this motivated the extension.
  * flink:vkGetPhysicalDeviceSurfaceSupportKHR: No.
    Currently only has boolean output.
    Extensions should instead extend
    flink:vkGetPhysicalDeviceSurfaceCapabilities2KHR.
  * flink:vkGetPhysicalDeviceSurfaceFormatsKHR: Yes.
  * flink:vkGetPhysicalDeviceSurfacePresentModesKHR: No.
    Recent discussion concluded this introduced too much variability for
    applications to deal with.
    Extensions should instead extend
    flink:vkGetPhysicalDeviceSurfaceCapabilities2KHR.
  * flink:vkGetPhysicalDeviceXlibPresentationSupportKHR: Not in this
    extension.
  * flink:vkGetPhysicalDeviceXcbPresentationSupportKHR: Not in this
    extension.
  * flink:vkGetPhysicalDeviceWaylandPresentationSupportKHR: Not in this
    extension.
  * flink:vkGetPhysicalDeviceMirPresentationSupportKHR: Not in this
    extension.
  * flink:vkGetPhysicalDeviceWin32PresentationSupportKHR: Not in this
    extension.

=== Version History

 * Revision 1, 2017-02-27 (James Jones)
   - Initial draft.