Modulevulkan-3.27GHC2021
Vulkan.Extensions.VK_KHR_swapchain_mutable_format
Name
VK_KHR_swapchain_mutable_format - device extension
VK_KHR_swapchain_mutable_format
- Name String
VK_KHR_swapchain_mutable_format
- Extension Type
Device extension
- Registered Extension Number
201
- Revision
1
- Ratification Status
Ratified
- Extension and Version Dependencies
and
- Contact
Other Extension Metadata
- Last Modified Date
2018-03-28
- IP Status
No known IP claims.
- Contributors
Faith Ekstrand, Intel
Jan-Harald Fredriksen, ARM
Jesse Hall, Google
Daniel Rakos, AMD
Ray Smith, ARM
Description
This extension allows processing of swapchain images as different formats to that used by the window system, which is particularly useful for switching between sRGB and linear RGB formats.
It adds a new swapchain creation flag that enables creating image views from presentable images with a different format than the one used to create the swapchain.
New Enum Constants
Extending SwapchainCreateFlagBitsKHR:
Issues
1) Are there any new capabilities needed?
RESOLVED: No. It is expected that all implementations exposing this extension support swapchain image format mutability.
2) Do we need a separate VK_SWAPCHAIN_CREATE_EXTENDED_USAGE_BIT_KHR?
RESOLVED: No. This extension requires VK_KHR_maintenance2 and
presentable images of swapchains created with
SWAPCHAIN_CREATE_MUTABLE_FORMAT_BIT_KHR
are created internally in a way equivalent to specifying both
IMAGE_CREATE_MUTABLE_FORMAT_BIT
and
IMAGE_CREATE_EXTENDED_USAGE_BIT_KHR.
3) Do we need a separate structure to allow specifying an image format list for swapchains?
RESOLVED: No. We simply use the same
ImageFormatListCreateInfoKHR
structure introduced by VK_KHR_image_format_list. The structure is
required to be included in the pNext chain of
SwapchainCreateInfoKHR for
swapchains created with
SWAPCHAIN_CREATE_MUTABLE_FORMAT_BIT_KHR.
Version History
Revision 1, 2018-03-28 (Daniel Rakos)
Internal revisions.
See Also
No cross-references are available
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.
- 4 types
- Packagevulkan-3.27
- Exports13
- LanguageGHC2021
- LicenceBSD-3-Clause
- SourceVK_KHR_swapchain_mutable_format.hs
VkSwapchainCreateFlagBitsKHR - Bitmask controlling swapchain creation
Description
SWAPCHAIN_CREATE_SPLIT_INSTANCE_BIND_REGIONS_BIT_KHR specifies that images created from the swapchain (i.e. with the
swapchainmember of ImageSwapchainCreateInfoKHR set to this swapchain’s handle) must use IMAGE_CREATE_SPLIT_INSTANCE_BIND_REGIONS_BIT.
SWAPCHAIN_CREATE_PROTECTED_BIT_KHR specifies that images created from the swapchain are protected images.
SWAPCHAIN_CREATE_MUTABLE_FORMAT_BIT_KHR specifies that the images of the swapchain can be used to create a ImageView with a different format than what the swapchain was created with. The list of allowed image view formats is specified by adding a ImageFormatListCreateInfo structure to the
pNextchain of SwapchainCreateInfoKHR. In addition, this flag also specifies that the swapchain can be created with usage flags that are not supported for the format the swapchain is created with but are supported for at least one of the allowed image view formats.SWAPCHAIN_CREATE_DEFERRED_MEMORY_ALLOCATION_BIT_KHR specifies that the implementation may defer allocation of memory associated with each swapchain image until its index is to be returned from acquireNextImageKHR or acquireNextImage2KHR for the first time.
SWAPCHAIN_CREATE_PRESENT_ID_2_BIT_KHR specifies that applications can include the PresentId2KHR structure in the
pNextchain of the PresentInfoKHR structure to associate an identifier with each presentation request.SWAPCHAIN_CREATE_PRESENT_WAIT_2_BIT_KHR specifies that applications can use waitForPresent2KHR to wait for the presentation engine to have begun presentation of the presentation request associated with PresentWait2InfoKHR::
presentIdonswapchain.SWAPCHAIN_CREATE_PRESENT_TIMING_BIT_EXT specifies that features supported by the swapchain device in PhysicalDevicePresentTimingFeaturesEXT can be used to collect timing information or schedule presentation requests at specific times.
See Also
Constructors
Instances8Eq, Ord, Read, Show, Bits, FiniteBits, …
Eq SwapchainCreateFlagBitsKHRDefined in vulkan-3.27 · Vulkan.Extensions.VK_KHR_swapchainOrd SwapchainCreateFlagBitsKHRDefined in vulkan-3.27 · Vulkan.Extensions.VK_KHR_swapchainRead SwapchainCreateFlagBitsKHRDefined in vulkan-3.27 · Vulkan.Extensions.VK_KHR_swapchainShow SwapchainCreateFlagBitsKHRDefined in vulkan-3.27 · Vulkan.Extensions.VK_KHR_swapchainBits SwapchainCreateFlagBitsKHRDefined in vulkan-3.27 · Vulkan.Extensions.VK_KHR_swapchainFiniteBits SwapchainCreateFlagBitsKHRDefined in vulkan-3.27 · Vulkan.Extensions.VK_KHR_swapchainStorable SwapchainCreateFlagBitsKHRDefined in vulkan-3.27 · Vulkan.Extensions.VK_KHR_swapchainZero SwapchainCreateFlagBitsKHRDefined in vulkan-3.27 · Vulkan.Extensions.VK_KHR_swapchain