// Copyright (c) 2015-2017 The Brenwill Workshop Ltd.
// Copyright notice at https://www.khronos.org/registry/speccopyright.html

[[VK_MVK_ios_surface]]
== VK_MVK_ios_surface

*Name String*::
    +VK_MVK_ios_surface+
*Extension Type*::
    Instance extension
*Registered Extension Number*::
    123
*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_ios_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 a code:UIView, the native
surface type of iOS, 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_IOS_SURFACE_CREATE_INFO_MVK

=== New Enums

None.

=== New Structures

  * slink:VkIOSSurfaceCreateInfoMVK

=== New Functions

  * flink:vkCreateIOSSurfaceMVK

=== 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 UIView to be backed
     by a CAMetalLayer.