Vulkan.Extensions.VK_KHR_create_renderpass2

Name

VK_KHR_create_renderpass2 - device extension

VK_KHR_create_renderpass2

Name String

VK_KHR_create_renderpass2

Extension Type

Device extension

Registered Extension Number

110

Revision

1

Extension and Version Dependencies

• Requires Vulkan 1.0
• Requires VK_KHR_multiview
• Requires VK_KHR_maintenance2

Deprecation state

• Promoted to Vulkan 1.2

Contact

• Tobias Hector https://github.com/KhronosGroup/Vulkan-Docs/issues/new?title=VK_KHR_create_renderpass2:%20&body=@tobias%20

Other Extension Metadata

Last Modified Date

2018-02-07

Interactions and External Dependencies

• Promoted to Vulkan 1.2 Core

Contributors

• Tobias Hector
• Jeff Bolz

Description

This extension provides a new entry point to create render passes in a way that can be easily extended by other extensions through the substructures of render pass creation. The Vulkan 1.0 render pass creation sub-structures do not include sType/pNext members. Additionally, the renderpass begin/next/end commands have been augmented with new extensible structures for passing additional subpass information.

The RenderPassMultiviewCreateInfo and InputAttachmentAspectReference structures that extended the original RenderPassCreateInfo are not accepted into the new creation functions, and instead their parameters are folded into this extension as follows:

• Elements of RenderPassMultiviewCreateInfo::pViewMasks are now specified in SubpassDescription2KHR::viewMask.
• Elements of RenderPassMultiviewCreateInfo::pViewOffsets are now specified in SubpassDependency2KHR::viewOffset.
• RenderPassMultiviewCreateInfo::correlationMaskCount and RenderPassMultiviewCreateInfo::pCorrelationMasks are directly specified in RenderPassCreateInfo2KHR.
• InputAttachmentAspectReference::aspectMask is now specified in the relevant input attachment description in AttachmentDescription2KHR::aspectMask

The details of these mappings are explained fully in the new structures.

Promotion to Vulkan 1.2

All functionality in this extension is included in core Vulkan 1.2, with the KHR suffix omitted. The original type, enum and command names are still available as aliases of the core functionality.

New Commands

• cmdBeginRenderPass2KHR

• cmdEndRenderPass2KHR
• cmdNextSubpass2KHR
• createRenderPass2KHR

New Structures

• AttachmentDescription2KHR

• AttachmentReference2KHR
• RenderPassCreateInfo2KHR
• SubpassBeginInfoKHR
• SubpassDependency2KHR
• SubpassDescription2KHR
• SubpassEndInfoKHR

New Enum Constants

• KHR_CREATE_RENDERPASS_2_EXTENSION_NAME

• KHR_CREATE_RENDERPASS_2_SPEC_VERSION

• Extending StructureType:

  • STRUCTURE_TYPE_ATTACHMENT_DESCRIPTION_2_KHR
  • STRUCTURE_TYPE_ATTACHMENT_REFERENCE_2_KHR
  • STRUCTURE_TYPE_RENDER_PASS_CREATE_INFO_2_KHR
  • STRUCTURE_TYPE_SUBPASS_BEGIN_INFO_KHR
  • STRUCTURE_TYPE_SUBPASS_DEPENDENCY_2_KHR
  • STRUCTURE_TYPE_SUBPASS_DESCRIPTION_2_KHR
  • STRUCTURE_TYPE_SUBPASS_END_INFO_KHR

Version History

• Revision 1, 2018-02-07 (Tobias Hector)

  • Internal revisions

See Also

AttachmentDescription2KHR, AttachmentReference2KHR, RenderPassCreateInfo2KHR, SubpassBeginInfoKHR, SubpassDependency2KHR, SubpassDescription2KHR, SubpassEndInfoKHR, cmdBeginRenderPass2KHR, cmdEndRenderPass2KHR, cmdNextSubpass2KHR, createRenderPass2KHR

Document Notes

For more information, see the Vulkan Specification

This page is a generated document. Fixes and changes should be made to the generator scripts, not directly.

Documentation

pattern STRUCTURE_TYPE_ATTACHMENT_DESCRIPTION_2_KHR :: StructureType

pattern STRUCTURE_TYPE_ATTACHMENT_REFERENCE_2_KHR :: StructureType

pattern STRUCTURE_TYPE_SUBPASS_DESCRIPTION_2_KHR :: StructureType

pattern STRUCTURE_TYPE_SUBPASS_DEPENDENCY_2_KHR :: StructureType

pattern STRUCTURE_TYPE_RENDER_PASS_CREATE_INFO_2_KHR :: StructureType

pattern STRUCTURE_TYPE_SUBPASS_BEGIN_INFO_KHR :: StructureType

pattern STRUCTURE_TYPE_SUBPASS_END_INFO_KHR :: StructureType

createRenderPass2KHR :: forall (a :: [Type]) io. (Extendss RenderPassCreateInfo2 a, PokeChain a, MonadIO io) => Device -> RenderPassCreateInfo2 a -> ("allocator" ::: Maybe AllocationCallbacks) -> io RenderPass

cmdBeginRenderPass2KHR :: forall (a :: [Type]) io. (Extendss RenderPassBeginInfo a, PokeChain a, MonadIO io) => CommandBuffer -> RenderPassBeginInfo a -> SubpassBeginInfo -> io ()

cmdNextSubpass2KHR :: MonadIO io => CommandBuffer -> SubpassBeginInfo -> SubpassEndInfo -> io ()

cmdEndRenderPass2KHR :: MonadIO io => CommandBuffer -> SubpassEndInfo -> io ()

type AttachmentDescription2KHR = AttachmentDescription2

type AttachmentReference2KHR = AttachmentReference2

type SubpassDescription2KHR = SubpassDescription2

type SubpassDependency2KHR = SubpassDependency2

type RenderPassCreateInfo2KHR = RenderPassCreateInfo2

type SubpassBeginInfoKHR = SubpassBeginInfo

type SubpassEndInfoKHR = SubpassEndInfo

type KHR_CREATE_RENDERPASS_2_SPEC_VERSION = 1

pattern KHR_CREATE_RENDERPASS_2_SPEC_VERSION :: forall a. Integral a => a

type KHR_CREATE_RENDERPASS_2_EXTENSION_NAME = "VK_KHR_create_renderpass2"

pattern KHR_CREATE_RENDERPASS_2_EXTENSION_NAME :: forall a. (Eq a, IsString a) => a