Safe Haskell	Safe-Inferred
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

Extension and Version Dependencies

Requires support for Vulkan 1.0
Requires VK_KHR_get_physical_device_properties2 to be enabled for any device-level functionality
Requires VK_KHR_surface to be enabled for any device-level functionality
Requires VK_KHR_get_surface_capabilities2 to be enabled for any device-level functionality
Requires VK_KHR_swapchain to be enabled for any device-level functionality

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 :: forall a. Integral a => a
type NV_PRESENT_BARRIER_EXTENSION_NAME = "VK_NV_present_barrier"
pattern NV_PRESENT_BARRIER_EXTENSION_NAME :: forall a. (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. PhysicalDevicePresentBarrierFeaturesNV can also be used in the pNext chain of DeviceCreateInfo to selectively enable these features.

Valid Usage (Implicit)

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 #
Eq PhysicalDevicePresentBarrierFeaturesNV Source #
Instance details Defined in Vulkan.Extensions.VK_NV_present_barrier Methods (==) :: PhysicalDevicePresentBarrierFeaturesNV -> PhysicalDevicePresentBarrierFeaturesNV -> Bool # (/=) :: PhysicalDevicePresentBarrierFeaturesNV -> PhysicalDevicePresentBarrierFeaturesNV -> Bool #
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)

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 #
Eq SurfaceCapabilitiesPresentBarrierNV Source #
Instance details Defined in Vulkan.Extensions.VK_NV_present_barrier Methods (==) :: SurfaceCapabilitiesPresentBarrierNV -> SurfaceCapabilitiesPresentBarrierNV -> Bool # (/=) :: SurfaceCapabilitiesPresentBarrierNV -> SurfaceCapabilitiesPresentBarrierNV -> Bool #
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)

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 #
Eq SwapchainPresentBarrierCreateInfoNV Source #
Instance details Defined in Vulkan.Extensions.VK_NV_present_barrier Methods (==) :: SwapchainPresentBarrierCreateInfoNV -> SwapchainPresentBarrierCreateInfoNV -> Bool # (/=) :: SwapchainPresentBarrierCreateInfoNV -> SwapchainPresentBarrierCreateInfoNV -> Bool #
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 :: forall a. Integral a => a Source #

type NV_PRESENT_BARRIER_EXTENSION_NAME = "VK_NV_present_barrier" Source #

pattern NV_PRESENT_BARRIER_EXTENSION_NAME :: forall a. (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.