VkImageCompressionControlEXT
If the pNext list of VkImageCreateInfo includes a
VkImageCompressionControlEXT structure, then that structure describes
compression controls for this image.
The VkImageCompressionControlEXT structure is defined as:
typedef struct VkImageCompressionControlEXT {
VkStructureType sType;
const void* pNext;
VkImageCompressionFlagsEXT flags;
uint32_t compressionControlPlaneCount;
VkImageCompressionFixedRateFlagsEXT* pFixedRateFlags;
} VkImageCompressionControlEXT;
sTypeis a VkStructureType value identifying this structure.pNextisNULLor a pointer to a structure extending this structure.flagsis a bitmask of VkImageCompressionFlagBitsEXT describing compression controls for the image.compressionControlPlaneCountis the number of entries in thepFixedRateFlagsarray.pFixedRateFlagsisNULLor a pointer to an array of VkImageCompressionFixedRateFlagsEXT bitfields describing allowed fixed-rate compression rates of each image plane. It is ignored ifflagsdoes not includeVK_IMAGE_COMPRESSION_FIXED_RATE_EXPLICIT_EXT.
If enabled, fixed-rate compression is done in an implementation-defined manner and may be applied at block granularity. In that case, a write to an individual texel may modify the value of other texels in the same block.
Valid Usage
VUID-VkImageCompressionControlEXT-flags-06747
flags must be one of VK_IMAGE_COMPRESSION_DEFAULT_EXT,
VK_IMAGE_COMPRESSION_FIXED_RATE_DEFAULT_EXT,
VK_IMAGE_COMPRESSION_FIXED_RATE_EXPLICIT_EXT, or
VK_IMAGE_COMPRESSION_DISABLED_EXT
VUID-VkImageCompressionControlEXT-flags-06748
If flags includes
VK_IMAGE_COMPRESSION_FIXED_RATE_EXPLICIT_EXT,
pFixedRateFlags must not be NULL
Valid Usage (Implicit)
VUID-VkImageCompressionControlEXT-sType-sType
sType must be VK_STRUCTURE_TYPE_IMAGE_COMPRESSION_CONTROL_EXT
Some combinations of compression properties may not be supported. For example, some implementations may not support different fixed-rate compression rates per plane of a multi-planar format and will not be able to enable fixed-rate compression for any plane if the requested rates differ.