/* Copyright (c) 2017-2023 Hans-Kristian Arntzen * * Permission is hereby granted, free of charge, to any person obtaining * a copy of this software and associated documentation files (the * "Software"), to deal in the Software without restriction, including * without limitation the rights to use, copy, modify, merge, publish, * distribute, sublicense, and/or sell copies of the Software, and to * permit persons to whom the Software is furnished to do so, subject to * the following conditions: * * The above copyright notice and this permission notice shall be * included in all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY * CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ #pragma once #include "vulkan_headers.hpp" #include "texture/texture_format.hpp" namespace Vulkan { enum class FormatCompressionType { Uncompressed, BC, ETC, ASTC }; static inline FormatCompressionType format_compression_type(VkFormat format) { switch (format) { case VK_FORMAT_BC1_RGBA_SRGB_BLOCK: case VK_FORMAT_BC1_RGBA_UNORM_BLOCK: case VK_FORMAT_BC1_RGB_SRGB_BLOCK: case VK_FORMAT_BC1_RGB_UNORM_BLOCK: case VK_FORMAT_BC2_SRGB_BLOCK: case VK_FORMAT_BC2_UNORM_BLOCK: case VK_FORMAT_BC3_SRGB_BLOCK: case VK_FORMAT_BC3_UNORM_BLOCK: case VK_FORMAT_BC4_UNORM_BLOCK: case VK_FORMAT_BC4_SNORM_BLOCK: case VK_FORMAT_BC5_UNORM_BLOCK: case VK_FORMAT_BC5_SNORM_BLOCK: case VK_FORMAT_BC6H_SFLOAT_BLOCK: case VK_FORMAT_BC6H_UFLOAT_BLOCK: case VK_FORMAT_BC7_SRGB_BLOCK: case VK_FORMAT_BC7_UNORM_BLOCK: return FormatCompressionType::BC; case VK_FORMAT_ETC2_R8G8B8A1_SRGB_BLOCK: case VK_FORMAT_ETC2_R8G8B8A1_UNORM_BLOCK: case VK_FORMAT_ETC2_R8G8B8A8_SRGB_BLOCK: case VK_FORMAT_ETC2_R8G8B8A8_UNORM_BLOCK: case VK_FORMAT_ETC2_R8G8B8_SRGB_BLOCK: case VK_FORMAT_ETC2_R8G8B8_UNORM_BLOCK: case VK_FORMAT_EAC_R11G11_SNORM_BLOCK: case VK_FORMAT_EAC_R11G11_UNORM_BLOCK: case VK_FORMAT_EAC_R11_SNORM_BLOCK: case VK_FORMAT_EAC_R11_UNORM_BLOCK: return FormatCompressionType::ETC; #define astc_fmt(w, h) \ case VK_FORMAT_ASTC_##w##x##h##_UNORM_BLOCK: \ case VK_FORMAT_ASTC_##w##x##h##_SRGB_BLOCK: \ case VK_FORMAT_ASTC_##w##x##h##_SFLOAT_BLOCK_EXT astc_fmt(4, 4): astc_fmt(5, 4): astc_fmt(5, 5): astc_fmt(6, 5): astc_fmt(6, 6): astc_fmt(8, 5): astc_fmt(8, 6): astc_fmt(8, 8): astc_fmt(10, 5): astc_fmt(10, 6): astc_fmt(10, 8): astc_fmt(10, 10): astc_fmt(12, 10): astc_fmt(12, 12): return FormatCompressionType::ASTC; #undef astc_fmt default: return FormatCompressionType::Uncompressed; } } static inline bool format_is_compressed_hdr(VkFormat format) { switch (format) { #define astc_fmt(w, h) case VK_FORMAT_ASTC_##w##x##h##_SFLOAT_BLOCK_EXT astc_fmt(4, 4): astc_fmt(5, 4): astc_fmt(5, 5): astc_fmt(6, 5): astc_fmt(6, 6): astc_fmt(8, 5): astc_fmt(8, 6): astc_fmt(8, 8): astc_fmt(10, 5): astc_fmt(10, 6): astc_fmt(10, 8): astc_fmt(10, 10): astc_fmt(12, 10): astc_fmt(12, 12): #undef astc_fmt return true; case VK_FORMAT_BC6H_SFLOAT_BLOCK: case VK_FORMAT_BC6H_UFLOAT_BLOCK: return true; default: return false; } } static inline bool format_is_srgb(VkFormat format) { switch (format) { case VK_FORMAT_A8B8G8R8_SRGB_PACK32: case VK_FORMAT_R8G8B8A8_SRGB: case VK_FORMAT_B8G8R8A8_SRGB: case VK_FORMAT_R8_SRGB: case VK_FORMAT_R8G8_SRGB: case VK_FORMAT_R8G8B8_SRGB: case VK_FORMAT_B8G8R8_SRGB: case VK_FORMAT_BC1_RGB_SRGB_BLOCK: case VK_FORMAT_BC1_RGBA_SRGB_BLOCK: case VK_FORMAT_BC2_SRGB_BLOCK: case VK_FORMAT_BC3_SRGB_BLOCK: case VK_FORMAT_BC7_SRGB_BLOCK: case VK_FORMAT_ETC2_R8G8B8_SRGB_BLOCK: case VK_FORMAT_ETC2_R8G8B8A1_SRGB_BLOCK: case VK_FORMAT_ETC2_R8G8B8A8_SRGB_BLOCK: case VK_FORMAT_ASTC_4x4_SRGB_BLOCK: case VK_FORMAT_ASTC_5x4_SRGB_BLOCK: case VK_FORMAT_ASTC_5x5_SRGB_BLOCK: case VK_FORMAT_ASTC_6x5_SRGB_BLOCK: case VK_FORMAT_ASTC_6x6_SRGB_BLOCK: case VK_FORMAT_ASTC_8x5_SRGB_BLOCK: case VK_FORMAT_ASTC_8x6_SRGB_BLOCK: case VK_FORMAT_ASTC_8x8_SRGB_BLOCK: case VK_FORMAT_ASTC_10x5_SRGB_BLOCK: case VK_FORMAT_ASTC_10x6_SRGB_BLOCK: case VK_FORMAT_ASTC_10x8_SRGB_BLOCK: case VK_FORMAT_ASTC_10x10_SRGB_BLOCK: case VK_FORMAT_ASTC_12x10_SRGB_BLOCK: case VK_FORMAT_ASTC_12x12_SRGB_BLOCK: return true; default: return false; } } static inline bool format_has_depth_aspect(VkFormat format) { switch (format) { case VK_FORMAT_D16_UNORM: case VK_FORMAT_D16_UNORM_S8_UINT: case VK_FORMAT_D24_UNORM_S8_UINT: case VK_FORMAT_D32_SFLOAT: case VK_FORMAT_X8_D24_UNORM_PACK32: case VK_FORMAT_D32_SFLOAT_S8_UINT: return true; default: return false; } } static inline bool format_has_stencil_aspect(VkFormat format) { switch (format) { case VK_FORMAT_D16_UNORM_S8_UINT: case VK_FORMAT_D24_UNORM_S8_UINT: case VK_FORMAT_D32_SFLOAT_S8_UINT: case VK_FORMAT_S8_UINT: return true; default: return false; } } static inline bool format_has_depth_or_stencil_aspect(VkFormat format) { return format_has_depth_aspect(format) || format_has_stencil_aspect(format); } static inline VkImageAspectFlags format_to_aspect_mask(VkFormat format) { switch (format) { case VK_FORMAT_UNDEFINED: return 0; case VK_FORMAT_S8_UINT: return VK_IMAGE_ASPECT_STENCIL_BIT; case VK_FORMAT_D16_UNORM_S8_UINT: case VK_FORMAT_D24_UNORM_S8_UINT: case VK_FORMAT_D32_SFLOAT_S8_UINT: return VK_IMAGE_ASPECT_STENCIL_BIT | VK_IMAGE_ASPECT_DEPTH_BIT; case VK_FORMAT_D16_UNORM: case VK_FORMAT_D32_SFLOAT: case VK_FORMAT_X8_D24_UNORM_PACK32: return VK_IMAGE_ASPECT_DEPTH_BIT; default: return VK_IMAGE_ASPECT_COLOR_BIT; } } static inline void format_align_dim(VkFormat format, uint32_t &width, uint32_t &height) { uint32_t align_width, align_height; TextureFormatLayout::format_block_dim(format, align_width, align_height); width = ((width + align_width - 1) / align_width) * align_width; height = ((height + align_height - 1) / align_height) * align_height; } static inline void format_num_blocks(VkFormat format, uint32_t &width, uint32_t &height) { uint32_t align_width, align_height; TextureFormatLayout::format_block_dim(format, align_width, align_height); width = (width + align_width - 1) / align_width; height = (height + align_height - 1) / align_height; } static inline VkDeviceSize format_get_layer_size(VkFormat format, VkImageAspectFlags aspect, unsigned width, unsigned height, unsigned depth) { uint32_t blocks_x = width; uint32_t blocks_y = height; format_num_blocks(format, blocks_x, blocks_y); format_align_dim(format, width, height); VkDeviceSize size = VkDeviceSize(TextureFormatLayout::format_block_size(format, aspect)) * depth * blocks_x * blocks_y; return size; } static inline unsigned format_ycbcr_num_planes(VkFormat format) { switch (format) { case VK_FORMAT_G8_B8_R8_3PLANE_420_UNORM: case VK_FORMAT_G8_B8_R8_3PLANE_422_UNORM: case VK_FORMAT_G8_B8_R8_3PLANE_444_UNORM: case VK_FORMAT_G16_B16_R16_3PLANE_420_UNORM: case VK_FORMAT_G16_B16_R16_3PLANE_422_UNORM: case VK_FORMAT_G16_B16_R16_3PLANE_444_UNORM: case VK_FORMAT_G10X6_B10X6_R10X6_3PLANE_420_UNORM_3PACK16: case VK_FORMAT_G10X6_B10X6_R10X6_3PLANE_422_UNORM_3PACK16: case VK_FORMAT_G10X6_B10X6_R10X6_3PLANE_444_UNORM_3PACK16: case VK_FORMAT_G12X4_B12X4_R12X4_3PLANE_420_UNORM_3PACK16: case VK_FORMAT_G12X4_B12X4_R12X4_3PLANE_422_UNORM_3PACK16: case VK_FORMAT_G12X4_B12X4_R12X4_3PLANE_444_UNORM_3PACK16: return 3; case VK_FORMAT_G8_B8R8_2PLANE_420_UNORM: case VK_FORMAT_G8_B8R8_2PLANE_422_UNORM: case VK_FORMAT_G16_B16R16_2PLANE_420_UNORM: case VK_FORMAT_G16_B16R16_2PLANE_422_UNORM: case VK_FORMAT_G10X6_B10X6R10X6_2PLANE_420_UNORM_3PACK16: case VK_FORMAT_G10X6_B10X6R10X6_2PLANE_422_UNORM_3PACK16: case VK_FORMAT_G12X4_B12X4R12X4_2PLANE_420_UNORM_3PACK16: case VK_FORMAT_G12X4_B12X4R12X4_2PLANE_422_UNORM_3PACK16: return 2; default: return 1; } } static inline void format_ycbcr_downsample_dimensions(VkFormat format, VkImageAspectFlags aspect, uint32_t &width, uint32_t &height) { if (aspect == VK_IMAGE_ASPECT_PLANE_0_BIT) return; switch (format) { #define fmt(x, sub0, sub1) \ case VK_FORMAT_##x: \ width >>= sub0; \ height >>= sub1; \ break fmt(G8_B8_R8_3PLANE_420_UNORM, 1, 1); fmt(G8_B8R8_2PLANE_420_UNORM, 1, 1); fmt(G8_B8_R8_3PLANE_422_UNORM, 1, 0); fmt(G8_B8R8_2PLANE_422_UNORM, 1, 0); fmt(G8_B8_R8_3PLANE_444_UNORM, 0, 0); fmt(G10X6_B10X6_R10X6_3PLANE_420_UNORM_3PACK16, 1, 1); fmt(G10X6_B10X6_R10X6_3PLANE_422_UNORM_3PACK16, 1, 0); fmt(G10X6_B10X6_R10X6_3PLANE_444_UNORM_3PACK16, 0, 0); fmt(G10X6_B10X6R10X6_2PLANE_420_UNORM_3PACK16, 1, 1); fmt(G10X6_B10X6R10X6_2PLANE_422_UNORM_3PACK16, 1, 0); fmt(G12X4_B12X4_R12X4_3PLANE_420_UNORM_3PACK16, 1, 1); fmt(G12X4_B12X4_R12X4_3PLANE_422_UNORM_3PACK16, 1, 0); fmt(G12X4_B12X4_R12X4_3PLANE_444_UNORM_3PACK16, 0, 0); fmt(G12X4_B12X4R12X4_2PLANE_420_UNORM_3PACK16, 1, 1); fmt(G12X4_B12X4R12X4_2PLANE_422_UNORM_3PACK16, 1, 0); fmt(G16_B16_R16_3PLANE_420_UNORM, 1, 1); fmt(G16_B16_R16_3PLANE_422_UNORM, 1, 0); fmt(G16_B16_R16_3PLANE_444_UNORM, 0, 0); fmt(G16_B16R16_2PLANE_420_UNORM, 1, 1); fmt(G16_B16R16_2PLANE_422_UNORM, 1, 0); default: break; } #undef fmt } static inline bool format_supports_storage_image_read_write_without_format(VkFormat format) { /* from https://www.khronos.org/registry/vulkan/specs/1.2-extensions/html/vkspec.html#formats-without-shader-storage-format */ static const VkFormat supported_formats[] = { VK_FORMAT_R8G8B8A8_UNORM, VK_FORMAT_R8G8B8A8_SNORM, VK_FORMAT_R8G8B8A8_UINT, VK_FORMAT_R8G8B8A8_SINT, VK_FORMAT_R32_UINT, VK_FORMAT_R32_SINT, VK_FORMAT_R32_SFLOAT, VK_FORMAT_R32G32_UINT, VK_FORMAT_R32G32_SINT, VK_FORMAT_R32G32_SFLOAT, VK_FORMAT_R32G32B32A32_UINT, VK_FORMAT_R32G32B32A32_SINT, VK_FORMAT_R32G32B32A32_SFLOAT, VK_FORMAT_R16G16B16A16_UINT, VK_FORMAT_R16G16B16A16_SINT, VK_FORMAT_R16G16B16A16_SFLOAT, VK_FORMAT_R16G16_SFLOAT, VK_FORMAT_B10G11R11_UFLOAT_PACK32, VK_FORMAT_R16_SFLOAT, VK_FORMAT_R16G16B16A16_UNORM, VK_FORMAT_A2B10G10R10_UNORM_PACK32, VK_FORMAT_R16G16_UNORM, VK_FORMAT_R8G8_UNORM, VK_FORMAT_R16_UNORM, VK_FORMAT_R8_UNORM, VK_FORMAT_R16G16B16A16_SNORM, VK_FORMAT_R16G16_SNORM, VK_FORMAT_R8G8_SNORM, VK_FORMAT_R16_SNORM, VK_FORMAT_R8_SNORM, VK_FORMAT_R16G16_SINT, VK_FORMAT_R8G8_SINT, VK_FORMAT_R16_SINT, VK_FORMAT_R8_SINT, VK_FORMAT_A2B10G10R10_UINT_PACK32, VK_FORMAT_R16G16_UINT, VK_FORMAT_R8G8_UINT, VK_FORMAT_R16_UINT, VK_FORMAT_R8_UINT, }; for (auto fmt : supported_formats) if (fmt == format) return true; return false; } }