src/intel/vulkan/anv_formats.c

   1 /*
   2  * Copyright © 2015 Intel Corporation
   3  *
   4  * Permission is hereby granted, free of charge, to any person obtaining a
   5  * copy of this software and associated documentation files (the "Software"),
   6  * to deal in the Software without restriction, including without limitation
   7  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
   8  * and/or sell copies of the Software, and to permit persons to whom the
   9  * Software is furnished to do so, subject to the following conditions:
  10  *
  11  * The above copyright notice and this permission notice (including the next
  12  * paragraph) shall be included in all copies or substantial portions of the
  13  * Software.
  14  *
  15  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  16  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  17  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  18  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  19  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
  20  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
  21  * IN THE SOFTWARE.
  22  */
  23
  24 #include "anv_private.h"
  25 #include "vk_format_info.h"
  26 #include "vk_util.h"
  27
  28 /*
  29  * gcc-4 and earlier don't allow compound literals where a constant
  30  * is required in -std=c99/gnu99 mode, so we can't use ISL_SWIZZLE()
  31  * here. -std=c89/gnu89 would allow it, but we depend on c99 features
  32  * so using -std=c89/gnu89 is not an option. Starting from gcc-5
  33  * compound literals can also be considered constant in -std=c99/gnu99
  34  * mode.
  35  */
  36 #define _ISL_SWIZZLE(r, g, b, a) { \
  37       ISL_CHANNEL_SELECT_##r, \
  38       ISL_CHANNEL_SELECT_##g, \
  39       ISL_CHANNEL_SELECT_##b, \
  40       ISL_CHANNEL_SELECT_##a, \
  41 }
  42
  43 #define RGBA _ISL_SWIZZLE(RED, GREEN, BLUE, ALPHA)
  44 #define BGRA _ISL_SWIZZLE(BLUE, GREEN, RED, ALPHA)
  45 #define RGB1 _ISL_SWIZZLE(RED, GREEN, BLUE, ONE)
  46
  47 #define swiz_fmt(__vk_fmt, __hw_fmt, __swizzle)     \
  48    [__vk_fmt] = { \
  49       .isl_format = __hw_fmt, \
  50       .swizzle = __swizzle, \
  51    }
  52
  53 #define fmt(__vk_fmt, __hw_fmt) \
  54    swiz_fmt(__vk_fmt, __hw_fmt, RGBA)
  55
  56 /* HINT: For array formats, the ISL name should match the VK name.  For
  57  * packed formats, they should have the channels in reverse order from each
  58  * other.  The reason for this is that, for packed formats, the ISL (and
  59  * bspec) names are in LSB -> MSB order while VK formats are MSB -> LSB.
  60  */
  61 static const struct anv_format anv_formats[] = {
  62    fmt(VK_FORMAT_UNDEFINED,               ISL_FORMAT_UNSUPPORTED),
  63    fmt(VK_FORMAT_R4G4_UNORM_PACK8,        ISL_FORMAT_UNSUPPORTED),
  64    fmt(VK_FORMAT_R4G4B4A4_UNORM_PACK16,   ISL_FORMAT_A4B4G4R4_UNORM),
  65    swiz_fmt(VK_FORMAT_B4G4R4A4_UNORM_PACK16,   ISL_FORMAT_A4B4G4R4_UNORM,  BGRA),
  66    fmt(VK_FORMAT_R5G6B5_UNORM_PACK16,     ISL_FORMAT_B5G6R5_UNORM),
  67    swiz_fmt(VK_FORMAT_B5G6R5_UNORM_PACK16,     ISL_FORMAT_B5G6R5_UNORM, BGRA),
  68    fmt(VK_FORMAT_R5G5B5A1_UNORM_PACK16,   ISL_FORMAT_A1B5G5R5_UNORM),
  69    fmt(VK_FORMAT_B5G5R5A1_UNORM_PACK16,   ISL_FORMAT_UNSUPPORTED),
  70    fmt(VK_FORMAT_A1R5G5B5_UNORM_PACK16,   ISL_FORMAT_B5G5R5A1_UNORM),
  71    fmt(VK_FORMAT_R8_UNORM,                ISL_FORMAT_R8_UNORM),
  72    fmt(VK_FORMAT_R8_SNORM,                ISL_FORMAT_R8_SNORM),
  73    fmt(VK_FORMAT_R8_USCALED,              ISL_FORMAT_R8_USCALED),
  74    fmt(VK_FORMAT_R8_SSCALED,              ISL_FORMAT_R8_SSCALED),
  75    fmt(VK_FORMAT_R8_UINT,                 ISL_FORMAT_R8_UINT),
  76    fmt(VK_FORMAT_R8_SINT,                 ISL_FORMAT_R8_SINT),
  77    fmt(VK_FORMAT_R8_SRGB,                 ISL_FORMAT_UNSUPPORTED),
  78    fmt(VK_FORMAT_R8G8_UNORM,              ISL_FORMAT_R8G8_UNORM),
  79    fmt(VK_FORMAT_R8G8_SNORM,              ISL_FORMAT_R8G8_SNORM),
  80    fmt(VK_FORMAT_R8G8_USCALED,            ISL_FORMAT_R8G8_USCALED),
  81    fmt(VK_FORMAT_R8G8_SSCALED,            ISL_FORMAT_R8G8_SSCALED),
  82    fmt(VK_FORMAT_R8G8_UINT,               ISL_FORMAT_R8G8_UINT),
  83    fmt(VK_FORMAT_R8G8_SINT,               ISL_FORMAT_R8G8_SINT),
  84    fmt(VK_FORMAT_R8G8_SRGB,               ISL_FORMAT_UNSUPPORTED), /* L8A8_UNORM_SRGB */
  85    fmt(VK_FORMAT_R8G8B8_UNORM,            ISL_FORMAT_R8G8B8_UNORM),
  86    fmt(VK_FORMAT_R8G8B8_SNORM,            ISL_FORMAT_R8G8B8_SNORM),
  87    fmt(VK_FORMAT_R8G8B8_USCALED,          ISL_FORMAT_R8G8B8_USCALED),
  88    fmt(VK_FORMAT_R8G8B8_SSCALED,          ISL_FORMAT_R8G8B8_SSCALED),
  89    fmt(VK_FORMAT_R8G8B8_UINT,             ISL_FORMAT_R8G8B8_UINT),
  90    fmt(VK_FORMAT_R8G8B8_SINT,             ISL_FORMAT_R8G8B8_SINT),
  91    fmt(VK_FORMAT_R8G8B8_SRGB,             ISL_FORMAT_R8G8B8_UNORM_SRGB),
  92    fmt(VK_FORMAT_R8G8B8A8_UNORM,          ISL_FORMAT_R8G8B8A8_UNORM),
  93    fmt(VK_FORMAT_R8G8B8A8_SNORM,          ISL_FORMAT_R8G8B8A8_SNORM),
  94    fmt(VK_FORMAT_R8G8B8A8_USCALED,        ISL_FORMAT_R8G8B8A8_USCALED),
  95    fmt(VK_FORMAT_R8G8B8A8_SSCALED,        ISL_FORMAT_R8G8B8A8_SSCALED),
  96    fmt(VK_FORMAT_R8G8B8A8_UINT,           ISL_FORMAT_R8G8B8A8_UINT),
  97    fmt(VK_FORMAT_R8G8B8A8_SINT,           ISL_FORMAT_R8G8B8A8_SINT),
  98    fmt(VK_FORMAT_R8G8B8A8_SRGB,           ISL_FORMAT_R8G8B8A8_UNORM_SRGB),
  99    fmt(VK_FORMAT_A8B8G8R8_UNORM_PACK32,   ISL_FORMAT_R8G8B8A8_UNORM),
 100    fmt(VK_FORMAT_A8B8G8R8_SNORM_PACK32,   ISL_FORMAT_R8G8B8A8_SNORM),
 101    fmt(VK_FORMAT_A8B8G8R8_USCALED_PACK32, ISL_FORMAT_R8G8B8A8_USCALED),
 102    fmt(VK_FORMAT_A8B8G8R8_SSCALED_PACK32, ISL_FORMAT_R8G8B8A8_SSCALED),
 103    fmt(VK_FORMAT_A8B8G8R8_UINT_PACK32,    ISL_FORMAT_R8G8B8A8_UINT),
 104    fmt(VK_FORMAT_A8B8G8R8_SINT_PACK32,    ISL_FORMAT_R8G8B8A8_SINT),
 105    fmt(VK_FORMAT_A8B8G8R8_SRGB_PACK32,    ISL_FORMAT_R8G8B8A8_UNORM_SRGB),
 106    fmt(VK_FORMAT_A2R10G10B10_UNORM_PACK32, ISL_FORMAT_B10G10R10A2_UNORM),
 107    fmt(VK_FORMAT_A2R10G10B10_SNORM_PACK32, ISL_FORMAT_B10G10R10A2_SNORM),
 108    fmt(VK_FORMAT_A2R10G10B10_USCALED_PACK32, ISL_FORMAT_B10G10R10A2_USCALED),
 109    fmt(VK_FORMAT_A2R10G10B10_SSCALED_PACK32, ISL_FORMAT_B10G10R10A2_SSCALED),
 110    fmt(VK_FORMAT_A2R10G10B10_UINT_PACK32, ISL_FORMAT_B10G10R10A2_UINT),
 111    fmt(VK_FORMAT_A2R10G10B10_SINT_PACK32, ISL_FORMAT_B10G10R10A2_SINT),
 112    fmt(VK_FORMAT_A2B10G10R10_UNORM_PACK32, ISL_FORMAT_R10G10B10A2_UNORM),
 113    fmt(VK_FORMAT_A2B10G10R10_SNORM_PACK32, ISL_FORMAT_R10G10B10A2_SNORM),
 114    fmt(VK_FORMAT_A2B10G10R10_USCALED_PACK32, ISL_FORMAT_R10G10B10A2_USCALED),
 115    fmt(VK_FORMAT_A2B10G10R10_SSCALED_PACK32, ISL_FORMAT_R10G10B10A2_SSCALED),
 116    fmt(VK_FORMAT_A2B10G10R10_UINT_PACK32, ISL_FORMAT_R10G10B10A2_UINT),
 117    fmt(VK_FORMAT_A2B10G10R10_SINT_PACK32, ISL_FORMAT_R10G10B10A2_SINT),
 118    fmt(VK_FORMAT_R16_UNORM,               ISL_FORMAT_R16_UNORM),
 119    fmt(VK_FORMAT_R16_SNORM,               ISL_FORMAT_R16_SNORM),
 120    fmt(VK_FORMAT_R16_USCALED,             ISL_FORMAT_R16_USCALED),
 121    fmt(VK_FORMAT_R16_SSCALED,             ISL_FORMAT_R16_SSCALED),
 122    fmt(VK_FORMAT_R16_UINT,                ISL_FORMAT_R16_UINT),
 123    fmt(VK_FORMAT_R16_SINT,                ISL_FORMAT_R16_SINT),
 124    fmt(VK_FORMAT_R16_SFLOAT,              ISL_FORMAT_R16_FLOAT),
 125    fmt(VK_FORMAT_R16G16_UNORM,            ISL_FORMAT_R16G16_UNORM),
 126    fmt(VK_FORMAT_R16G16_SNORM,            ISL_FORMAT_R16G16_SNORM),
 127    fmt(VK_FORMAT_R16G16_USCALED,          ISL_FORMAT_R16G16_USCALED),
 128    fmt(VK_FORMAT_R16G16_SSCALED,          ISL_FORMAT_R16G16_SSCALED),
 129    fmt(VK_FORMAT_R16G16_UINT,             ISL_FORMAT_R16G16_UINT),
 130    fmt(VK_FORMAT_R16G16_SINT,             ISL_FORMAT_R16G16_SINT),
 131    fmt(VK_FORMAT_R16G16_SFLOAT,           ISL_FORMAT_R16G16_FLOAT),
 132    fmt(VK_FORMAT_R16G16B16_UNORM,         ISL_FORMAT_R16G16B16_UNORM),
 133    fmt(VK_FORMAT_R16G16B16_SNORM,         ISL_FORMAT_R16G16B16_SNORM),
 134    fmt(VK_FORMAT_R16G16B16_USCALED,       ISL_FORMAT_R16G16B16_USCALED),
 135    fmt(VK_FORMAT_R16G16B16_SSCALED,       ISL_FORMAT_R16G16B16_SSCALED),
 136    fmt(VK_FORMAT_R16G16B16_UINT,          ISL_FORMAT_R16G16B16_UINT),
 137    fmt(VK_FORMAT_R16G16B16_SINT,          ISL_FORMAT_R16G16B16_SINT),
 138    fmt(VK_FORMAT_R16G16B16_SFLOAT,        ISL_FORMAT_R16G16B16_FLOAT),
 139    fmt(VK_FORMAT_R16G16B16A16_UNORM,      ISL_FORMAT_R16G16B16A16_UNORM),
 140    fmt(VK_FORMAT_R16G16B16A16_SNORM,      ISL_FORMAT_R16G16B16A16_SNORM),
 141    fmt(VK_FORMAT_R16G16B16A16_USCALED,    ISL_FORMAT_R16G16B16A16_USCALED),
 142    fmt(VK_FORMAT_R16G16B16A16_SSCALED,    ISL_FORMAT_R16G16B16A16_SSCALED),
 143    fmt(VK_FORMAT_R16G16B16A16_UINT,       ISL_FORMAT_R16G16B16A16_UINT),
 144    fmt(VK_FORMAT_R16G16B16A16_SINT,       ISL_FORMAT_R16G16B16A16_SINT),
 145    fmt(VK_FORMAT_R16G16B16A16_SFLOAT,     ISL_FORMAT_R16G16B16A16_FLOAT),
 146    fmt(VK_FORMAT_R32_UINT,                ISL_FORMAT_R32_UINT),
 147    fmt(VK_FORMAT_R32_SINT,                ISL_FORMAT_R32_SINT),
 148    fmt(VK_FORMAT_R32_SFLOAT,              ISL_FORMAT_R32_FLOAT),
 149    fmt(VK_FORMAT_R32G32_UINT,             ISL_FORMAT_R32G32_UINT),
 150    fmt(VK_FORMAT_R32G32_SINT,             ISL_FORMAT_R32G32_SINT),
 151    fmt(VK_FORMAT_R32G32_SFLOAT,           ISL_FORMAT_R32G32_FLOAT),
 152    fmt(VK_FORMAT_R32G32B32_UINT,          ISL_FORMAT_R32G32B32_UINT),
 153    fmt(VK_FORMAT_R32G32B32_SINT,          ISL_FORMAT_R32G32B32_SINT),
 154    fmt(VK_FORMAT_R32G32B32_SFLOAT,        ISL_FORMAT_R32G32B32_FLOAT),
 155    fmt(VK_FORMAT_R32G32B32A32_UINT,       ISL_FORMAT_R32G32B32A32_UINT),
 156    fmt(VK_FORMAT_R32G32B32A32_SINT,       ISL_FORMAT_R32G32B32A32_SINT),
 157    fmt(VK_FORMAT_R32G32B32A32_SFLOAT,     ISL_FORMAT_R32G32B32A32_FLOAT),
 158    fmt(VK_FORMAT_R64_UINT,                ISL_FORMAT_R64_PASSTHRU),
 159    fmt(VK_FORMAT_R64_SINT,                ISL_FORMAT_R64_PASSTHRU),
 160    fmt(VK_FORMAT_R64_SFLOAT,              ISL_FORMAT_R64_PASSTHRU),
 161    fmt(VK_FORMAT_R64G64_UINT,             ISL_FORMAT_R64G64_PASSTHRU),
 162    fmt(VK_FORMAT_R64G64_SINT,             ISL_FORMAT_R64G64_PASSTHRU),
 163    fmt(VK_FORMAT_R64G64_SFLOAT,           ISL_FORMAT_R64G64_PASSTHRU),
 164    fmt(VK_FORMAT_R64G64B64_UINT,          ISL_FORMAT_R64G64B64_PASSTHRU),
 165    fmt(VK_FORMAT_R64G64B64_SINT,          ISL_FORMAT_R64G64B64_PASSTHRU),
 166    fmt(VK_FORMAT_R64G64B64_SFLOAT,        ISL_FORMAT_R64G64B64_PASSTHRU),
 167    fmt(VK_FORMAT_R64G64B64A64_UINT,       ISL_FORMAT_R64G64B64A64_PASSTHRU),
 168    fmt(VK_FORMAT_R64G64B64A64_SINT,       ISL_FORMAT_R64G64B64A64_PASSTHRU),
 169    fmt(VK_FORMAT_R64G64B64A64_SFLOAT,     ISL_FORMAT_R64G64B64A64_PASSTHRU),
 170    fmt(VK_FORMAT_B10G11R11_UFLOAT_PACK32, ISL_FORMAT_R11G11B10_FLOAT),
 171    fmt(VK_FORMAT_E5B9G9R9_UFLOAT_PACK32,  ISL_FORMAT_R9G9B9E5_SHAREDEXP),
 172
 173    fmt(VK_FORMAT_D16_UNORM,               ISL_FORMAT_R16_UNORM),
 174    fmt(VK_FORMAT_X8_D24_UNORM_PACK32,     ISL_FORMAT_R24_UNORM_X8_TYPELESS),
 175    fmt(VK_FORMAT_D32_SFLOAT,              ISL_FORMAT_R32_FLOAT),
 176    fmt(VK_FORMAT_S8_UINT,                 ISL_FORMAT_R8_UINT),
 177    fmt(VK_FORMAT_D16_UNORM_S8_UINT,       ISL_FORMAT_UNSUPPORTED),
 178    fmt(VK_FORMAT_D24_UNORM_S8_UINT,       ISL_FORMAT_R24_UNORM_X8_TYPELESS),
 179    fmt(VK_FORMAT_D32_SFLOAT_S8_UINT,      ISL_FORMAT_R32_FLOAT),
 180
 181    swiz_fmt(VK_FORMAT_BC1_RGB_UNORM_BLOCK,     ISL_FORMAT_BC1_UNORM, RGB1),
 182    swiz_fmt(VK_FORMAT_BC1_RGB_SRGB_BLOCK,      ISL_FORMAT_BC1_UNORM_SRGB, RGB1),
 183    fmt(VK_FORMAT_BC1_RGBA_UNORM_BLOCK,    ISL_FORMAT_BC1_UNORM),
 184    fmt(VK_FORMAT_BC1_RGBA_SRGB_BLOCK,     ISL_FORMAT_BC1_UNORM_SRGB),
 185    fmt(VK_FORMAT_BC2_UNORM_BLOCK,         ISL_FORMAT_BC2_UNORM),
 186    fmt(VK_FORMAT_BC2_SRGB_BLOCK,          ISL_FORMAT_BC2_UNORM_SRGB),
 187    fmt(VK_FORMAT_BC3_UNORM_BLOCK,         ISL_FORMAT_BC3_UNORM),
 188    fmt(VK_FORMAT_BC3_SRGB_BLOCK,          ISL_FORMAT_BC3_UNORM_SRGB),
 189    fmt(VK_FORMAT_BC4_UNORM_BLOCK,         ISL_FORMAT_BC4_UNORM),
 190    fmt(VK_FORMAT_BC4_SNORM_BLOCK,         ISL_FORMAT_BC4_SNORM),
 191    fmt(VK_FORMAT_BC5_UNORM_BLOCK,         ISL_FORMAT_BC5_UNORM),
 192    fmt(VK_FORMAT_BC5_SNORM_BLOCK,         ISL_FORMAT_BC5_SNORM),
 193    fmt(VK_FORMAT_BC6H_UFLOAT_BLOCK,       ISL_FORMAT_BC6H_UF16),
 194    fmt(VK_FORMAT_BC6H_SFLOAT_BLOCK,       ISL_FORMAT_BC6H_SF16),
 195    fmt(VK_FORMAT_BC7_UNORM_BLOCK,         ISL_FORMAT_BC7_UNORM),
 196    fmt(VK_FORMAT_BC7_SRGB_BLOCK,          ISL_FORMAT_BC7_UNORM_SRGB),
 197    fmt(VK_FORMAT_ETC2_R8G8B8_UNORM_BLOCK, ISL_FORMAT_ETC2_RGB8),
 198    fmt(VK_FORMAT_ETC2_R8G8B8_SRGB_BLOCK,  ISL_FORMAT_ETC2_SRGB8),
 199    fmt(VK_FORMAT_ETC2_R8G8B8A1_UNORM_BLOCK, ISL_FORMAT_ETC2_RGB8_PTA),
 200    fmt(VK_FORMAT_ETC2_R8G8B8A1_SRGB_BLOCK, ISL_FORMAT_ETC2_SRGB8_PTA),
 201    fmt(VK_FORMAT_ETC2_R8G8B8A8_UNORM_BLOCK, ISL_FORMAT_ETC2_EAC_RGBA8),
 202    fmt(VK_FORMAT_ETC2_R8G8B8A8_SRGB_BLOCK, ISL_FORMAT_ETC2_EAC_SRGB8_A8),
 203    fmt(VK_FORMAT_EAC_R11_UNORM_BLOCK,     ISL_FORMAT_EAC_R11),
 204    fmt(VK_FORMAT_EAC_R11_SNORM_BLOCK,     ISL_FORMAT_EAC_SIGNED_R11),
 205    fmt(VK_FORMAT_EAC_R11G11_UNORM_BLOCK,  ISL_FORMAT_EAC_RG11),
 206    fmt(VK_FORMAT_EAC_R11G11_SNORM_BLOCK,  ISL_FORMAT_EAC_SIGNED_RG11),
 207    fmt(VK_FORMAT_ASTC_4x4_SRGB_BLOCK,     ISL_FORMAT_ASTC_LDR_2D_4X4_U8SRGB),
 208    fmt(VK_FORMAT_ASTC_5x4_SRGB_BLOCK,     ISL_FORMAT_ASTC_LDR_2D_5X4_U8SRGB),
 209    fmt(VK_FORMAT_ASTC_5x5_SRGB_BLOCK,     ISL_FORMAT_ASTC_LDR_2D_5X5_U8SRGB),
 210    fmt(VK_FORMAT_ASTC_6x5_SRGB_BLOCK,     ISL_FORMAT_ASTC_LDR_2D_6X5_U8SRGB),
 211    fmt(VK_FORMAT_ASTC_6x6_SRGB_BLOCK,     ISL_FORMAT_ASTC_LDR_2D_6X6_U8SRGB),
 212    fmt(VK_FORMAT_ASTC_8x5_SRGB_BLOCK,     ISL_FORMAT_ASTC_LDR_2D_8X5_U8SRGB),
 213    fmt(VK_FORMAT_ASTC_8x6_SRGB_BLOCK,     ISL_FORMAT_ASTC_LDR_2D_8X6_U8SRGB),
 214    fmt(VK_FORMAT_ASTC_8x8_SRGB_BLOCK,     ISL_FORMAT_ASTC_LDR_2D_8X8_U8SRGB),
 215    fmt(VK_FORMAT_ASTC_10x5_SRGB_BLOCK,    ISL_FORMAT_ASTC_LDR_2D_10X5_U8SRGB),
 216    fmt(VK_FORMAT_ASTC_10x6_SRGB_BLOCK,    ISL_FORMAT_ASTC_LDR_2D_10X6_U8SRGB),
 217    fmt(VK_FORMAT_ASTC_10x8_SRGB_BLOCK,    ISL_FORMAT_ASTC_LDR_2D_10X8_U8SRGB),
 218    fmt(VK_FORMAT_ASTC_10x10_SRGB_BLOCK,   ISL_FORMAT_ASTC_LDR_2D_10X10_U8SRGB),
 219    fmt(VK_FORMAT_ASTC_12x10_SRGB_BLOCK,   ISL_FORMAT_ASTC_LDR_2D_12X10_U8SRGB),
 220    fmt(VK_FORMAT_ASTC_12x12_SRGB_BLOCK,   ISL_FORMAT_ASTC_LDR_2D_12X12_U8SRGB),
 221    fmt(VK_FORMAT_ASTC_4x4_UNORM_BLOCK,    ISL_FORMAT_ASTC_LDR_2D_4X4_FLT16),
 222    fmt(VK_FORMAT_ASTC_5x4_UNORM_BLOCK,    ISL_FORMAT_ASTC_LDR_2D_5X4_FLT16),
 223    fmt(VK_FORMAT_ASTC_5x5_UNORM_BLOCK,    ISL_FORMAT_ASTC_LDR_2D_5X5_FLT16),
 224    fmt(VK_FORMAT_ASTC_6x5_UNORM_BLOCK,    ISL_FORMAT_ASTC_LDR_2D_6X5_FLT16),
 225    fmt(VK_FORMAT_ASTC_6x6_UNORM_BLOCK,    ISL_FORMAT_ASTC_LDR_2D_6X6_FLT16),
 226    fmt(VK_FORMAT_ASTC_8x5_UNORM_BLOCK,    ISL_FORMAT_ASTC_LDR_2D_8X5_FLT16),
 227    fmt(VK_FORMAT_ASTC_8x6_UNORM_BLOCK,    ISL_FORMAT_ASTC_LDR_2D_8X6_FLT16),
 228    fmt(VK_FORMAT_ASTC_8x8_UNORM_BLOCK,    ISL_FORMAT_ASTC_LDR_2D_8X8_FLT16),
 229    fmt(VK_FORMAT_ASTC_10x5_UNORM_BLOCK,   ISL_FORMAT_ASTC_LDR_2D_10X5_FLT16),
 230    fmt(VK_FORMAT_ASTC_10x6_UNORM_BLOCK,   ISL_FORMAT_ASTC_LDR_2D_10X6_FLT16),
 231    fmt(VK_FORMAT_ASTC_10x8_UNORM_BLOCK,   ISL_FORMAT_ASTC_LDR_2D_10X8_FLT16),
 232    fmt(VK_FORMAT_ASTC_10x10_UNORM_BLOCK,  ISL_FORMAT_ASTC_LDR_2D_10X10_FLT16),
 233    fmt(VK_FORMAT_ASTC_12x10_UNORM_BLOCK,  ISL_FORMAT_ASTC_LDR_2D_12X10_FLT16),
 234    fmt(VK_FORMAT_ASTC_12x12_UNORM_BLOCK,  ISL_FORMAT_ASTC_LDR_2D_12X12_FLT16),
 235    fmt(VK_FORMAT_B8G8R8_UNORM,            ISL_FORMAT_UNSUPPORTED),
 236    fmt(VK_FORMAT_B8G8R8_SNORM,            ISL_FORMAT_UNSUPPORTED),
 237    fmt(VK_FORMAT_B8G8R8_USCALED,          ISL_FORMAT_UNSUPPORTED),
 238    fmt(VK_FORMAT_B8G8R8_SSCALED,          ISL_FORMAT_UNSUPPORTED),
 239    fmt(VK_FORMAT_B8G8R8_UINT,             ISL_FORMAT_UNSUPPORTED),
 240    fmt(VK_FORMAT_B8G8R8_SINT,             ISL_FORMAT_UNSUPPORTED),
 241    fmt(VK_FORMAT_B8G8R8_SRGB,             ISL_FORMAT_UNSUPPORTED),
 242    fmt(VK_FORMAT_B8G8R8A8_UNORM,          ISL_FORMAT_B8G8R8A8_UNORM),
 243    fmt(VK_FORMAT_B8G8R8A8_SNORM,          ISL_FORMAT_UNSUPPORTED),
 244    fmt(VK_FORMAT_B8G8R8A8_USCALED,        ISL_FORMAT_UNSUPPORTED),
 245    fmt(VK_FORMAT_B8G8R8A8_SSCALED,        ISL_FORMAT_UNSUPPORTED),
 246    fmt(VK_FORMAT_B8G8R8A8_UINT,           ISL_FORMAT_UNSUPPORTED),
 247    fmt(VK_FORMAT_B8G8R8A8_SINT,           ISL_FORMAT_UNSUPPORTED),
 248    fmt(VK_FORMAT_B8G8R8A8_SRGB,           ISL_FORMAT_B8G8R8A8_UNORM_SRGB),
 249 };
 250
 251 #undef fmt
 252
 253 /**
 254  * Exactly one bit must be set in \a aspect.
 255  */
 256 struct anv_format
 257 anv_get_format(const struct gen_device_info *devinfo, VkFormat vk_format,
 258                VkImageAspectFlags aspect, VkImageTiling tiling)
 259 {
 260    struct anv_format format = anv_formats[vk_format];
 261
 262    if (format.isl_format == ISL_FORMAT_UNSUPPORTED)
 263       return format;
 264
 265    if (aspect == VK_IMAGE_ASPECT_STENCIL_BIT) {
 266       assert(vk_format_aspects(vk_format) & VK_IMAGE_ASPECT_STENCIL_BIT);
 267       format.isl_format = ISL_FORMAT_R8_UINT;
 268       return format;
 269    }
 270
 271    if (aspect & VK_IMAGE_ASPECT_DEPTH_BIT) {
 272       assert(vk_format_aspects(vk_format) & VK_IMAGE_ASPECT_DEPTH_BIT);
 273       return format;
 274    }
 275
 276    assert(aspect == VK_IMAGE_ASPECT_COLOR_BIT);
 277    assert(vk_format_aspects(vk_format) == VK_IMAGE_ASPECT_COLOR_BIT);
 278
 279    const struct isl_format_layout *isl_layout =
 280       isl_format_get_layout(format.isl_format);
 281
 282    if (tiling == VK_IMAGE_TILING_OPTIMAL &&
 283        !util_is_power_of_two(isl_layout->bpb)) {
 284       /* Tiled formats *must* be power-of-two because we need up upload
 285        * them with the render pipeline.  For 3-channel formats, we fix
 286        * this by switching them over to RGBX or RGBA formats under the
 287        * hood.
 288        */
 289       enum isl_format rgbx = isl_format_rgb_to_rgbx(format.isl_format);
 290       if (rgbx != ISL_FORMAT_UNSUPPORTED &&
 291           isl_format_supports_rendering(devinfo, rgbx)) {
 292          format.isl_format = rgbx;
 293       } else {
 294          format.isl_format = isl_format_rgb_to_rgba(format.isl_format);
 295          format.swizzle = ISL_SWIZZLE(RED, GREEN, BLUE, ONE);
 296       }
 297    }
 298
 299    /* The B4G4R4A4 format isn't available prior to Broadwell so we have to fall
 300     * back to a format with a more complex swizzle.
 301     */
 302    if (vk_format == VK_FORMAT_B4G4R4A4_UNORM_PACK16 && devinfo->gen < 8) {
 303       return (struct anv_format) {
 304          .isl_format = ISL_FORMAT_B4G4R4A4_UNORM,
 305          .swizzle = ISL_SWIZZLE(GREEN, RED, ALPHA, BLUE),
 306       };
 307    }
 308
 309    return format;
 310 }
 311
 312 // Format capabilities
 313
 314 static VkFormatFeatureFlags
 315 get_image_format_properties(const struct gen_device_info *devinfo,
 316                             enum isl_format base, struct anv_format format)
 317 {
 318    if (format.isl_format == ISL_FORMAT_UNSUPPORTED)
 319       return 0;
 320
 321    VkFormatFeatureFlags flags = 0;
 322    if (isl_format_supports_sampling(devinfo, format.isl_format)) {
 323       flags |= VK_FORMAT_FEATURE_SAMPLED_IMAGE_BIT |
 324                VK_FORMAT_FEATURE_BLIT_SRC_BIT;
 325
 326       if (isl_format_supports_filtering(devinfo, format.isl_format))
 327          flags |= VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT;
 328    }
 329
 330    /* We can render to swizzled formats.  However, if the alpha channel is
 331     * moved, then blending won't work correctly.  The PRM tells us
 332     * straight-up not to render to such a surface.
 333     */
 334    if (isl_format_supports_rendering(devinfo, format.isl_format) &&
 335        format.swizzle.a == ISL_CHANNEL_SELECT_ALPHA) {
 336       flags |= VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BIT |
 337                VK_FORMAT_FEATURE_BLIT_DST_BIT;
 338
 339       if (isl_format_supports_alpha_blending(devinfo, format.isl_format))
 340          flags |= VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BLEND_BIT;
 341    }
 342
 343    /* Load/store is determined based on base format.  This prevents RGB
 344     * formats from showing up as load/store capable.
 345     */
 346    if (isl_is_storage_image_format(base))
 347       flags |= VK_FORMAT_FEATURE_STORAGE_IMAGE_BIT;
 348
 349    if (base == ISL_FORMAT_R32_SINT || base == ISL_FORMAT_R32_UINT)
 350       flags |= VK_FORMAT_FEATURE_STORAGE_IMAGE_ATOMIC_BIT;
 351
 352    if (flags) {
 353       flags |= VK_FORMAT_FEATURE_TRANSFER_SRC_BIT_KHR |
 354                VK_FORMAT_FEATURE_TRANSFER_DST_BIT_KHR;
 355    }
 356
 357    return flags;
 358 }
 359
 360 static VkFormatFeatureFlags
 361 get_buffer_format_properties(const struct gen_device_info *devinfo,
 362                              enum isl_format format)
 363 {
 364    if (format == ISL_FORMAT_UNSUPPORTED)
 365       return 0;
 366
 367    VkFormatFeatureFlags flags = 0;
 368    if (isl_format_supports_sampling(devinfo, format) &&
 369        !isl_format_is_compressed(format))
 370       flags |= VK_FORMAT_FEATURE_UNIFORM_TEXEL_BUFFER_BIT;
 371
 372    if (isl_format_supports_vertex_fetch(devinfo, format))
 373       flags |= VK_FORMAT_FEATURE_VERTEX_BUFFER_BIT;
 374
 375    if (isl_is_storage_image_format(format))
 376       flags |= VK_FORMAT_FEATURE_STORAGE_TEXEL_BUFFER_BIT;
 377
 378    if (format == ISL_FORMAT_R32_SINT || format == ISL_FORMAT_R32_UINT)
 379       flags |= VK_FORMAT_FEATURE_STORAGE_TEXEL_BUFFER_ATOMIC_BIT;
 380
 381    return flags;
 382 }
 383
 384 static void
 385 anv_physical_device_get_format_properties(struct anv_physical_device *physical_device,
 386                                           VkFormat format,
 387                                           VkFormatProperties *out_properties)
 388 {
 389    int gen = physical_device->info.gen * 10;
 390    if (physical_device->info.is_haswell)
 391       gen += 5;
 392
 393    VkFormatFeatureFlags linear = 0, tiled = 0, buffer = 0;
 394    if (anv_formats[format].isl_format == ISL_FORMAT_UNSUPPORTED) {
 395       /* Nothing to do here */
 396    } else if (vk_format_is_depth_or_stencil(format)) {
 397       tiled |= VK_FORMAT_FEATURE_DEPTH_STENCIL_ATTACHMENT_BIT;
 398       if (physical_device->info.gen >= 8)
 399          tiled |= VK_FORMAT_FEATURE_SAMPLED_IMAGE_BIT;
 400
 401       tiled |= VK_FORMAT_FEATURE_BLIT_SRC_BIT |
 402                VK_FORMAT_FEATURE_BLIT_DST_BIT |
 403                VK_FORMAT_FEATURE_TRANSFER_SRC_BIT_KHR |
 404                VK_FORMAT_FEATURE_TRANSFER_DST_BIT_KHR;
 405    } else {
 406       struct anv_format linear_fmt, tiled_fmt;
 407       linear_fmt = anv_get_format(&physical_device->info, format,
 408                                   VK_IMAGE_ASPECT_COLOR_BIT,
 409                                   VK_IMAGE_TILING_LINEAR);
 410       tiled_fmt = anv_get_format(&physical_device->info, format,
 411                                  VK_IMAGE_ASPECT_COLOR_BIT,
 412                                  VK_IMAGE_TILING_OPTIMAL);
 413
 414       linear = get_image_format_properties(&physical_device->info,
 415                                            linear_fmt.isl_format, linear_fmt);
 416       tiled = get_image_format_properties(&physical_device->info,
 417                                           linear_fmt.isl_format, tiled_fmt);
 418       buffer = get_buffer_format_properties(&physical_device->info,
 419                                             linear_fmt.isl_format);
 420
 421       /* XXX: We handle 3-channel formats by switching them out for RGBX or
 422        * RGBA formats behind-the-scenes.  This works fine for textures
 423        * because the upload process will fill in the extra channel.
 424        * We could also support it for render targets, but it will take
 425        * substantially more work and we have enough RGBX formats to handle
 426        * what most clients will want.
 427        */
 428       if (linear_fmt.isl_format != ISL_FORMAT_UNSUPPORTED &&
 429           !util_is_power_of_two(isl_format_layouts[linear_fmt.isl_format].bpb) &&
 430           isl_format_rgb_to_rgbx(linear_fmt.isl_format) == ISL_FORMAT_UNSUPPORTED) {
 431          tiled &= ~VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BIT &
 432                   ~VK_FORMAT_FEATURE_BLIT_DST_BIT;
 433       }
 434
 435       /* ASTC textures must be in Y-tiled memory */
 436       if (isl_format_get_layout(linear_fmt.isl_format)->txc == ISL_TXC_ASTC)
 437          linear = 0;
 438    }
 439
 440    out_properties->linearTilingFeatures = linear;
 441    out_properties->optimalTilingFeatures = tiled;
 442    out_properties->bufferFeatures = buffer;
 443
 444    return;
 445 }
 446
 447
 448 void anv_GetPhysicalDeviceFormatProperties(
 449     VkPhysicalDevice                            physicalDevice,
 450     VkFormat                                    format,
 451     VkFormatProperties*                         pFormatProperties)
 452 {
 453    ANV_FROM_HANDLE(anv_physical_device, physical_device, physicalDevice);
 454
 455    anv_physical_device_get_format_properties(
 456                physical_device,
 457                format,
 458                pFormatProperties);
 459 }
 460
 461 void anv_GetPhysicalDeviceFormatProperties2KHR(
 462     VkPhysicalDevice                            physicalDevice,
 463     VkFormat                                    format,
 464     VkFormatProperties2KHR*                     pFormatProperties)
 465 {
 466    anv_GetPhysicalDeviceFormatProperties(physicalDevice, format,
 467                                          &pFormatProperties->formatProperties);
 468
 469    vk_foreach_struct(ext, pFormatProperties->pNext) {
 470       switch (ext->sType) {
 471       default:
 472          anv_debug_ignored_stype(ext->sType);
 473          break;
 474       }
 475    }
 476 }
 477
 478 static VkResult
 479 anv_get_image_format_properties(
 480    struct anv_physical_device *physical_device,
 481    const VkPhysicalDeviceImageFormatInfo2KHR *info,
 482    VkImageFormatProperties *pImageFormatProperties)
 483 {
 484    VkFormatProperties format_props;
 485    VkFormatFeatureFlags format_feature_flags;
 486    VkExtent3D maxExtent;
 487    uint32_t maxMipLevels;
 488    uint32_t maxArraySize;
 489    VkSampleCountFlags sampleCounts = VK_SAMPLE_COUNT_1_BIT;
 490
 491    if (anv_formats[info->format].isl_format == ISL_FORMAT_UNSUPPORTED)
 492       goto unsupported;
 493
 494    anv_physical_device_get_format_properties(physical_device, info->format,
 495                                              &format_props);
 496
 497    /* Extract the VkFormatFeatureFlags that are relevant for the queried
 498     * tiling.
 499     */
 500    if (info->tiling == VK_IMAGE_TILING_LINEAR) {
 501       format_feature_flags = format_props.linearTilingFeatures;
 502    } else if (info->tiling == VK_IMAGE_TILING_OPTIMAL) {
 503       format_feature_flags = format_props.optimalTilingFeatures;
 504    } else {
 505       unreachable("bad VkImageTiling");
 506    }
 507
 508    switch (info->type) {
 509    default:
 510       unreachable("bad VkImageType");
 511    case VK_IMAGE_TYPE_1D:
 512       maxExtent.width = 16384;
 513       maxExtent.height = 1;
 514       maxExtent.depth = 1;
 515       maxMipLevels = 15; /* log2(maxWidth) + 1 */
 516       maxArraySize = 2048;
 517       sampleCounts = VK_SAMPLE_COUNT_1_BIT;
 518       break;
 519    case VK_IMAGE_TYPE_2D:
 520       /* FINISHME: Does this really differ for cube maps? The documentation
 521        * for RENDER_SURFACE_STATE suggests so.
 522        */
 523       maxExtent.width = 16384;
 524       maxExtent.height = 16384;
 525       maxExtent.depth = 1;
 526       maxMipLevels = 15; /* log2(maxWidth) + 1 */
 527       maxArraySize = 2048;
 528       break;
 529    case VK_IMAGE_TYPE_3D:
 530       maxExtent.width = 2048;
 531       maxExtent.height = 2048;
 532       maxExtent.depth = 2048;
 533       maxMipLevels = 12; /* log2(maxWidth) + 1 */
 534       maxArraySize = 1;
 535       break;
 536    }
 537
 538    /* Our hardware doesn't support 1D compressed textures.
 539     *    From the SKL PRM, RENDER_SURFACE_STATE::SurfaceFormat:
 540     *    * This field cannot be a compressed (BC*, DXT*, FXT*, ETC*, EAC*) format
 541     *       if the Surface Type is SURFTYPE_1D.
 542     *    * This field cannot be ASTC format if the Surface Type is SURFTYPE_1D.
 543     */
 544    if (info->type == VK_IMAGE_TYPE_1D &&
 545        isl_format_is_compressed(anv_formats[info->format].isl_format)) {
 546        goto unsupported;
 547    }
 548
 549    if (info->tiling == VK_IMAGE_TILING_OPTIMAL &&
 550        info->type == VK_IMAGE_TYPE_2D &&
 551        (format_feature_flags & (VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BIT |
 552                                 VK_FORMAT_FEATURE_DEPTH_STENCIL_ATTACHMENT_BIT)) &&
 553        !(info->flags & VK_IMAGE_CREATE_CUBE_COMPATIBLE_BIT) &&
 554        !(info->usage & VK_IMAGE_USAGE_STORAGE_BIT)) {
 555       sampleCounts = isl_device_get_sample_counts(&physical_device->isl_dev);
 556    }
 557
 558    if (info->usage & (VK_IMAGE_USAGE_TRANSFER_SRC_BIT |
 559                       VK_IMAGE_USAGE_TRANSFER_DST_BIT)) {
 560       /* Accept transfers on anything we can sample from or renderer to. */
 561       if (!(format_feature_flags & (VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BIT |
 562                                     VK_FORMAT_FEATURE_DEPTH_STENCIL_ATTACHMENT_BIT |
 563                                     VK_FORMAT_FEATURE_SAMPLED_IMAGE_BIT))) {
 564          goto unsupported;
 565       }
 566    }
 567
 568    if (info->usage & VK_IMAGE_USAGE_SAMPLED_BIT) {
 569       if (!(format_feature_flags & VK_FORMAT_FEATURE_SAMPLED_IMAGE_BIT)) {
 570          goto unsupported;
 571       }
 572    }
 573
 574    if (info->usage & VK_IMAGE_USAGE_STORAGE_BIT) {
 575       if (!(format_feature_flags & VK_FORMAT_FEATURE_STORAGE_IMAGE_BIT)) {
 576          goto unsupported;
 577       }
 578    }
 579
 580    if (info->usage & VK_IMAGE_USAGE_COLOR_ATTACHMENT_BIT) {
 581       if (!(format_feature_flags & VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BIT)) {
 582          goto unsupported;
 583       }
 584    }
 585
 586    if (info->usage & VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT) {
 587       if (!(format_feature_flags & VK_FORMAT_FEATURE_DEPTH_STENCIL_ATTACHMENT_BIT)) {
 588          goto unsupported;
 589       }
 590    }
 591
 592    if (info->usage & VK_IMAGE_USAGE_TRANSIENT_ATTACHMENT_BIT) {
 593       /* Nothing to check. */
 594    }
 595
 596    if (info->usage & VK_IMAGE_USAGE_INPUT_ATTACHMENT_BIT) {
 597       /* Ignore this flag because it was removed from the
 598        * provisional_I_20150910 header.
 599        */
 600    }
 601
 602    *pImageFormatProperties = (VkImageFormatProperties) {
 603       .maxExtent = maxExtent,
 604       .maxMipLevels = maxMipLevels,
 605       .maxArrayLayers = maxArraySize,
 606       .sampleCounts = sampleCounts,
 607
 608       /* FINISHME: Accurately calculate
 609        * VkImageFormatProperties::maxResourceSize.
 610        */
 611       .maxResourceSize = UINT32_MAX,
 612    };
 613
 614    return VK_SUCCESS;
 615
 616 unsupported:
 617    *pImageFormatProperties = (VkImageFormatProperties) {
 618       .maxExtent = { 0, 0, 0 },
 619       .maxMipLevels = 0,
 620       .maxArrayLayers = 0,
 621       .sampleCounts = 0,
 622       .maxResourceSize = 0,
 623    };
 624
 625    return VK_ERROR_FORMAT_NOT_SUPPORTED;
 626 }
 627
 628 VkResult anv_GetPhysicalDeviceImageFormatProperties(
 629     VkPhysicalDevice                            physicalDevice,
 630     VkFormat                                    format,
 631     VkImageType                                 type,
 632     VkImageTiling                               tiling,
 633     VkImageUsageFlags                           usage,
 634     VkImageCreateFlags                          createFlags,
 635     VkImageFormatProperties*                    pImageFormatProperties)
 636 {
 637    ANV_FROM_HANDLE(anv_physical_device, physical_device, physicalDevice);
 638
 639    const VkPhysicalDeviceImageFormatInfo2KHR info = {
 640       .sType = VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_IMAGE_FORMAT_INFO_2_KHR,
 641       .pNext = NULL,
 642       .format = format,
 643       .type = type,
 644       .tiling = tiling,
 645       .usage = usage,
 646       .flags = createFlags,
 647    };
 648
 649    return anv_get_image_format_properties(physical_device, &info,
 650                                           pImageFormatProperties);
 651 }
 652
 653 VkResult anv_GetPhysicalDeviceImageFormatProperties2KHR(
 654     VkPhysicalDevice                            physicalDevice,
 655     const VkPhysicalDeviceImageFormatInfo2KHR*  base_info,
 656     VkImageFormatProperties2KHR*                base_props)
 657 {
 658    ANV_FROM_HANDLE(anv_physical_device, physical_device, physicalDevice);
 659    VkResult result;
 660
 661    result = anv_get_image_format_properties(physical_device, base_info,
 662                &base_props->imageFormatProperties);
 663    if (result != VK_SUCCESS)
 664       goto fail;
 665
 666    /* Extract input structs */
 667    vk_foreach_struct_const(s, base_info->pNext) {
 668       switch (s->sType) {
 669       default:
 670          anv_debug_ignored_stype(s->sType);
 671          break;
 672       }
 673    }
 674
 675    /* Extract output structs */
 676    vk_foreach_struct(s, base_props->pNext) {
 677       switch (s->sType) {
 678       default:
 679          anv_debug_ignored_stype(s->sType);
 680          break;
 681       }
 682    }
 683
 684    return VK_SUCCESS;
 685
 686  fail:
 687    if (result == VK_ERROR_FORMAT_NOT_SUPPORTED) {
 688       /* From the Vulkan 1.0.42 spec:
 689        *
 690        *    If the combination of parameters to
 691        *    vkGetPhysicalDeviceImageFormatProperties2KHR is not supported by
 692        *    the implementation for use in vkCreateImage, then all members of
 693        *    imageFormatProperties will be filled with zero.
 694        */
 695       base_props->imageFormatProperties = (VkImageFormatProperties) {0};
 696    }
 697
 698    return result;
 699 }
 700
 701 void anv_GetPhysicalDeviceSparseImageFormatProperties(
 702     VkPhysicalDevice                            physicalDevice,
 703     VkFormat                                    format,
 704     VkImageType                                 type,
 705     uint32_t                                    samples,
 706     VkImageUsageFlags                           usage,
 707     VkImageTiling                               tiling,
 708     uint32_t*                                   pNumProperties,
 709     VkSparseImageFormatProperties*              pProperties)
 710 {
 711    /* Sparse images are not yet supported. */
 712    *pNumProperties = 0;
 713 }
 714
 715 void anv_GetPhysicalDeviceSparseImageFormatProperties2KHR(
 716     VkPhysicalDevice                            physicalDevice,
 717     const VkPhysicalDeviceSparseImageFormatInfo2KHR* pFormatInfo,
 718     uint32_t*                                   pPropertyCount,
 719     VkSparseImageFormatProperties2KHR*          pProperties)
 720 {
 721    /* Sparse images are not yet supported. */
 722    *pPropertyCount = 0;
 723 }