// Copyright (c) 2015-2017 The Brenwill Workshop Ltd. This work is licensed under a
// Creative Commons Attribution 4.0 International License; see
// http://creativecommons.org/licenses/by/4.0/

[[VK_MVK_macos_surface]]
== VK_MVK_macos_surface

*Name String*::
    +VK_MVK_macos_surface+
*Extension Type*::
    Instance extension
*Registered Extension Number*::
    124
*Last Modified Date*::
    2017-02-24
*Revision*::
    2
*IP Status*::
    No known IP claims.
*Dependencies*::
  - This extension is written against version 1.0 of the Vulkan API.
  - Requires +VK_KHR_surface+.
*Contributors*::
  - Bill Hollings, The Brenwill Workshop Ltd.
*Contacts*::
  - Bill Hollings, The Brenwill Workshop Ltd.

The +VK_MVK_macos_surface+ extension is an instance extension.
It provides a mechanism to create a slink:VkSurfaceKHR object (defined by
the +VK_KHR_surface+ extension) that refers to an code:NSView, the native
surface type of macOS, which is underpinned by a code:CAMetalLayer, to
support rendering to the surface using Apple's Metal framework.

=== New Object Types

None.

=== New Enum Constants

  * Extending elink:VkStructureType:
  ** ename:VK_STRUCTURE_TYPE_MACOS_SURFACE_CREATE_INFO_MVK

=== New Enums

None.

=== New Structures

  * slink:VkMacOSSurfaceCreateInfoMVK

=== New Functions

  * flink:vkCreateMacOSSurfaceMVK

=== Issues

None.

=== Version History

 * Revision 1, 2017-02-15 (Bill Hollings)
   - Initial draft.

 * Revision 2, 2017-02-24 (Bill Hollings)
   - Minor syntax fix to emphasize firm requirement for NSView to be backed
     by a CAMetalLayer.