1 /* Copyright (c) 2015-2019 The Khronos Group Inc.
2 * Copyright (c) 2015-2019 Valve Corporation
3 * Copyright (c) 2015-2019 LunarG, Inc.
4 *
5 * Licensed under the Apache License, Version 2.0 (the "License");
6 * you may not use this file except in compliance with the License.
7 * You may obtain a copy of the License at
8 *
9 * http://www.apache.org/licenses/LICENSE-2.0
10 *
11 * Unless required by applicable law or agreed to in writing, software
12 * distributed under the License is distributed on an "AS IS" BASIS,
13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 * See the License for the specific language governing permissions and
15 * limitations under the License.
16 *
17 * Author: Mark Lobodzinski <mark@lunarg.com>
18 * Author: Courtney Goeltzenleuchter <courtney@LunarG.com>
19 * Author: Dave Houlton <daveh@lunarg.com>
20 */
21
22 #pragma once
23 #include <stdbool.h>
24 #include <vector>
25 #include "vulkan/vulkan.h"
26
27 #if !defined(VK_LAYER_EXPORT)
28 #if defined(__GNUC__) && __GNUC__ >= 4
29 #define VK_LAYER_EXPORT __attribute__((visibility("default")))
30 #elif defined(__SUNPRO_C) && (__SUNPRO_C >= 0x590)
31 #define VK_LAYER_EXPORT __attribute__((visibility("default")))
32 #else
33 #define VK_LAYER_EXPORT
34 #endif
35 #endif
36
37 #ifdef __cplusplus
38 extern "C" {
39 #endif
40
41 #define VK_MULTIPLANE_FORMAT_MAX_PLANES 3
42
43 typedef enum VkFormatCompatibilityClass {
44 VK_FORMAT_COMPATIBILITY_CLASS_NONE_BIT = 0,
45 VK_FORMAT_COMPATIBILITY_CLASS_8_BIT = 1,
46 VK_FORMAT_COMPATIBILITY_CLASS_16_BIT = 2,
47 VK_FORMAT_COMPATIBILITY_CLASS_24_BIT = 3,
48 VK_FORMAT_COMPATIBILITY_CLASS_32_BIT = 4,
49 VK_FORMAT_COMPATIBILITY_CLASS_48_BIT = 5,
50 VK_FORMAT_COMPATIBILITY_CLASS_64_BIT = 6,
51 VK_FORMAT_COMPATIBILITY_CLASS_96_BIT = 7,
52 VK_FORMAT_COMPATIBILITY_CLASS_128_BIT = 8,
53 VK_FORMAT_COMPATIBILITY_CLASS_192_BIT = 9,
54 VK_FORMAT_COMPATIBILITY_CLASS_256_BIT = 10,
55 VK_FORMAT_COMPATIBILITY_CLASS_BC1_RGB_BIT = 11,
56 VK_FORMAT_COMPATIBILITY_CLASS_BC1_RGBA_BIT = 12,
57 VK_FORMAT_COMPATIBILITY_CLASS_BC2_BIT = 13,
58 VK_FORMAT_COMPATIBILITY_CLASS_BC3_BIT = 14,
59 VK_FORMAT_COMPATIBILITY_CLASS_BC4_BIT = 15,
60 VK_FORMAT_COMPATIBILITY_CLASS_BC5_BIT = 16,
61 VK_FORMAT_COMPATIBILITY_CLASS_BC6H_BIT = 17,
62 VK_FORMAT_COMPATIBILITY_CLASS_BC7_BIT = 18,
63 VK_FORMAT_COMPATIBILITY_CLASS_ETC2_RGB_BIT = 19,
64 VK_FORMAT_COMPATIBILITY_CLASS_ETC2_RGBA_BIT = 20,
65 VK_FORMAT_COMPATIBILITY_CLASS_ETC2_EAC_RGBA_BIT = 21,
66 VK_FORMAT_COMPATIBILITY_CLASS_EAC_R_BIT = 22,
67 VK_FORMAT_COMPATIBILITY_CLASS_EAC_RG_BIT = 23,
68 VK_FORMAT_COMPATIBILITY_CLASS_ASTC_4X4_BIT = 24,
69 VK_FORMAT_COMPATIBILITY_CLASS_ASTC_5X4_BIT = 25,
70 VK_FORMAT_COMPATIBILITY_CLASS_ASTC_5X5_BIT = 26,
71 VK_FORMAT_COMPATIBILITY_CLASS_ASTC_6X5_BIT = 27,
72 VK_FORMAT_COMPATIBILITY_CLASS_ASTC_6X6_BIT = 28,
73 VK_FORMAT_COMPATIBILITY_CLASS_ASTC_8X5_BIT = 29,
74 VK_FORMAT_COMPATIBILITY_CLASS_ASTC_8X6_BIT = 20,
75 VK_FORMAT_COMPATIBILITY_CLASS_ASTC_8X8_BIT = 31,
76 VK_FORMAT_COMPATIBILITY_CLASS_ASTC_10X5_BIT = 32,
77 VK_FORMAT_COMPATIBILITY_CLASS_ASTC_10X6_BIT = 33,
78 VK_FORMAT_COMPATIBILITY_CLASS_ASTC_10X8_BIT = 34,
79 VK_FORMAT_COMPATIBILITY_CLASS_ASTC_10X10_BIT = 35,
80 VK_FORMAT_COMPATIBILITY_CLASS_ASTC_12X10_BIT = 36,
81 VK_FORMAT_COMPATIBILITY_CLASS_ASTC_12X12_BIT = 37,
82 VK_FORMAT_COMPATIBILITY_CLASS_D16_BIT = 38,
83 VK_FORMAT_COMPATIBILITY_CLASS_D24_BIT = 39,
84 VK_FORMAT_COMPATIBILITY_CLASS_D32_BIT = 30,
85 VK_FORMAT_COMPATIBILITY_CLASS_S8_BIT = 41,
86 VK_FORMAT_COMPATIBILITY_CLASS_D16S8_BIT = 42,
87 VK_FORMAT_COMPATIBILITY_CLASS_D24S8_BIT = 43,
88 VK_FORMAT_COMPATIBILITY_CLASS_D32S8_BIT = 44,
89 VK_FORMAT_COMPATIBILITY_CLASS_PVRTC1_2BPP_BIT = 45,
90 VK_FORMAT_COMPATIBILITY_CLASS_PVRTC1_4BPP_BIT = 46,
91 VK_FORMAT_COMPATIBILITY_CLASS_PVRTC2_2BPP_BIT = 47,
92 VK_FORMAT_COMPATIBILITY_CLASS_PVRTC2_4BPP_BIT = 48,
93 /* KHR_sampler_YCbCr_conversion */
94 VK_FORMAT_COMPATIBILITY_CLASS_32BIT_G8B8G8R8 = 49,
95 VK_FORMAT_COMPATIBILITY_CLASS_32BIT_B8G8R8G8 = 50,
96 VK_FORMAT_COMPATIBILITY_CLASS_64BIT_R10G10B10A10 = 51,
97 VK_FORMAT_COMPATIBILITY_CLASS_64BIT_G10B10G10R10 = 52,
98 VK_FORMAT_COMPATIBILITY_CLASS_64BIT_B10G10R10G10 = 53,
99 VK_FORMAT_COMPATIBILITY_CLASS_64BIT_R12G12B12A12 = 54,
100 VK_FORMAT_COMPATIBILITY_CLASS_64BIT_G12B12G12R12 = 55,
101 VK_FORMAT_COMPATIBILITY_CLASS_64BIT_B12G12R12G12 = 56,
102 VK_FORMAT_COMPATIBILITY_CLASS_64BIT_G16B16G16R16 = 57,
103 VK_FORMAT_COMPATIBILITY_CLASS_64BIT_B16G16R16G16 = 58,
104 VK_FORMAT_COMPATIBILITY_CLASS_8BIT_3PLANE_420 = 59,
105 VK_FORMAT_COMPATIBILITY_CLASS_8BIT_2PLANE_420 = 60,
106 VK_FORMAT_COMPATIBILITY_CLASS_8BIT_3PLANE_422 = 61,
107 VK_FORMAT_COMPATIBILITY_CLASS_8BIT_2PLANE_422 = 62,
108 VK_FORMAT_COMPATIBILITY_CLASS_8BIT_3PLANE_444 = 63,
109 VK_FORMAT_COMPATIBILITY_CLASS_10BIT_3PLANE_420 = 64,
110 VK_FORMAT_COMPATIBILITY_CLASS_10BIT_2PLANE_420 = 65,
111 VK_FORMAT_COMPATIBILITY_CLASS_10BIT_3PLANE_422 = 66,
112 VK_FORMAT_COMPATIBILITY_CLASS_10BIT_2PLANE_422 = 67,
113 VK_FORMAT_COMPATIBILITY_CLASS_10BIT_3PLANE_444 = 68,
114 VK_FORMAT_COMPATIBILITY_CLASS_12BIT_3PLANE_420 = 69,
115 VK_FORMAT_COMPATIBILITY_CLASS_12BIT_2PLANE_420 = 70,
116 VK_FORMAT_COMPATIBILITY_CLASS_12BIT_3PLANE_422 = 71,
117 VK_FORMAT_COMPATIBILITY_CLASS_12BIT_2PLANE_422 = 72,
118 VK_FORMAT_COMPATIBILITY_CLASS_12BIT_3PLANE_444 = 73,
119 VK_FORMAT_COMPATIBILITY_CLASS_16BIT_3PLANE_420 = 74,
120 VK_FORMAT_COMPATIBILITY_CLASS_16BIT_2PLANE_420 = 75,
121 VK_FORMAT_COMPATIBILITY_CLASS_16BIT_3PLANE_422 = 76,
122 VK_FORMAT_COMPATIBILITY_CLASS_16BIT_2PLANE_422 = 77,
123 VK_FORMAT_COMPATIBILITY_CLASS_16BIT_3PLANE_444 = 78,
124 VK_FORMAT_COMPATIBILITY_CLASS_MAX_ENUM = 79
125 } VkFormatCompatibilityClass;
126
127 typedef enum VkFormatNumericalType {
128 VK_FORMAT_NUMERICAL_TYPE_NONE,
129 VK_FORMAT_NUMERICAL_TYPE_UINT,
130 VK_FORMAT_NUMERICAL_TYPE_SINT,
131 VK_FORMAT_NUMERICAL_TYPE_UNORM,
132 VK_FORMAT_NUMERICAL_TYPE_SNORM,
133 VK_FORMAT_NUMERICAL_TYPE_USCALED,
134 VK_FORMAT_NUMERICAL_TYPE_SSCALED,
135 VK_FORMAT_NUMERICAL_TYPE_UFLOAT,
136 VK_FORMAT_NUMERICAL_TYPE_SFLOAT,
137 VK_FORMAT_NUMERICAL_TYPE_SRGB
138 } VkFormatNumericalType;
139
140 VK_LAYER_EXPORT bool FormatIsDepthOrStencil(VkFormat format);
141 VK_LAYER_EXPORT bool FormatIsDepthAndStencil(VkFormat format);
142 VK_LAYER_EXPORT bool FormatIsDepthOnly(VkFormat format);
143 VK_LAYER_EXPORT bool FormatIsStencilOnly(VkFormat format);
144 VK_LAYER_EXPORT bool FormatIsCompressed_ETC2_EAC(VkFormat format);
145 VK_LAYER_EXPORT bool FormatIsCompressed_ASTC_LDR(VkFormat format);
146 VK_LAYER_EXPORT bool FormatIsCompressed_BC(VkFormat format);
147 VK_LAYER_EXPORT bool FormatIsCompressed_PVRTC(VkFormat format);
148 VK_LAYER_EXPORT bool FormatIsSinglePlane_422(VkFormat format);
149 VK_LAYER_EXPORT bool FormatIsNorm(VkFormat format);
150 VK_LAYER_EXPORT bool FormatIsUNorm(VkFormat format);
151 VK_LAYER_EXPORT bool FormatIsSNorm(VkFormat format);
152 VK_LAYER_EXPORT bool FormatIsInt(VkFormat format);
153 VK_LAYER_EXPORT bool FormatIsSInt(VkFormat format);
154 VK_LAYER_EXPORT bool FormatIsUInt(VkFormat format);
155 VK_LAYER_EXPORT bool FormatIsFloat(VkFormat format);
156 VK_LAYER_EXPORT bool FormatIsSRGB(VkFormat format);
157 VK_LAYER_EXPORT bool FormatIsUScaled(VkFormat format);
158 VK_LAYER_EXPORT bool FormatIsSScaled(VkFormat format);
159 VK_LAYER_EXPORT bool FormatIsCompressed(VkFormat format);
160 VK_LAYER_EXPORT bool FormatIsPacked(VkFormat format);
161 VK_LAYER_EXPORT bool FormatElementIsTexel(VkFormat format);
162 VK_LAYER_EXPORT bool FormatSizesAreEqual(VkFormat srcFormat, VkFormat dstFormat, uint32_t region_count, const VkImageCopy *regions);
163 VK_LAYER_EXPORT bool FormatRequiresYcbcrConversion(VkFormat format);
164
165 VK_LAYER_EXPORT uint32_t FormatDepthSize(VkFormat format);
166 VK_LAYER_EXPORT VkFormatNumericalType FormatDepthNumericalType(VkFormat format);
167 VK_LAYER_EXPORT uint32_t FormatStencilSize(VkFormat format);
168 VK_LAYER_EXPORT VkFormatNumericalType FormatStencilNumericalType(VkFormat format);
169 VK_LAYER_EXPORT uint32_t FormatPlaneCount(VkFormat format);
170 VK_LAYER_EXPORT uint32_t FormatChannelCount(VkFormat format);
171 VK_LAYER_EXPORT VkExtent3D FormatTexelBlockExtent(VkFormat format);
172 VK_LAYER_EXPORT uint32_t FormatElementSize(VkFormat format, VkImageAspectFlags aspectMask = VK_IMAGE_ASPECT_COLOR_BIT);
173 VK_LAYER_EXPORT double FormatTexelSize(VkFormat format);
174 VK_LAYER_EXPORT VkFormatCompatibilityClass FormatCompatibilityClass(VkFormat format);
175 VK_LAYER_EXPORT VkDeviceSize SafeModulo(VkDeviceSize dividend, VkDeviceSize divisor);
176 VK_LAYER_EXPORT VkDeviceSize SafeDivision(VkDeviceSize dividend, VkDeviceSize divisor);
177 VK_LAYER_EXPORT uint32_t GetPlaneIndex(VkImageAspectFlags aspect);
178 VK_LAYER_EXPORT VkFormat FindMultiplaneCompatibleFormat(VkFormat fmt, VkImageAspectFlags plane_aspect);
179 VK_LAYER_EXPORT VkExtent2D FindMultiplaneExtentDivisors(VkFormat mp_fmt, VkImageAspectFlags plane_aspect);
180
FormatIsUndef(VkFormat format)181 static inline bool FormatIsUndef(VkFormat format) { return (format == VK_FORMAT_UNDEFINED); }
FormatHasDepth(VkFormat format)182 static inline bool FormatHasDepth(VkFormat format) { return (FormatIsDepthOnly(format) || FormatIsDepthAndStencil(format)); }
FormatHasStencil(VkFormat format)183 static inline bool FormatHasStencil(VkFormat format) { return (FormatIsStencilOnly(format) || FormatIsDepthAndStencil(format)); }
FormatIsMultiplane(VkFormat format)184 static inline bool FormatIsMultiplane(VkFormat format) { return ((FormatPlaneCount(format)) > 1u); }
FormatIsColor(VkFormat format)185 static inline bool FormatIsColor(VkFormat format) {
186 return !(FormatIsUndef(format) || FormatIsDepthOrStencil(format) || FormatIsMultiplane(format));
187 }
188
189 #ifdef __cplusplus
190 }
191 #endif
192