Safe Haskell	None
Language	Haskell2010

Vulkan.Extensions.VK_KHR_unified_image_layouts

Description

Name

VK_KHR_unified_image_layouts - device extension

VK_KHR_unified_image_layouts

Name String: VK_KHR_unified_image_layouts

Extension Type

Device extension

Registered Extension Number

528

Revision

1

Ratification Status

Ratified

Extension and Version Dependencies

VK_KHR_get_physical_device_properties2 or Vulkan Version 1.1

API Interactions

Interacts with VK_VERSION_1_3
Interacts with VK_EXT_attachment_feedback_loop_layout
Interacts with VK_KHR_dynamic_rendering

Contact

Shahbaz Youssefi @syoussefi%0A*Here describe the issue or question you have about the VK_KHR_unified_image_layouts extension*

Extension Proposal

VK_KHR_unified_image_layouts

Other Extension Metadata

Last Modified Date: 2024-10-15

Interactions and External Dependencies

This extension interacts with VK_EXT_attachment_feedback_loop_layout
This extension interacts with VK_KHR_video_decode_queue
This extension interacts with VK_KHR_video_encode_queue
This extension interacts with VK_KHR_video_encode_quantization_map

Contributors

Ahmed Abdelkhalek, AMD
Tobias Hector, AMD
Jan-Harald Fredriksen, ARM
Ting Wei, ARM
Faith Ekstrand, Collabora
Lina Versace, Google
Shahbaz Youssefi, Google
James Fitzpatrick, Imagination
Daniel Story, Nintendo
James Jones, NVIDIA
Jeff Juliano, NVIDIA
Piers Daniell, NVIDIA
Tony Zlatinski, NVIDIA
Matthew Netsch, Qualcomm
Patrick Boyle, Qualcomm
Daniel Rakos, RasterGrid
Ralph Potter, Samsung
Hans-Kristian Arntzen, VALVE
Samuel Pitoiset, VALVE

Description

This extension significantly simplifies synchronization in Vulkan by removing the need for image layout transitions in most cases. In particular, it guarantees that using the IMAGE_LAYOUT_GENERAL layout everywhere possible is just as efficient as using the other layouts.

New Structures

Extending PhysicalDeviceFeatures2, DeviceCreateInfo:
- PhysicalDeviceUnifiedImageLayoutsFeaturesKHR

If VK_EXT_attachment_feedback_loop_layout and Vulkan Version 1.3 or VK_KHR_dynamic_rendering is supported:

Extending RenderingAttachmentInfo:
- AttachmentFeedbackLoopInfoEXT

New Enum Constants

KHR_UNIFIED_IMAGE_LAYOUTS_EXTENSION_NAME

If VK_EXT_attachment_feedback_loop_layout and Vulkan Version 1.3 or VK_KHR_dynamic_rendering is supported:

Extending StructureType:
- STRUCTURE_TYPE_ATTACHMENT_FEEDBACK_LOOP_INFO_EXT

Version History

Revision 1, 2024-10-15 (Shahbaz Youssefi)
- Initial revision

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.

Synopsis

data PhysicalDeviceUnifiedImageLayoutsFeaturesKHR = PhysicalDeviceUnifiedImageLayoutsFeaturesKHR {
- unifiedImageLayouts :: Bool
- unifiedImageLayoutsVideo :: Bool
}
data AttachmentFeedbackLoopInfoEXT = AttachmentFeedbackLoopInfoEXT {
- feedbackLoopEnable :: Bool
}
type KHR_UNIFIED_IMAGE_LAYOUTS_SPEC_VERSION = 1
pattern KHR_UNIFIED_IMAGE_LAYOUTS_SPEC_VERSION :: Integral a => a
type KHR_UNIFIED_IMAGE_LAYOUTS_EXTENSION_NAME = "VK_KHR_unified_image_layouts"
pattern KHR_UNIFIED_IMAGE_LAYOUTS_EXTENSION_NAME :: (Eq a, IsString a) => a

Documentation

data PhysicalDeviceUnifiedImageLayoutsFeaturesKHR Source #

VkPhysicalDeviceUnifiedImageLayoutsFeaturesKHR - Structure describing whether the implementation provides unified image layouts

Members

This structure describes the following feature:

Description

If the PhysicalDeviceUnifiedImageLayoutsFeaturesKHR structure is included in the pNext chain of the PhysicalDeviceFeatures2 structure passed to getPhysicalDeviceFeatures2, it is filled in to indicate whether each corresponding feature is supported. If the application wishes to use a Device with any features described by PhysicalDeviceUnifiedImageLayoutsFeaturesKHR, it must add an instance of the structure, with the desired feature members set to TRUE, to the pNext chain of DeviceCreateInfo when creating the Device.

Valid Usage (Implicit)

unifiedImageLayouts :: Bool
unifiedImageLayouts specifies whether usage of IMAGE_LAYOUT_GENERAL, where valid, incurs no loss in efficiency. Additionally, it indicates whether it can be used in place of IMAGE_LAYOUT_ATTACHMENT_FEEDBACK_LOOP_OPTIMAL_EXT.
unifiedImageLayoutsVideo :: Bool
unifiedImageLayoutsVideo specifies whether IMAGE_LAYOUT_GENERAL can be used in place of any of the following image layouts with no loss in efficiency.

Instances

Instances details

Eq PhysicalDeviceUnifiedImageLayoutsFeaturesKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_unified_image_layouts Methods (==) :: PhysicalDeviceUnifiedImageLayoutsFeaturesKHR -> PhysicalDeviceUnifiedImageLayoutsFeaturesKHR -> Bool # (/=) :: PhysicalDeviceUnifiedImageLayoutsFeaturesKHR -> PhysicalDeviceUnifiedImageLayoutsFeaturesKHR -> Bool #
Storable PhysicalDeviceUnifiedImageLayoutsFeaturesKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_unified_image_layouts Methods sizeOf :: PhysicalDeviceUnifiedImageLayoutsFeaturesKHR -> Int # alignment :: PhysicalDeviceUnifiedImageLayoutsFeaturesKHR -> Int # peekElemOff :: Ptr PhysicalDeviceUnifiedImageLayoutsFeaturesKHR -> Int -> IO PhysicalDeviceUnifiedImageLayoutsFeaturesKHR # pokeElemOff :: Ptr PhysicalDeviceUnifiedImageLayoutsFeaturesKHR -> Int -> PhysicalDeviceUnifiedImageLayoutsFeaturesKHR -> IO () # peekByteOff :: Ptr b -> Int -> IO PhysicalDeviceUnifiedImageLayoutsFeaturesKHR # pokeByteOff :: Ptr b -> Int -> PhysicalDeviceUnifiedImageLayoutsFeaturesKHR -> IO () # peek :: Ptr PhysicalDeviceUnifiedImageLayoutsFeaturesKHR -> IO PhysicalDeviceUnifiedImageLayoutsFeaturesKHR # poke :: Ptr PhysicalDeviceUnifiedImageLayoutsFeaturesKHR -> PhysicalDeviceUnifiedImageLayoutsFeaturesKHR -> IO () #
Show PhysicalDeviceUnifiedImageLayoutsFeaturesKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_unified_image_layouts Methods showsPrec :: Int -> PhysicalDeviceUnifiedImageLayoutsFeaturesKHR -> ShowS # show :: PhysicalDeviceUnifiedImageLayoutsFeaturesKHR -> String # showList :: [PhysicalDeviceUnifiedImageLayoutsFeaturesKHR] -> ShowS #
FromCStruct PhysicalDeviceUnifiedImageLayoutsFeaturesKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_unified_image_layouts Methods peekCStruct :: Ptr PhysicalDeviceUnifiedImageLayoutsFeaturesKHR -> IO PhysicalDeviceUnifiedImageLayoutsFeaturesKHR Source #
ToCStruct PhysicalDeviceUnifiedImageLayoutsFeaturesKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_unified_image_layouts Methods withCStruct :: PhysicalDeviceUnifiedImageLayoutsFeaturesKHR -> (Ptr PhysicalDeviceUnifiedImageLayoutsFeaturesKHR -> IO b) -> IO b Source # pokeCStruct :: Ptr PhysicalDeviceUnifiedImageLayoutsFeaturesKHR -> PhysicalDeviceUnifiedImageLayoutsFeaturesKHR -> IO b -> IO b Source # withZeroCStruct :: (Ptr PhysicalDeviceUnifiedImageLayoutsFeaturesKHR -> IO b) -> IO b Source # pokeZeroCStruct :: Ptr PhysicalDeviceUnifiedImageLayoutsFeaturesKHR -> IO b -> IO b Source # cStructSize :: Int Source # cStructAlignment :: Int Source #
Zero PhysicalDeviceUnifiedImageLayoutsFeaturesKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_unified_image_layouts Methods zero :: PhysicalDeviceUnifiedImageLayoutsFeaturesKHR Source #

data AttachmentFeedbackLoopInfoEXT Source #

VkAttachmentFeedbackLoopInfoEXT - Structure specifying whether feedback loop is enabled for an attachment

Valid Usage

If the unifiedImageLayouts feature is not enabled, feedbackLoopEnable must be FALSE

Valid Usage (Implicit)

sType must be STRUCTURE_TYPE_ATTACHMENT_FEEDBACK_LOOP_INFO_EXT

Eq AttachmentFeedbackLoopInfoEXT Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_unified_image_layouts Methods (==) :: AttachmentFeedbackLoopInfoEXT -> AttachmentFeedbackLoopInfoEXT -> Bool # (/=) :: AttachmentFeedbackLoopInfoEXT -> AttachmentFeedbackLoopInfoEXT -> Bool #
Storable AttachmentFeedbackLoopInfoEXT Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_unified_image_layouts Methods sizeOf :: AttachmentFeedbackLoopInfoEXT -> Int # alignment :: AttachmentFeedbackLoopInfoEXT -> Int # peekElemOff :: Ptr AttachmentFeedbackLoopInfoEXT -> Int -> IO AttachmentFeedbackLoopInfoEXT # pokeElemOff :: Ptr AttachmentFeedbackLoopInfoEXT -> Int -> AttachmentFeedbackLoopInfoEXT -> IO () # peekByteOff :: Ptr b -> Int -> IO AttachmentFeedbackLoopInfoEXT # pokeByteOff :: Ptr b -> Int -> AttachmentFeedbackLoopInfoEXT -> IO () # peek :: Ptr AttachmentFeedbackLoopInfoEXT -> IO AttachmentFeedbackLoopInfoEXT # poke :: Ptr AttachmentFeedbackLoopInfoEXT -> AttachmentFeedbackLoopInfoEXT -> IO () #
Show AttachmentFeedbackLoopInfoEXT Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_unified_image_layouts Methods showsPrec :: Int -> AttachmentFeedbackLoopInfoEXT -> ShowS # show :: AttachmentFeedbackLoopInfoEXT -> String # showList :: [AttachmentFeedbackLoopInfoEXT] -> ShowS #
FromCStruct AttachmentFeedbackLoopInfoEXT Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_unified_image_layouts Methods peekCStruct :: Ptr AttachmentFeedbackLoopInfoEXT -> IO AttachmentFeedbackLoopInfoEXT Source #
ToCStruct AttachmentFeedbackLoopInfoEXT Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_unified_image_layouts Methods withCStruct :: AttachmentFeedbackLoopInfoEXT -> (Ptr AttachmentFeedbackLoopInfoEXT -> IO b) -> IO b Source # pokeCStruct :: Ptr AttachmentFeedbackLoopInfoEXT -> AttachmentFeedbackLoopInfoEXT -> IO b -> IO b Source # withZeroCStruct :: (Ptr AttachmentFeedbackLoopInfoEXT -> IO b) -> IO b Source # pokeZeroCStruct :: Ptr AttachmentFeedbackLoopInfoEXT -> IO b -> IO b Source # cStructSize :: Int Source # cStructAlignment :: Int Source #
Zero AttachmentFeedbackLoopInfoEXT Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_unified_image_layouts Methods zero :: AttachmentFeedbackLoopInfoEXT Source #

type KHR_UNIFIED_IMAGE_LAYOUTS_SPEC_VERSION = 1 Source #

pattern KHR_UNIFIED_IMAGE_LAYOUTS_SPEC_VERSION :: Integral a => a Source #

type KHR_UNIFIED_IMAGE_LAYOUTS_EXTENSION_NAME = "VK_KHR_unified_image_layouts" Source #

pattern KHR_UNIFIED_IMAGE_LAYOUTS_EXTENSION_NAME :: (Eq a, IsString a) => a Source #

Name

VK_KHR_unified_image_layouts

Other Extension Metadata

Description

New Structures

New Enum Constants

Version History

See Also

Document Notes

Documentation

Members

Description

Valid Usage (Implicit)

See Also

Instances

Valid Usage

Valid Usage (Implicit)

See Also

Instances

AttachmentFeedbackLoopInfoEXT
Fields feedbackLoopEnable :: Bool `feedbackLoopEnable` specifies that feedback loop is enabled for the attachment identified by `RenderingAttachmentInfo`::`imageView`.