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