mirror of
https://github.com/status-im/Vulkan-Docs.git
synced 2025-01-23 20:59:02 +00:00
256a1ef661
* Update release number to 93.
Public Issues:
* Add spec language for ename:VK_INDEX_TYPE_NONE_NV and fix up
slink:VkAccelerationStructureTypeNV (public issue 848).
* Add missing suffix in description of slink:VkSubpassDescription2KHR
parameters (public pull request 851).
* Fix miscellaneous typos (public pull request 855).
* Add driver ID for Pastel (public pull request 856).
* Add missing include directive for slink:VkMemoryWin32HandlePropertiesKHR
implicit valid usage statements (public pull request 857).
Internal Issues:
* Restrict the storage classes permitted for SPIR-V atomics to what is
actually supported, in the <<spirvenv-module-validation, Validation
Rules within a Module>> section (internal issue 1123).
* Add a missing Valid Usage statement to slink:VkRenderPassCreateInfo for
the case pname:stencilLoadOp == ename:VK_LOAD_OP_CLEAR, pname:layout ==
ename:VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL (internal issue
1408).
* Modify optimize-pdf script and Makefile to retain non-optimized original
PDF on errors (internal issue 1435).
* Add <<spirvenv-module-validation, SPIR-V validation rules>> stating that
only the listed code:BuiltIn decorations are permitted, and only when
relevante features and extensions are enabled (internal issue 1449).
* Remove some duplicated Valid Usage IDs created via cut & paste error
(internal issue 1455).
* Build HTML output for extension reference pages (internal issue 1461).
** Improve genRef.py handling of aliases defined inside other refpages.
** Emit aliases in pygenerator.py.
** Add XML noautovalidity flag for VkRenderPassCreateFlags until there
are some corresponding FlagBits defined.
** Corrected types= attribute on some refpage blocks to 'flags'
** Added refpage blocks for some missing types detected by CI tests.
* Fixed many Valid Usage statement issues in slink:VkRenderPassCreateInfo,
slink:VkSubpassDescription, slink:VkSubpassDescription2KHR,
slink:VkSubpassDependency2KHR, flink:vkCmdBeginRenderPass,
flink:vkCmdBeginRenderPass2KHR, and slink:VkRenderPassBeginInfo
discovered while adding `VK_KHR_create_renderpass2` to the validation
layers.
New Extensions:
* `VK_EXT_scalar_block_layout`
* `VK_EXT_separate_stencil_usage`
76 lines
2.7 KiB
Plaintext
76 lines
2.7 KiB
Plaintext
[open,refpage='vkGetPhysicalDeviceSurfaceCapabilities2EXT',desc='Query surface capabilities',type='protos']
|
|
--
|
|
|
|
To query the basic capabilities of a surface, needed in order to create a
|
|
swapchain, call:
|
|
|
|
include::../../api/protos/vkGetPhysicalDeviceSurfaceCapabilities2EXT.txt[]
|
|
|
|
* pname:physicalDevice is the physical device that will be associated with
|
|
the swapchain to be created, as described for
|
|
flink:vkCreateSwapchainKHR.
|
|
* pname:surface is the surface that will be associated with the swapchain.
|
|
* pname:pSurfaceCapabilities is a pointer to an instance of the
|
|
slink:VkSurfaceCapabilities2EXT structure in which the capabilities are
|
|
returned.
|
|
|
|
fname:vkGetPhysicalDeviceSurfaceCapabilities2EXT behaves similarly to
|
|
flink:vkGetPhysicalDeviceSurfaceCapabilitiesKHR, with the ability to return
|
|
extended information by adding extension structures to the pname:pNext chain
|
|
of its pname:pSurfaceCapabilities parameter.
|
|
|
|
include::../../validity/protos/vkGetPhysicalDeviceSurfaceCapabilities2EXT.txt[]
|
|
--
|
|
|
|
[open,refpage='VkSurfaceCapabilities2EXT',desc='Structure describing capabilities of a surface',type='structs']
|
|
--
|
|
|
|
The sname:VkSurfaceCapabilities2EXT structure is defined as:
|
|
|
|
include::../../api/structs/VkSurfaceCapabilities2EXT.txt[]
|
|
|
|
All members of sname:VkSurfaceCapabilities2EXT are identical to the
|
|
corresponding members of slink:VkSurfaceCapabilitiesKHR where one exists.
|
|
The remaining members are:
|
|
|
|
* pname:sType is the type of this structure.
|
|
* pname:pNext is `NULL` or a pointer to an extension-specific structure.
|
|
* pname:supportedSurfaceCounters is a bitmask of
|
|
elink:VkSurfaceCounterFlagBitsEXT indicating the supported surface
|
|
counter types.
|
|
|
|
.Valid Usage
|
|
****
|
|
* [[VUID-VkSurfaceCapabilities2EXT-supportedSurfaceCounters-01246]]
|
|
pname:supportedSurfaceCounters must: not include
|
|
ename:VK_SURFACE_COUNTER_VBLANK_EXT unless the surface queried is a
|
|
<<wsi-display-surfaces,display surface>>.
|
|
****
|
|
|
|
include::../../validity/structs/VkSurfaceCapabilities2EXT.txt[]
|
|
--
|
|
|
|
[open,refpage='VkSurfaceCounterFlagBitsEXT',desc='Surface-relative counter types',type='enums']
|
|
--
|
|
|
|
Bits which can: be set in
|
|
slink:VkSurfaceCapabilities2EXT::pname:supportedSurfaceCounters, indicating
|
|
supported surface counter types, are:
|
|
|
|
include::../../api/enums/VkSurfaceCounterFlagBitsEXT.txt[]
|
|
|
|
* ename:VK_SURFACE_COUNTER_VBLANK_EXT specifies a counter incrementing
|
|
once every time a vertical blanking period occurs on the display
|
|
associated with the surface.
|
|
|
|
--
|
|
|
|
[open,refpage='VkSurfaceCounterFlagsEXT',desc='Bitmask of VkSurfaceCounterFlagBitsEXT',type='flags']
|
|
--
|
|
include::../../api/flags/VkSurfaceCounterFlagsEXT.txt[]
|
|
|
|
tname:VkSurfaceCounterFlagsEXT is a bitmask type for setting a mask of zero
|
|
or more elink:VkSurfaceCounterFlagBitsEXT.
|
|
--
|
|
|