Safe Haskell	None
Language	Haskell2010

Vulkan.Extensions.VK_NV_present_barrier

Description

Name

VK_NV_present_barrier - device extension

VK_NV_present_barrier

Name String: VK_NV_present_barrier

Extension Type: Device extension
Registered Extension Number: 293
Revision: 1
Ratification Status: Not ratified
Extension and Version Dependencies

VK_KHR_get_physical_device_properties2 or

Vulkan Version 1.1 and VK_KHR_surface and VK_KHR_get_surface_capabilities2 and VK_KHR_swapchain

Contact

Liya Li @liyli%0A*Here describe the issue or question you have about the VK_NV_present_barrier extension*

Other Extension Metadata

Last Modified Date: 2022-05-16

Contributors

Liya Li, Nvidia
Martin Schwarzer, Nvidia
Andy Wolf, Nvidia
Ian Williams, Nvidia
Ben Morris, Nvidia
James Jones, Nvidia
Jeff Juliano, Nvidia

Description

This extension adds support for synchronizing corresponding presentation requests across multiple swapchains using the present barrier.

New Structures

Extending PhysicalDeviceFeatures2, DeviceCreateInfo:
- PhysicalDevicePresentBarrierFeaturesNV

Extending SurfaceCapabilities2KHR:
- SurfaceCapabilitiesPresentBarrierNV
Extending SwapchainCreateInfoKHR:
- SwapchainPresentBarrierCreateInfoNV

New Enum Constants

NV_PRESENT_BARRIER_EXTENSION_NAME

Issues

1) Is there a query interface to check if a swapchain is using the present barrier?

RESOLVED. There is no such query interface. When creating a swapchain, an application can specify to use the present barrier, and if the swapchain is created successfully, this swapchain will be using the present barrier.

2) Do we need an extra interface to set up the present barrier across distributed systems?

RESOLVED. If the required hardware is presented in the system, and all settings for the physical synchronization with other systems are set up, an implementation manages the configuration automatically when creating a swapchain, without any extra calls from the application.

Version History

Revision 1, 2022-07-20
- Initial version

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 PhysicalDevicePresentBarrierFeaturesNV = PhysicalDevicePresentBarrierFeaturesNV {
- presentBarrier :: Bool
}
data SurfaceCapabilitiesPresentBarrierNV = SurfaceCapabilitiesPresentBarrierNV {
- presentBarrierSupported :: Bool
}
data SwapchainPresentBarrierCreateInfoNV = SwapchainPresentBarrierCreateInfoNV {
- presentBarrierEnable :: Bool
}
type NV_PRESENT_BARRIER_SPEC_VERSION = 1
pattern NV_PRESENT_BARRIER_SPEC_VERSION :: Integral a => a
type NV_PRESENT_BARRIER_EXTENSION_NAME = "VK_NV_present_barrier"
pattern NV_PRESENT_BARRIER_EXTENSION_NAME :: (Eq a, IsString a) => a

Documentation

data PhysicalDevicePresentBarrierFeaturesNV Source #

VkPhysicalDevicePresentBarrierFeaturesNV - Structure indicating support for VK_NV_present_barrier extension

Members

This structure describes the following feature:

Description

If the PhysicalDevicePresentBarrierFeaturesNV 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 PhysicalDevicePresentBarrierFeaturesNV, 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)

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

data SurfaceCapabilitiesPresentBarrierNV Source #

VkSurfaceCapabilitiesPresentBarrierNV - Structure describing present barrier capabilities of a surface

Description

This structure can be included in the pNext chain of SurfaceCapabilities2KHR to determine support for present barrier access. If presentBarrierSupported is FALSE, it indicates that the present barrier feature is not obtainable for this surface.

Valid Usage (Implicit)

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

data SwapchainPresentBarrierCreateInfoNV Source #

VkSwapchainPresentBarrierCreateInfoNV - specify the present barrier membership of this swapchain

Description

If the pNext chain of SwapchainCreateInfoKHR does not include this structure, the default value for presentBarrierEnable is FALSE, meaning the swapchain does not request to use the present barrier. Additionally, when recreating a swapchain that was using the present barrier, and the pNext chain of SwapchainCreateInfoKHR does not include this structure, it means the swapchain will stop using the present barrier.

Valid Usage (Implicit)

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

type NV_PRESENT_BARRIER_SPEC_VERSION = 1 Source #

pattern NV_PRESENT_BARRIER_SPEC_VERSION :: Integral a => a Source #

type NV_PRESENT_BARRIER_EXTENSION_NAME = "VK_NV_present_barrier" Source #

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

Name

VK_NV_present_barrier

Other Extension Metadata

Description

New Structures

New Enum Constants

Issues

Version History

See Also

Document Notes

Documentation

Members

Description

Valid Usage (Implicit)

See Also

Instances

Description

Valid Usage (Implicit)

See Also

Instances

Description

Valid Usage (Implicit)

See Also

Instances

PhysicalDevicePresentBarrierFeaturesNV
Fields presentBarrier :: Bool `presentBarrier` indicates that the implementation supports the present barrier feature.

SurfaceCapabilitiesPresentBarrierNV
Fields presentBarrierSupported :: Bool `presentBarrierSupported` is a boolean describing whether the surface is able to make use of the present barrier feature.

SwapchainPresentBarrierCreateInfoNV
Fields presentBarrierEnable :: Bool `presentBarrierEnable` is a boolean value indicating a request for using the present barrier.