94 lines
4.0 KiB
Plaintext
94 lines
4.0 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/
|
|
|
|
VkPhysicalDeviceSparseProperties(3)
|
|
===================================
|
|
|
|
Name
|
|
----
|
|
VkPhysicalDeviceSparseProperties - Structure specifying physical device sparse memory properties
|
|
|
|
C Specification
|
|
---------------
|
|
|
|
// refBegin VkPhysicalDeviceSparseProperties - Structure specifying physical device sparse memory properties
|
|
|
|
The sname:VkPhysicalDeviceSparseProperties structure is defined as:
|
|
|
|
include::../structs/VkPhysicalDeviceSparseProperties.txt[]
|
|
|
|
|
|
Members
|
|
-------
|
|
|
|
* pname:residencyStandard2DBlockShape is ename:VK_TRUE if the physical
|
|
device will access all single-sample 2D sparse resources using the
|
|
standard sparse image block shapes (based on image format), as described
|
|
in the <<sparsememory-sparseblockshapessingle,Standard Sparse Image Block
|
|
Shapes (Single Sample)>> table. If this property is not supported the
|
|
value returned in the pname:imageGranularity member of the
|
|
sname:VkSparseImageFormatProperties structure for single-sample 2D
|
|
images is not required: to match the standard sparse image block
|
|
dimensions listed in the table.
|
|
* pname:residencyStandard2DMultisampleBlockShape is ename:VK_TRUE if the
|
|
physical device will access all multisample 2D sparse resources using
|
|
the standard sparse image block shapes (based on image format), as
|
|
described in the <<sparsememory-sparseblockshapesmsaa,Standard Sparse
|
|
Image Block Shapes (MSAA)>> table. If this property is not supported, the
|
|
value returned in the pname:imageGranularity member of the
|
|
sname:VkSparseImageFormatProperties structure for multisample 2D images
|
|
is not required: to match the standard sparse image block dimensions
|
|
listed in the table.
|
|
* pname:residencyStandard3DBlockShape is ename:VK_TRUE if the physical
|
|
device will access all 3D sparse resources using the standard sparse image
|
|
block shapes (based on image format), as described in the
|
|
<<sparsememory-sparseblockshapessingle,Standard Sparse Image Block
|
|
Shapes (Single Sample)>> table. If this property is not supported, the
|
|
value returned in the pname:imageGranularity member of the
|
|
sname:VkSparseImageFormatProperties structure for 3D images is not
|
|
required: to match the standard sparse image block dimensions listed in
|
|
the table.
|
|
* pname:residencyAlignedMipSize is ename:VK_TRUE if images with mip level
|
|
dimensions that are not integer multiples of the corresponding dimensions
|
|
of the sparse image block may: be placed in the mip tail. If this property
|
|
is not reported, only mip levels with dimensions smaller than the
|
|
pname:imageGranularity member of the sname:VkSparseImageFormatProperties
|
|
structure will be placed in the mip tail. If this property is reported the
|
|
implementation is allowed to return
|
|
ename:VK_SPARSE_IMAGE_FORMAT_ALIGNED_MIP_SIZE_BIT in the pname:flags
|
|
member of sname:VkSparseImageFormatProperties, indicating that mip level
|
|
dimensions that are not integer multiples of the corresponding dimensions
|
|
of the sparse image block will be placed in the mip tail.
|
|
* pname:residencyNonResidentStrict specifies whether the physical device
|
|
can: consistently access non-resident regions of a resource. If this
|
|
property is ename:VK_TRUE, access to non-resident regions of resources
|
|
will be guaranteed to return values as if the resource were populated
|
|
with 0; writes to non-resident regions will be discarded.
|
|
|
|
|
|
Description
|
|
-----------
|
|
|
|
include::../validity/structs/VkPhysicalDeviceSparseProperties.txt[]
|
|
|
|
|
|
See Also
|
|
--------
|
|
|
|
basetypes:VkBool32, slink:VkPhysicalDeviceProperties
|
|
|
|
|
|
Document Notes
|
|
--------------
|
|
|
|
For more information, see the Vulkan Specification at URL
|
|
|
|
https://www.khronos.org/registry/vulkan/specs/1.0/xhtml/vkspec.html#VkPhysicalDeviceSparseProperties
|
|
|
|
This page is extracted from the Vulkan Specification.
|
|
Fixes and changes should be made to the Specification,not directly.
|
|
|
|
include::footer.txt[]
|
|
|