mirror of
https://github.com/status-im/Vulkan-Docs.git
synced 2025-01-12 15:04:10 +00:00
1ca0ea1ef0
* Bump API patch number and header version number to 22 for this update. Github Issues: * Translate the subpass self-dependency language into concrete validity statements, and added a validity statement about the restrictions on layout parameters (public issue 267). * Add validity requirement that slink:VkAttachmentDescription::pname:finalLayout and slink:VkAttachmentReference::pname:layout must not be ename:VK_IMAGE_LAYOUT_UNDEFINED or ename:VK_IMAGE_LAYOUT_PREINITIALIZED (public issue 268). * Clarify that slink:VkSubpassDescription::pname:pResolveAttachments layouts are used. Make language consistent with other attachment arrays (public issue 270). * Changed 64-bit definition for dname:VK_DEFINE_NON_DISPATCHABLE_HANDLE to work for x32 platform in +vk.xml+ and the resulting +vulkan.h+ (public issue 282). * Add missing error return code for flink:vkEnumerateInstanceExtensionProperties and flink:vkEnumerateDeviceExtensionProperties (public issue 285) * Fix several cases of stext::VkStructName.memberName markup to stext::VkStructName::pname:memberName, to match other usage in the spec, and describe this markup in the style guide (public issue 286). * Modified validity language generation script to avoid redundant common ancestor language if covered by generic parent language, and used `Both' instead of `Each' when appropriate (public issue 288). Internal Issues: * Add language about behavior of flink:vkAllocateDescriptorSets when allocation fails due to fragmentation, a new error ename:VK_ERROR_FRAGMENTED_POOL, and a Note explaining the situation (internal issue 309). * For the features of code:PointSize, code:ClipDistance, and code:CullDistance, the SPIR-V capability is required to be declared on use (read or write) rather than on decoration (internal issue 359). * Have desktop versions of GLSL respect precision qualification (code:mediump and code:lowp) when compiling for Vulkan. These will get translated to SPIR-V's code:RelaxedPrecision decoration as they do with OpenGL ES versions of GLSL (ESSL). The default precision of all types is code:highp when using a desktop version (internal issue 360). * Add validity statement for slink:VkImageCreateInfo specifying that multisampled images must be two-dimensional, optimally tiled, and with a single mipmap level (internal issue 369). * Add validity statements to slink:VkImageViewCreateInfo disallowing creation of images or image views with no supported features. Made some slink:VkImageViewCreateInfo validity statements more precise and consistent. Added a Note to the <<features,features>> chapter about formats with no features (internal issue 371). * Remove +manpages+ from default build targets. Nroff outputs containing imbedded latexmath will not render properly. Fixing this is a lot of work for limited use cases (internal issue 401). Other Commits: * Fix flink:vkRenderPassBeginInfo::pname:clearValueCount validity statement to be based on attachment indices rather than the number of cleared attachments (Vulkan-LoaderAndValidationLayers/issues/601). * Convert registry documentation from LaTeX to asciidoc source and rename from +src/spec/readme.tex+ to +src/spec/registry.txt+. * Fix lack of Oxford commas in validity language. * Lots of cleanup of generator scripts and Makefiles to move extension list for generator into the script arguments instead of the body of genvk.py, and express better dependencies between XML, scripts, and generated files.
88 lines
3.4 KiB
Plaintext
88 lines
3.4 KiB
Plaintext
// Copyright (c) 2014-2016 Khronos Group. This work is licensed under a
|
|
// Creative Commons Attribution 4.0 International License; see
|
|
// http://creativecommons.org/licenses/by/4.0/
|
|
|
|
VkSparseImageMemoryRequirements(3)
|
|
==================================
|
|
|
|
Name
|
|
----
|
|
VkSparseImageMemoryRequirements - Structure specifying sparse image memory requirements
|
|
|
|
C Specification
|
|
---------------
|
|
|
|
// refBegin VkSparseImageMemoryRequirements - Structure specifying sparse image memory requirements
|
|
|
|
The sname:VkSparseImageMemoryRequirements structure is defined as:
|
|
|
|
include::../api/structs/VkSparseImageMemoryRequirements.txt[]
|
|
|
|
|
|
Members
|
|
-------
|
|
|
|
* pname:formatProperties.aspectMask is the set of aspects of the image
|
|
that this sparse memory requirement applies to. This will usually have a
|
|
single aspect specified. However, depth/stencil images may: have depth
|
|
and stencil data interleaved in the same sparse block, in which case
|
|
both ename:VK_IMAGE_ASPECT_DEPTH_BIT and
|
|
ename:VK_IMAGE_ASPECT_STENCIL_BIT would be present.
|
|
* pname:formatProperties.imageGranularity describes the dimensions of a
|
|
single bindable sparse image block in pixel units. For aspect
|
|
ename:VK_IMAGE_ASPECT_METADATA_BIT, all dimensions will be zero
|
|
pixels. All metadata is located in the mip tail region.
|
|
* pname:formatProperties.flags is a bitmask of
|
|
elink:VkSparseImageFormatFlagBits:
|
|
** If ename:VK_SPARSE_IMAGE_FORMAT_SINGLE_MIPTAIL_BIT is set the image
|
|
uses a single mip tail region for all array layers.
|
|
** If ename:VK_SPARSE_IMAGE_FORMAT_ALIGNED_MIP_SIZE_BIT is set the
|
|
dimensions of mip levels must: be integer multiples of the corresponding
|
|
dimensions of the sparse image block for levels not located in the mip
|
|
tail.
|
|
** If ename:VK_SPARSE_IMAGE_FORMAT_NONSTANDARD_BLOCK_SIZE_BIT is set the
|
|
image uses non-standard sparse image block dimensions. The
|
|
pname:formatProperties.imageGranularity values do not match the
|
|
standard sparse image block dimension corresponding to the image's
|
|
pixel format.
|
|
* pname:imageMipTailFirstLod is the first mip level at which image
|
|
subresources are included in the mip tail region.
|
|
* pname:imageMipTailSize is the memory size (in bytes) of the mip tail
|
|
region. If pname:formatProperties.flags contains
|
|
ename:VK_SPARSE_IMAGE_FORMAT_SINGLE_MIPTAIL_BIT, this is the size of the
|
|
whole mip tail, otherwise this is the size of the mip tail of a single
|
|
array layer. This value is guaranteed to be a multiple of the sparse block
|
|
size in bytes.
|
|
* pname:imageMipTailOffset is the opaque memory offset used with
|
|
slink:VkSparseImageOpaqueMemoryBindInfo to bind the mip tail region(s).
|
|
* pname:imageMipTailStride is the offset stride between each array-layer's
|
|
mip tail, if pname:formatProperties.flags does not contain
|
|
ename:VK_SPARSE_IMAGE_FORMAT_SINGLE_MIPTAIL_BIT (otherwise the value is
|
|
undefined).
|
|
|
|
|
|
Description
|
|
-----------
|
|
|
|
include::../validity/structs/VkSparseImageMemoryRequirements.txt[]
|
|
|
|
|
|
See Also
|
|
--------
|
|
|
|
basetype:VkDeviceSize, slink:VkSparseImageFormatProperties, flink:vkGetImageSparseMemoryRequirements
|
|
|
|
|
|
Document Notes
|
|
--------------
|
|
|
|
For more information, see the Vulkan Specification at URL
|
|
|
|
https://www.khronos.org/registry/vulkan/specs/1.0/xhtml/vkspec.html#VkSparseImageMemoryRequirements
|
|
|
|
This page is extracted from the Vulkan Specification.
|
|
Fixes and changes should be made to the Specification,not directly.
|
|
|
|
include::footer.txt[]
|
|
|