// 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_ios_surface.txt[]

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