1// Copyright (c) 2015-2018 The Brenwill Workshop Ltd.
2//
3// SPDX-License-Identifier: CC-BY-4.0
4
5include::{generated}/meta/{refprefix}VK_MVK_macos_surface.adoc[]
6
7=== Other Extension Metadata
8
9*Last Modified Date*::
10    2020-07-31
11*IP Status*::
12    No known IP claims.
13*Contributors*::
14  - Bill Hollings, The Brenwill Workshop Ltd.
15
16=== Description
17
18The `VK_MVK_macos_surface` extension is an instance extension.
19It provides a mechanism to create a slink:VkSurfaceKHR object (defined by
20the `apiext:VK_KHR_surface` extension) based on an code:NSView, the native
21surface type of macOS, which is underpinned by a basetype:CAMetalLayer, to
22support rendering to the surface using Apple's Metal framework.
23
24ifdef::VK_EXT_metal_surface[]
25=== Deprecation by `VK_EXT_metal_surface`
26
27The `VK_MVK_macos_surface` extension is considered deprecated and has been
28superseded by the `apiext:VK_EXT_metal_surface` extension.
29endif::VK_EXT_metal_surface[]
30
31include::{generated}/interfaces/VK_MVK_macos_surface.adoc[]
32
33=== Version History
34
35  * Revision 1, 2017-02-15 (Bill Hollings)
36  ** Initial draft.
37
38  * Revision 2, 2017-02-24 (Bill Hollings)
39  ** Minor syntax fix to emphasize firm requirement for `NSView` to be
40     backed by a `CAMetalLayer`.
41
42  * Revision 3, 2020-07-31 (Bill Hollings)
43  ** Update documentation on requirements for `NSView`.
44  ** Mark as deprecated by `VK_EXT_metal_surface`.
45