• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1// Copyright 2016-2021 The Khronos Group, Inc.
2//
3// SPDX-License-Identifier: CC-BY-4.0
4
5include::{generated}/meta/{refprefix}VK_KHR_create_renderpass2.txt[]
6
7=== Other Extension Metadata
8
9*Last Modified Date*::
10    2018-02-07
11*Interactions and External Dependencies*::
12  - Promoted to Vulkan 1.2 Core
13*Contributors*::
14  - Tobias Hector
15  - Jeff Bolz
16
17=== Description
18
19This extension provides a new entry point to create render passes in a way
20that can be easily extended by other extensions through the substructures of
21render pass creation.
22The Vulkan 1.0 render pass creation sub-structures do not include
23ptext:sType/ptext:pNext members.
24Additionally, the render pass begin/next/end commands have been augmented
25with new extensible structures for passing additional subpass information.
26
27The slink:VkRenderPassMultiviewCreateInfo and
28slink:VkInputAttachmentAspectReference structures that extended the original
29slink:VkRenderPassCreateInfo are not accepted into the new creation
30functions, and instead their parameters are folded into this extension as
31follows:
32
33  * Elements of slink:VkRenderPassMultiviewCreateInfo::pname:pViewMasks are
34    now specified in slink:VkSubpassDescription2KHR::pname:viewMask.
35  * Elements of slink:VkRenderPassMultiviewCreateInfo::pname:pViewOffsets
36    are now specified in slink:VkSubpassDependency2KHR::pname:viewOffset.
37  * slink:VkRenderPassMultiviewCreateInfo::pname:correlationMaskCount and
38    slink:VkRenderPassMultiviewCreateInfo::pname:pCorrelationMasks are
39    directly specified in slink:VkRenderPassCreateInfo2KHR.
40  * slink:VkInputAttachmentAspectReference::pname:aspectMask is now
41    specified in the relevant input attachment description in
42    slink:VkAttachmentDescription2KHR::pname:aspectMask
43
44The details of these mappings are explained fully in the new structures.
45
46=== Promotion to Vulkan 1.2
47
48All functionality in this extension is included in core Vulkan 1.2, with the
49KHR suffix omitted.
50The original type, enum and command names are still available as aliases of
51the core functionality.
52
53include::{generated}/interfaces/VK_KHR_create_renderpass2.txt[]
54
55=== Version History
56
57 * Revision 1, 2018-02-07 (Tobias Hector)
58   - Internal revisions
59