Class KHRDisplaySwapchain
- java.lang.Object
-
- org.lwjgl.vulkan.KHRDisplaySwapchain
-
public class KHRDisplaySwapchain extends java.lang.Object
This extension provides an API to create a swapchain directly on a device's display without any underlying window system.
-
-
Field Summary
Fields Modifier and Type Field and Description static int
VK_ERROR_INCOMPATIBLE_DISPLAY_KHR
The display used by a swapchain does not use the same presentable image layout, or is incompatible in a way that prevents sharing an image.static java.lang.String
VK_KHR_DISPLAY_SWAPCHAIN_EXTENSION_NAME
The extension name.static int
VK_KHR_DISPLAY_SWAPCHAIN_SPEC_VERSION
The extension specification version.static int
VK_STRUCTURE_TYPE_DISPLAY_PRESENT_INFO_KHR
VkStructureType
-
Method Summary
All Methods Static Methods Concrete Methods Modifier and Type Method and Description static int
vkCreateSharedSwapchainsKHR(VkDevice device, VkSwapchainCreateInfoKHR.Buffer pCreateInfos, VkAllocationCallbacks pAllocator, long[] pSwapchains)
Array version of:CreateSharedSwapchainsKHR
static int
vkCreateSharedSwapchainsKHR(VkDevice device, VkSwapchainCreateInfoKHR.Buffer pCreateInfos, VkAllocationCallbacks pAllocator, java.nio.LongBuffer pSwapchains)
Creates multiple swapchains that share presentable images.
-
-
-
Field Detail
-
VK_KHR_DISPLAY_SWAPCHAIN_SPEC_VERSION
public static final int VK_KHR_DISPLAY_SWAPCHAIN_SPEC_VERSION
The extension specification version.- See Also:
- Constant Field Values
-
VK_KHR_DISPLAY_SWAPCHAIN_EXTENSION_NAME
public static final java.lang.String VK_KHR_DISPLAY_SWAPCHAIN_EXTENSION_NAME
The extension name.- See Also:
- Constant Field Values
-
VK_STRUCTURE_TYPE_DISPLAY_PRESENT_INFO_KHR
public static final int VK_STRUCTURE_TYPE_DISPLAY_PRESENT_INFO_KHR
VkStructureType- See Also:
- Constant Field Values
-
VK_ERROR_INCOMPATIBLE_DISPLAY_KHR
public static final int VK_ERROR_INCOMPATIBLE_DISPLAY_KHR
The display used by a swapchain does not use the same presentable image layout, or is incompatible in a way that prevents sharing an image.- See Also:
- Constant Field Values
-
-
Method Detail
-
vkCreateSharedSwapchainsKHR
public static int vkCreateSharedSwapchainsKHR(VkDevice device, VkSwapchainCreateInfoKHR.Buffer pCreateInfos, VkAllocationCallbacks pAllocator, java.nio.LongBuffer pSwapchains)
Creates multiple swapchains that share presentable images.vkCreateSharedSwapchains
is similar toCreateSwapchainKHR
, except that it takes an array ofVkSwapchainCreateInfoKHR
structures, and returns an array of swapchain objects.The swapchain creation parameters that affect the properties and number of presentable images must match between all the swapchains. If the displays used by any of the swapchains do not use the same presentable image layout or are incompatible in a way that prevents sharing images, swapchain creation will fail with the result code
ERROR_INCOMPATIBLE_DISPLAY_KHR
. If any error occurs, no swapchains will be created. Images presented to multiple swapchains must be re-acquired from all of them before transitioning away fromIMAGE_LAYOUT_PRESENT_SRC_KHR
. After destroying one or more of the swapchains, the remaining swapchains and the presentable images can continue to be used.Valid Usage
device
must be a validVkDevice
handlepCreateInfos
must be a pointer to an array ofswapchainCount
validVkSwapchainCreateInfoKHR
structures- If
pAllocator
is notNULL
,pAllocator
must be a pointer to a validVkAllocationCallbacks
structure pSwapchains
must be a pointer to an array ofswapchainCount
VkSwapchainKHR
handlesswapchainCount
must be greater than 0
Host Synchronization
- Host access to
pCreateInfos
[].surface must be externally synchronized - Host access to
pCreateInfos
[].oldSwapchain must be externally synchronized
- Parameters:
device
- the device to create the swapchains forpCreateInfos
- a pointer to an array ofVkSwapchainCreateInfoKHR
structures specifying the parameters of the created swapchainspAllocator
- controls host memory allocationpSwapchains
- a pointer to an array ofVkSwapchainKHR
handles in which the created swapchain objects will be returned
-
vkCreateSharedSwapchainsKHR
public static int vkCreateSharedSwapchainsKHR(VkDevice device, VkSwapchainCreateInfoKHR.Buffer pCreateInfos, VkAllocationCallbacks pAllocator, long[] pSwapchains)
Array version of:CreateSharedSwapchainsKHR
-
-