// Copyright (c) 2015-2018 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/

include::meta/VK_MVK_macos_surface.txt[]

*Last Modified Date*::
    2017-02-24
*IP Status*::
    No known IP claims.
*Contributors*::
  - 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 dlink: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.