mirror of
https://github.com/status-im/Vulkan-Docs.git
synced 2025-01-21 19:59:52 +00:00
279452463a
* Update release number to 92.
Public Issues:
* Move and modify valid usage statements dealing with pname:aspectMask in
flink:vkCmdClearColorImage, flink:vkCmdClearDepthStencilImage, and
slink:VkClearAttachment, so they are in places where all necessary
information is available (public issue 529).
* Fix math markup in <<textures-texel-anisotropic-filtering, Texel
Anisotropic Filtering>> (public pull request 840).
* Fix misspellings (public pull request 845).
Internal Issues:
* Add installation instructions and a Makefile "`chunked`" target for
chunked HTML generation (internal issue 1352).
* Fix pipeline mesh diagram style; also fix a minor bug in the classic
pipeline diagram where vertex/index buffers wrongly fed into the vertex
shader (internal issue 1436).
* Make asciidoctor ERROR output raise an error, and don't suppress
executed command output from CI make invocation (internal issue 1454).
* Minor typo fixes and clarifications for `VK_NV_raytracing`.
* Cleanup extension-specific properties
** Remove duplicated documentation for pname:maxDiscardRectangles,
pname:pointClippingBehavior, and pname:maxVertexAttribDivisor (they
shouldn't be documented with the other members of
slink:VkPhysicalDeviceLimits at all).
** Remove duplicate anchor for pname:maxVertexAttribDivisor
** Consistently document stext:VkPhysicalDevice<Extension>PropertiesKHR
*** Always document pname:sType/pname:pNext (was inconsistent before)
*** Always mention chaining to slink:VkPhysicalDeviceProperties2 (and not
as slink:VkPhysicalDeviceProperties2KHR)
*** Always include Valid Usage statements last
* Update Makefile 'checklinks' target and associated scripts, and fix
markup problems identified by checkLinks.py, so that we can rely on the
checklinks script as part of Gitlab CI.
44 lines
2.1 KiB
Plaintext
44 lines
2.1 KiB
Plaintext
// Copyright (c) 2014-2018 Khronos Group. This work is licensed under a
|
|
// Creative Commons Attribution 4.0 International License; see
|
|
// http://creativecommons.org/licenses/by/4.0/
|
|
|
|
[[create_shared_swapchains,create_shared_swapchains]]
|
|
|
|
[open,refpage='vkCreateSharedSwapchainsKHR',desc='Create multiple swapchains that share presentable images',type='protos']
|
|
--
|
|
|
|
When the `VK_KHR_display_swapchain` extension is enabled, multiple
|
|
swapchains that share presentable images are created by calling:
|
|
|
|
include::../../api/protos/vkCreateSharedSwapchainsKHR.txt[]
|
|
|
|
* pname:device is the device to create the swapchains for.
|
|
* pname:swapchainCount is the number of swapchains to create.
|
|
* pname:pCreateInfos is a pointer to an array of
|
|
slink:VkSwapchainCreateInfoKHR structures specifying the parameters of
|
|
the created swapchains.
|
|
* pname:pAllocator is the allocator used for host memory allocated for the
|
|
swapchain objects when there is no more specific allocator available
|
|
(see <<memory-allocation,Memory Allocation>>).
|
|
* pname:pSwapchains is a pointer to an array of slink:VkSwapchainKHR
|
|
handles in which the created swapchain objects will be returned.
|
|
|
|
fname:vkCreateSharedSwapchainsKHR is similar to flink:vkCreateSwapchainKHR,
|
|
except that it takes an array of slink:VkSwapchainCreateInfoKHR 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
|
|
ename:VK_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 from ename:VK_IMAGE_LAYOUT_PRESENT_SRC_KHR.
|
|
After destroying one or more of the swapchains, the remaining swapchains and
|
|
the presentable images can: continue to be used.
|
|
|
|
include::../../validity/protos/vkCreateSharedSwapchainsKHR.txt[]
|
|
--
|