1<?xml version="1.0" encoding="UTF-8"?> 2<registry> 3 <comment> 4Copyright (c) 2015 The Khronos Group Inc. 5 6Permission is hereby granted, free of charge, to any person obtaining a 7copy of this software and/or associated documentation files (the 8"Materials"), to deal in the Materials without restriction, including 9without limitation the rights to use, copy, modify, merge, publish, 10distribute, sublicense, and/or sell copies of the Materials, and to 11permit persons to whom the Materials are furnished to do so, subject to 12the following conditions: 13 14The above copyright notice and this permission notice shall be included 15in all copies or substantial portions of the Materials. 16 17THE MATERIALS ARE PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, 18EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 19MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. 20IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY 21CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, 22TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE 23MATERIALS OR THE USE OR OTHER DEALINGS IN THE MATERIALS. 24 25------------------------------------------------------------------------ 26 27This file, vk.xml, is the Vulkan API Registry. It is a critically important 28and normative part of the Vulkan Specification, including a canonical 29machine-readable definition of the API, parameter and member validation 30language incorporated into the Specification and reference pages, and other 31material which is registered by Khronos, such as tags used by extension and 32layer authors. The only authoritative version of vk.xml is the one 33maintained in the master branch of the Khronos Vulkan Github project. 34 </comment> 35 36 <!-- SECTION: Vulkan vendor/author tags for extensions and layers --> 37 <tags> 38 <tag name="IMG" author="Imagination Technologies" contact="Michael Worcester @michaelworcester"/> 39 <tag name="AMD" author="Advanced Micro Devices, Inc." contact="Daniel Rakos @aqnuep"/> 40 <tag name="ARM" author="ARM Limited" contact="Jan-Harald Fredriksen @janharald"/> 41 <tag name="FSL" author="Freescale Semiconductor, Inc." contact="Norbert Nopper @FslNopper"/> 42 <tag name="BRCM" author="Broadcom Corporation" contact="Graeme Leese @gnl21"/> 43 <tag name="NXP" author="NXP Semiconductors N.V." contact="Norbert Nopper @FslNopper"/> 44 <tag name="NV" author="NVIDIA Corporation" contact="Daniel Koch @dgkoch"/> 45 <tag name="NVX" author="NVIDIA Corporation" contact="Daniel Koch @dgkoch"/> 46 <tag name="VIV" author="Vivante Corporation" contact="Yanjun Zhang @yanjunzhang"/> 47 <tag name="KDAB" author="KDAB" contact="Sean Harmer @seanharmer"/> 48 <tag name="ANDROID" author="Google, Inc." contact="Jesse Hall @jessehall"/> 49 <tag name="CHROMIUM" author="Google, Inc." contact="Jesse Hall @jessehall"/> 50 <tag name="GOOGLE" author="Google, Inc." contact="Jesse Hall @jessehall"/> 51 <tag name="QCOM" author="Qualcomm Technologies, Inc." contact="Maurice Ribble @mribble"/> 52 <tag name="LUNARG" author="LunarG, Inc." contact="Karen Ghavam @KarenGhavam"/> 53 <tag name="SAMSUNG" author="Samsung Electronics Co., Ltd." contact="Alon Or-bach @alonorbach"/> 54 <tag name="SEC" author="Samsung Electronics Co., Ltd." contact="Alon Or-bach @alonorbach"/> 55 <tag name="TIZEN" author="Samsung Electronics Co., Ltd." contact="Alon Or-bach @alonorbach"/> 56 <tag name="RENDERDOC" author="RenderDoc (renderdoc.org)" contact="baldurk@baldurk.org"/> 57 </tags> 58 59 <!-- SECTION: Vulkan type definitions --> 60 <types> 61 <type name="vk_platform" category="include">#include "vk_platform.h"</type> 62 <!-- WSI extensions --> 63 <type category="include">#include "<name>vulkan.h</name>"</type> 64 <type category="include">#include <<name>X11/Xlib.h</name>></type> 65 <type category="include">#include <<name>android/native_window.h</name>></type> 66 <type category="include">#include <<name>mir_toolkit/client_types.h</name>></type> 67 <type category="include">#include <<name>wayland-client.h</name>></type> 68 <type category="include">#include <<name>windows.h</name>></type> 69 <type category="include">#include <<name>xcb/xcb.h</name>></type> 70 71 <type requires="X11/Xlib.h" name="Display"/> 72 <type requires="X11/Xlib.h" name="VisualID"/> 73 <type requires="X11/Xlib.h" name="Window"/> 74 <type requires="android/native_window.h" name="ANativeWindow"/> 75 <type requires="mir_toolkit/client_types.h" name="MirConnection"/> 76 <type requires="mir_toolkit/client_types.h" name="MirSurface"/> 77 <type requires="wayland-client.h" name="wl_display"/> 78 <type requires="wayland-client.h" name="wl_surface"/> 79 <type requires="windows.h" name="HINSTANCE"/> 80 <type requires="windows.h" name="HWND"/> 81 <type requires="xcb/xcb.h" name="xcb_connection_t"/> 82 <type requires="xcb/xcb.h" name="xcb_visualid_t"/> 83 <type requires="xcb/xcb.h" name="xcb_window_t"/> 84 85 <type category="define">#define <name>VK_MAKE_VERSION</name>(major, minor, patch) \ 86 ((major << 22) | (minor << 12) | patch)</type> 87 88 <type category="define">// Vulkan API version supported by this file 89#define <name>VK_API_VERSION</name> <type>VK_MAKE_VERSION</type>(1, 0, 1)</type> 90 91 92 <type category="define"> 93#define <name>VK_DEFINE_HANDLE</name>(object) typedef struct object##_T* object;</type> 94 95 <type category="define" name="VK_DEFINE_NON_DISPATCHABLE_HANDLE"> 96#if defined(__LP64__) || defined(_WIN64) || defined(__x86_64__) || defined(_M_X64) || defined(__ia64) || defined (_M_IA64) || defined(__aarch64__) || defined(__powerpc64__) 97 #define VK_DEFINE_NON_DISPATCHABLE_HANDLE(object) typedef struct object##_T *object; 98#else 99 #define VK_DEFINE_NON_DISPATCHABLE_HANDLE(object) typedef uint64_t object; 100#endif 101 </type> 102 103 <type category="define"> 104#define <name>VK_NULL_HANDLE</name> 0 105 </type> 106 107 <type category="basetype">typedef <type>uint32_t</type> <name>VkSampleMask</name>;</type> 108 <type category="basetype">typedef <type>uint32_t</type> <name>VkBool32</name>;</type> 109 <type category="basetype">typedef <type>uint32_t</type> <name>VkFlags</name>;</type> 110 <type category="basetype">typedef <type>uint64_t</type> <name>VkDeviceSize</name>;</type> 111 <!-- Basic C types, pulled in via vk_platform.h --> 112 <type requires="vk_platform" name="void"/> 113 <type requires="vk_platform" name="char"/> 114 <type requires="vk_platform" name="float"/> 115 <type requires="vk_platform" name="uint8_t"/> 116 <type requires="vk_platform" name="uint32_t"/> 117 <type requires="vk_platform" name="uint64_t"/> 118 <type requires="vk_platform" name="int32_t"/> 119 <type requires="vk_platform" name="size_t"/> 120 <!-- Bitfield types --> 121 <type category="bitmask">typedef <type>VkFlags</type> <name>VkFramebufferCreateFlags</name>;</type> <!-- creation flags --> 122 <type category="bitmask">typedef <type>VkFlags</type> <name>VkQueryPoolCreateFlags</name>;</type> <!-- creation flags --> 123 <type category="bitmask">typedef <type>VkFlags</type> <name>VkRenderPassCreateFlags</name>;</type> <!-- creation flags --> 124 <type category="bitmask">typedef <type>VkFlags</type> <name>VkSamplerCreateFlags</name>;</type> <!-- creation flags --> 125 <type category="bitmask">typedef <type>VkFlags</type> <name>VkPipelineLayoutCreateFlags</name>;</type> <!-- creation flags --> 126 <type category="bitmask">typedef <type>VkFlags</type> <name>VkPipelineCacheCreateFlags</name>;</type> <!-- creation flags --> 127 <type category="bitmask">typedef <type>VkFlags</type> <name>VkPipelineDepthStencilStateCreateFlags</name>;</type> <!-- creation flags --> 128 <type category="bitmask">typedef <type>VkFlags</type> <name>VkPipelineDynamicStateCreateFlags</name>;</type> <!-- creation flags --> 129 <type category="bitmask">typedef <type>VkFlags</type> <name>VkPipelineColorBlendStateCreateFlags</name>;</type> <!-- creation flags --> 130 <type category="bitmask">typedef <type>VkFlags</type> <name>VkPipelineMultisampleStateCreateFlags</name>;</type> <!-- creation flags --> 131 <type category="bitmask">typedef <type>VkFlags</type> <name>VkPipelineRasterizationStateCreateFlags</name>;</type> <!-- creation flags --> 132 <type category="bitmask">typedef <type>VkFlags</type> <name>VkPipelineViewportStateCreateFlags</name>;</type> <!-- creation flags --> 133 <type category="bitmask">typedef <type>VkFlags</type> <name>VkPipelineTessellationStateCreateFlags</name>;</type> <!-- creation flags --> 134 <type category="bitmask">typedef <type>VkFlags</type> <name>VkPipelineInputAssemblyStateCreateFlags</name>;</type><!-- creation flags --> 135 <type category="bitmask">typedef <type>VkFlags</type> <name>VkPipelineVertexInputStateCreateFlags</name>;</type> <!-- creation flags --> 136 <type category="bitmask">typedef <type>VkFlags</type> <name>VkPipelineShaderStageCreateFlags</name>;</type> <!-- creation flags --> 137 <type category="bitmask">typedef <type>VkFlags</type> <name>VkDescriptorSetLayoutCreateFlags</name>;</type> <!-- creation flags --> 138 <type category="bitmask">typedef <type>VkFlags</type> <name>VkBufferViewCreateFlags</name>;</type> <!-- creation flags --> 139 <type category="bitmask">typedef <type>VkFlags</type> <name>VkInstanceCreateFlags</name>;</type> <!-- creation flags --> 140 <type category="bitmask">typedef <type>VkFlags</type> <name>VkDeviceCreateFlags</name>;</type> <!-- creation flags --> 141 <type category="bitmask">typedef <type>VkFlags</type> <name>VkDeviceQueueCreateFlags</name>;</type> <!-- creation flags --> 142 <type requires="VkQueueFlagBits" category="bitmask">typedef <type>VkFlags</type> <name>VkQueueFlags</name>;</type> <!-- Queue capabilities --> 143 <type requires="VkMemoryPropertyFlagBits" category="bitmask">typedef <type>VkFlags</type> <name>VkMemoryPropertyFlags</name>;</type> <!-- Memory properties passed into vkAllocateMemory(). --> 144 <type requires="VkMemoryHeapFlagBits" category="bitmask">typedef <type>VkFlags</type> <name>VkMemoryHeapFlags</name>;</type> <!-- Memory heap flags --> 145 <type requires="VkAccessFlagBits" category="bitmask">typedef <type>VkFlags</type> <name>VkAccessFlags</name>;</type> <!-- Memory access flags passed to barrier/dependency operations --> 146 <type requires="VkBufferUsageFlagBits" category="bitmask">typedef <type>VkFlags</type> <name>VkBufferUsageFlags</name>;</type> <!-- Buffer usage flags --> 147 <type requires="VkBufferCreateFlagBits" category="bitmask">typedef <type>VkFlags</type> <name>VkBufferCreateFlags</name>;</type> <!-- Buffer creation flags --> 148 <type requires="VkShaderStageFlagBits" category="bitmask">typedef <type>VkFlags</type> <name>VkShaderStageFlags</name>;</type> <!-- Shader stage flags --> 149 <type requires="VkImageUsageFlagBits" category="bitmask">typedef <type>VkFlags</type> <name>VkImageUsageFlags</name>;</type> <!-- Image usage flags --> 150 <type requires="VkImageCreateFlagBits" category="bitmask">typedef <type>VkFlags</type> <name>VkImageCreateFlags</name>;</type> <!-- Image creation flags --> 151 <type category="bitmask">typedef <type>VkFlags</type> <name>VkImageViewCreateFlags</name>;</type> <!-- Image view creation flags (no bits yet) --> 152 <type requires="VkPipelineCreateFlagBits" category="bitmask">typedef <type>VkFlags</type> <name>VkPipelineCreateFlags</name>;</type> <!-- Pipeline creation flags --> 153 <type requires="VkColorComponentFlagBits" category="bitmask">typedef <type>VkFlags</type> <name>VkColorComponentFlags</name>;</type> <!-- Color component flags --> 154 <type requires="VkFenceCreateFlagBits" category="bitmask">typedef <type>VkFlags</type> <name>VkFenceCreateFlags</name>;</type> <!-- Fence creation flags --> 155 <type category="bitmask">typedef <type>VkFlags</type> <name>VkSemaphoreCreateFlags</name>;</type> <!-- Semaphore creation flags --> 156 <type requires="VkFormatFeatureFlagBits" category="bitmask">typedef <type>VkFlags</type> <name>VkFormatFeatureFlags</name>;</type> <!-- Format capability flags --> 157 <type requires="VkQueryControlFlagBits" category="bitmask">typedef <type>VkFlags</type> <name>VkQueryControlFlags</name>;</type> <!-- Query control flags --> 158 <type requires="VkQueryResultFlagBits" category="bitmask">typedef <type>VkFlags</type> <name>VkQueryResultFlags</name>;</type> <!-- Query result flags --> 159 <type category="bitmask">typedef <type>VkFlags</type> <name>VkShaderModuleCreateFlags</name>;</type> <!-- Shader module creation flags (no bits yet) --> 160 <type category="bitmask">typedef <type>VkFlags</type> <name>VkEventCreateFlags</name>;</type> <!-- Event creation flags (no bits yet) --> 161 <type requires="VkCommandPoolCreateFlagBits" category="bitmask">typedef <type>VkFlags</type> <name>VkCommandPoolCreateFlags</name>;</type> <!-- Command pool creation flags --> 162 <type requires="VkCommandPoolResetFlagBits" category="bitmask">typedef <type>VkFlags</type> <name>VkCommandPoolResetFlags</name>;</type> <!-- Command pool reset flags --> 163 <type requires="VkCommandBufferResetFlagBits" category="bitmask">typedef <type>VkFlags</type> <name>VkCommandBufferResetFlags</name>;</type> <!-- Command buffer reset flags --> 164 <type requires="VkCommandBufferUsageFlagBits" category="bitmask">typedef <type>VkFlags</type> <name>VkCommandBufferUsageFlags</name>;</type> <!-- Command buffer usage flags --> 165 <type requires="VkQueryPipelineStatisticFlagBits" category="bitmask">typedef <type>VkFlags</type> <name>VkQueryPipelineStatisticFlags</name>;</type> <!-- Pipeline statistics flags --> 166 <type category="bitmask">typedef <type>VkFlags</type> <name>VkMemoryMapFlags</name>;</type> <!-- Memory mapping flags (no bits yet) --> 167 <type requires="VkImageAspectFlagBits" category="bitmask">typedef <type>VkFlags</type> <name>VkImageAspectFlags</name>;</type> <!-- Bitfield of image aspects --> 168 <type requires="VkSparseMemoryBindFlagBits" category="bitmask">typedef <type>VkFlags</type> <name>VkSparseMemoryBindFlags</name>;</type> <!-- Sparse memory bind flags --> 169 <type requires="VkSparseImageFormatFlagBits" category="bitmask">typedef <type>VkFlags</type> <name>VkSparseImageFormatFlags</name>;</type> <!-- Sparse image memory requirements flags --> 170 <type category="bitmask">typedef <type>VkFlags</type> <name>VkSubpassDescriptionFlags</name>;</type> <!-- Subpass description flags --> 171 <type requires="VkPipelineStageFlagBits" category="bitmask">typedef <type>VkFlags</type> <name>VkPipelineStageFlags</name>;</type> <!-- Pipeline stages --> 172 <type requires="VkSampleCountFlagBits" category="bitmask">typedef <type>VkFlags</type> <name>VkSampleCountFlags</name>;</type> <!-- Pipeline stages --> 173 <type requires="VkAttachmentDescriptionFlagBits" category="bitmask">typedef <type>VkFlags</type> <name>VkAttachmentDescriptionFlags</name>;</type> <!-- Render pass attachment description flags --> 174 <type requires="VkStencilFaceFlagBits" category="bitmask">typedef <type>VkFlags</type> <name>VkStencilFaceFlags</name>;</type> <!-- Stencil face flags --> 175 <type requires="VkCullModeFlagBits" category="bitmask">typedef <type>VkFlags</type> <name>VkCullModeFlags</name>;</type> <!-- Cull mode flags --> 176 <type requires="VkDescriptorPoolCreateFlagBits" category="bitmask">typedef <type>VkFlags</type> <name>VkDescriptorPoolCreateFlags</name>;</type> <!-- Descriptor pool creation flags --> 177 <type category="bitmask">typedef <type>VkFlags</type> <name>VkDescriptorPoolResetFlags</name>;</type> <!-- Descriptor pool reset flags --> 178 <type requires="VkDependencyFlagBits" category="bitmask">typedef <type>VkFlags</type> <name>VkDependencyFlags</name>;</type> <!-- Pipeline barrier and subpass dependency flags --> 179 <!-- WSI extensions --> 180 <type requires="VkCompositeAlphaFlagBitsKHR" category="bitmask">typedef <type>VkFlags</type> <name>VkCompositeAlphaFlagsKHR</name>;</type> 181 <type requires="VkDisplayPlaneAlphaFlagBitsKHR" category="bitmask">typedef <type>VkFlags</type> <name>VkDisplayPlaneAlphaFlagsKHR</name>;</type> 182 <type requires="VkSurfaceTransformFlagBitsKHR" category="bitmask">typedef <type>VkFlags</type> <name>VkSurfaceTransformFlagsKHR</name>;</type> 183 <type category="bitmask">typedef <type>VkFlags</type> <name>VkSwapchainCreateFlagsKHR</name>;</type> <!-- creation flags --> 184 <type category="bitmask">typedef <type>VkFlags</type> <name>VkDisplayModeCreateFlagsKHR</name>;</type> <!-- creation flags --> 185 <type category="bitmask">typedef <type>VkFlags</type> <name>VkDisplaySurfaceCreateFlagsKHR</name>;</type> <!-- creation flags --> 186 <type category="bitmask">typedef <type>VkFlags</type> <name>VkAndroidSurfaceCreateFlagsKHR</name>;</type> <!-- creation flags --> 187 <type category="bitmask">typedef <type>VkFlags</type> <name>VkMirSurfaceCreateFlagsKHR</name>;</type> <!-- creation flags --> 188 <type category="bitmask">typedef <type>VkFlags</type> <name>VkWaylandSurfaceCreateFlagsKHR</name>;</type> <!-- creation flags --> 189 <type category="bitmask">typedef <type>VkFlags</type> <name>VkWin32SurfaceCreateFlagsKHR</name>;</type> <!-- creation flags --> 190 <type category="bitmask">typedef <type>VkFlags</type> <name>VkXlibSurfaceCreateFlagsKHR</name>;</type> <!-- creation flags --> 191 <type category="bitmask">typedef <type>VkFlags</type> <name>VkXcbSurfaceCreateFlagsKHR</name>;</type> <!-- creation flags --> 192 193 <type requires="VkDebugReportFlagBitsEXT" category="bitmask">typedef <type>VkFlags</type> <name>VkDebugReportFlagsEXT</name>;</type> 194 195 <!-- Types which can be void pointers or class pointers, selected at compile time --> 196 <type category="handle"><type>VK_DEFINE_HANDLE</type>(<name>VkInstance</name>)</type> 197 <type category="handle" parent="VkInstance"><type>VK_DEFINE_HANDLE</type>(<name>VkPhysicalDevice</name>)</type> 198 <type category="handle" parent="VkPhysicalDevice"><type>VK_DEFINE_HANDLE</type>(<name>VkDevice</name>)</type> 199 <type category="handle" parent="VkDevice"><type>VK_DEFINE_HANDLE</type>(<name>VkQueue</name>)</type> 200 <type category="handle" parent="VkCommandPool"><type>VK_DEFINE_HANDLE</type>(<name>VkCommandBuffer</name>)</type> 201 <type category="handle" parent="VkDevice"><type>VK_DEFINE_NON_DISPATCHABLE_HANDLE</type>(<name>VkDeviceMemory</name>)</type> 202 <type category="handle" parent="VkDevice"><type>VK_DEFINE_NON_DISPATCHABLE_HANDLE</type>(<name>VkCommandPool</name>)</type> 203 <type category="handle" parent="VkDevice"><type>VK_DEFINE_NON_DISPATCHABLE_HANDLE</type>(<name>VkBuffer</name>)</type> 204 <type category="handle" parent="VkDevice"><type>VK_DEFINE_NON_DISPATCHABLE_HANDLE</type>(<name>VkBufferView</name>)</type> 205 <type category="handle" parent="VkDevice"><type>VK_DEFINE_NON_DISPATCHABLE_HANDLE</type>(<name>VkImage</name>)</type> 206 <type category="handle" parent="VkDevice"><type>VK_DEFINE_NON_DISPATCHABLE_HANDLE</type>(<name>VkImageView</name>)</type> 207 <type category="handle" parent="VkDevice"><type>VK_DEFINE_NON_DISPATCHABLE_HANDLE</type>(<name>VkShaderModule</name>)</type> 208 <type category="handle" parent="VkDevice"><type>VK_DEFINE_NON_DISPATCHABLE_HANDLE</type>(<name>VkPipeline</name>)</type> 209 <type category="handle" parent="VkDevice"><type>VK_DEFINE_NON_DISPATCHABLE_HANDLE</type>(<name>VkPipelineLayout</name>)</type> 210 <type category="handle" parent="VkDevice"><type>VK_DEFINE_NON_DISPATCHABLE_HANDLE</type>(<name>VkSampler</name>)</type> 211 <type category="handle" parent="VkDescriptorPool"><type>VK_DEFINE_NON_DISPATCHABLE_HANDLE</type>(<name>VkDescriptorSet</name>)</type> 212 <type category="handle" parent="VkDevice"><type>VK_DEFINE_NON_DISPATCHABLE_HANDLE</type>(<name>VkDescriptorSetLayout</name>)</type> 213 <type category="handle" parent="VkDevice"><type>VK_DEFINE_NON_DISPATCHABLE_HANDLE</type>(<name>VkDescriptorPool</name>)</type> 214 <type category="handle" parent="VkDevice"><type>VK_DEFINE_NON_DISPATCHABLE_HANDLE</type>(<name>VkFence</name>)</type> 215 <type category="handle" parent="VkDevice"><type>VK_DEFINE_NON_DISPATCHABLE_HANDLE</type>(<name>VkSemaphore</name>)</type> 216 <type category="handle" parent="VkDevice"><type>VK_DEFINE_NON_DISPATCHABLE_HANDLE</type>(<name>VkEvent</name>)</type> 217 <type category="handle" parent="VkDevice"><type>VK_DEFINE_NON_DISPATCHABLE_HANDLE</type>(<name>VkQueryPool</name>)</type> 218 <type category="handle" parent="VkDevice"><type>VK_DEFINE_NON_DISPATCHABLE_HANDLE</type>(<name>VkFramebuffer</name>)</type> 219 <type category="handle" parent="VkDevice"><type>VK_DEFINE_NON_DISPATCHABLE_HANDLE</type>(<name>VkRenderPass</name>)</type> 220 <type category="handle" parent="VkDevice"><type>VK_DEFINE_NON_DISPATCHABLE_HANDLE</type>(<name>VkPipelineCache</name>)</type> 221 222 <!-- WSI extensions --> 223 <type category="handle"><type>VK_DEFINE_NON_DISPATCHABLE_HANDLE</type>(<name>VkDisplayKHR</name>)</type> 224 <type category="handle" parent="VkPhysicalDevice,VkDisplayKHR"><type>VK_DEFINE_NON_DISPATCHABLE_HANDLE</type>(<name>VkDisplayModeKHR</name>)</type> 225 <type category="handle" parent="VkInstance"><type>VK_DEFINE_NON_DISPATCHABLE_HANDLE</type>(<name>VkSurfaceKHR</name>)</type> 226 <type category="handle" parent="VkSurfaceKHR"><type>VK_DEFINE_NON_DISPATCHABLE_HANDLE</type>(<name>VkSwapchainKHR</name>)</type> 227 <type category="handle" parent="VkInstance"><type>VK_DEFINE_NON_DISPATCHABLE_HANDLE</type>(<name>VkDebugReportCallbackEXT</name>)</type> 228 229 <!-- Types generated from corresponding <enums> tags below --> 230 <type name="VkAttachmentLoadOp" category="enum"/> 231 <type name="VkAttachmentStoreOp" category="enum"/> 232 <type name="VkBlendFactor" category="enum"/> 233 <type name="VkBlendOp" category="enum"/> 234 <type name="VkBorderColor" category="enum"/> 235 <type name="VkFramebufferCreateFlagBits" category="enum"/> 236 <type name="VkQueryPoolCreateFlagBits" category="enum"/> 237 <type name="VkRenderPassCreateFlagBits" category="enum"/> 238 <type name="VkSamplerCreateFlagBits" category="enum"/> 239 <type name="VkPipelineCacheHeaderVersion" category="enum"/> 240 <type name="VkPipelineLayoutCreateFlagBits" category="enum"/> 241 <type name="VkPipelineCacheCreateFlagBits" category="enum"/> 242 <type name="VkPipelineDepthStencilStateCreateFlagBits" category="enum"/> 243 <type name="VkPipelineDynamicStateCreateFlagBits" category="enum"/> 244 <type name="VkPipelineColorBlendStateCreateFlagBits" category="enum"/> 245 <type name="VkPipelineMultisampleStateCreateFlagBits" category="enum"/> 246 <type name="VkPipelineRasterizationStateCreateFlagBits" category="enum"/> 247 <type name="VkPipelineViewportStateCreateFlagBits" category="enum"/> 248 <type name="VkPipelineTessellationStateCreateFlagBits" category="enum"/> 249 <type name="VkPipelineInputAssemblyStateCreateFlagBits" category="enum"/> 250 <type name="VkPipelineVertexInputStateCreateFlagBits" category="enum"/> 251 <type name="VkPipelineShaderStageCreateFlagBits" category="enum"/> 252 <type name="VkDescriptorSetLayoutCreateFlagBits" category="enum"/> 253 <type name="VkBufferViewCreateFlagBits" category="enum"/> 254 <type name="VkInstanceCreateFlagBits" category="enum"/> 255 <type name="VkDeviceQueueCreateFlagBits" category="enum"/> 256 <type name="VkBufferCreateFlagBits" category="enum"/> 257 <type name="VkBufferUsageFlagBits" category="enum"/> 258 <type name="VkColorComponentFlagBits" category="enum"/> 259 <type name="VkComponentSwizzle" category="enum"/> 260 <type name="VkCommandPoolCreateFlagBits" category="enum"/> 261 <type name="VkCommandPoolResetFlagBits" category="enum"/> 262 <type name="VkCommandBufferResetFlagBits" category="enum"/> 263 <type name="VkCommandBufferLevel" category="enum"/> 264 <type name="VkCommandBufferUsageFlagBits" category="enum"/> 265 <type name="VkCompareOp" category="enum"/> 266 <type name="VkCullModeFlagBits" category="enum"/> 267 <type name="VkDescriptorType" category="enum"/> 268 <type name="VkDeviceCreateFlagBits" category="enum"/> 269 <type name="VkDynamicState" category="enum"/> 270 <type name="VkFenceCreateFlagBits" category="enum"/> 271 <type name="VkPolygonMode" category="enum"/> 272 <type name="VkFormat" category="enum"/> 273 <type name="VkFormatFeatureFlagBits" category="enum"/> 274 <type name="VkFrontFace" category="enum"/> 275 <type name="VkImageAspectFlagBits" category="enum"/> 276 <type name="VkImageCreateFlagBits" category="enum"/> 277 <type name="VkImageLayout" category="enum"/> 278 <type name="VkImageTiling" category="enum"/> 279 <type name="VkImageType" category="enum"/> 280 <type name="VkImageUsageFlagBits" category="enum"/> 281 <type name="VkImageViewType" category="enum"/> 282 <type name="VkSharingMode" category="enum"/> 283 <type name="VkIndexType" category="enum"/> 284 <type name="VkLogicOp" category="enum"/> 285 <type name="VkMemoryHeapFlagBits" category="enum"/> 286 <type name="VkAccessFlagBits" category="enum"/> 287 <type name="VkMemoryPropertyFlagBits" category="enum"/> 288 <type name="VkPhysicalDeviceType" category="enum"/> 289 <type name="VkPipelineBindPoint" category="enum"/> 290 <type name="VkPipelineCreateFlagBits" category="enum"/> 291 <type name="VkPrimitiveTopology" category="enum"/> 292 <type name="VkQueryControlFlagBits" category="enum"/> 293 <type name="VkQueryPipelineStatisticFlagBits" category="enum"/> 294 <type name="VkQueryResultFlagBits" category="enum"/> 295 <type name="VkQueryType" category="enum"/> 296 <type name="VkQueueFlagBits" category="enum"/> 297 <type name="VkSubpassContents" category="enum"/> 298 <type name="VkResult" category="enum"/> 299 <type name="VkShaderStageFlagBits" category="enum"/> 300 <type name="VkSparseMemoryBindFlagBits" category="enum"/> 301 <type name="VkStencilFaceFlagBits" category="enum"/> 302 <type name="VkStencilOp" category="enum"/> 303 <type name="VkStructureType" category="enum"/> 304 <type name="VkSystemAllocationScope" category="enum"/> 305 <type name="VkInternalAllocationType" category="enum"/> 306 <type name="VkSamplerAddressMode" category="enum"/> 307 <type name="VkFilter" category="enum"/> 308 <type name="VkSamplerMipmapMode" category="enum"/> 309 <type name="VkVertexInputRate" category="enum"/> 310 <type name="VkPipelineStageFlagBits" category="enum"/> 311 <type name="VkSparseImageFormatFlagBits" category="enum"/> 312 <type name="VkSampleCountFlagBits" category="enum"/> 313 <type name="VkAttachmentDescriptionFlagBits" category="enum"/> 314 <type name="VkDescriptorPoolCreateFlagBits" category="enum"/> 315 <type name="VkDependencyFlagBits" category="enum"/> 316 <!-- WSI extensions --> 317 <type name="VkColorSpaceKHR" category="enum"/> 318 <type name="VkCompositeAlphaFlagBitsKHR" category="enum"/> 319 <type name="VkDisplayPlaneAlphaFlagBitsKHR" category="enum"/> 320 <type name="VkPresentModeKHR" category="enum"/> 321 <type name="VkSurfaceTransformFlagBitsKHR" category="enum"/> 322 <type name="VkDebugReportFlagBitsEXT" category="enum"/> 323 <type name="VkDebugReportObjectTypeEXT" category="enum"/> 324 <type name="VkDebugReportErrorEXT" category="enum"/> 325 326 <!-- The PFN_vk*Function types are used by VkAllocationCallbacks below --> 327 <type category="funcpointer">typedef void (VKAPI_PTR *<name>PFN_vkInternalAllocationNotification</name>)( 328 <type>void</type>* pUserData, 329 <type>size_t</type> size, 330 <type>VkInternalAllocationType</type> allocationType, 331 <type>VkSystemAllocationScope</type> allocationScope);</type> 332 <type category="funcpointer">typedef void (VKAPI_PTR *<name>PFN_vkInternalFreeNotification</name>)( 333 <type>void</type>* pUserData, 334 <type>size_t</type> size, 335 <type>VkInternalAllocationType</type> allocationType, 336 <type>VkSystemAllocationScope</type> allocationScope);</type> 337 <type category="funcpointer">typedef void* (VKAPI_PTR *<name>PFN_vkReallocationFunction</name>)( 338 <type>void</type>* pUserData, 339 <type>void</type>* pOriginal, 340 <type>size_t</type> size, 341 <type>size_t</type> alignment, 342 <type>VkSystemAllocationScope</type> allocationScope);</type> 343 <type category="funcpointer">typedef void* (VKAPI_PTR *<name>PFN_vkAllocationFunction</name>)( 344 <type>void</type>* pUserData, 345 <type>size_t</type> size, 346 <type>size_t</type> alignment, 347 <type>VkSystemAllocationScope</type> allocationScope);</type> 348 <type category="funcpointer">typedef void (VKAPI_PTR *<name>PFN_vkFreeFunction</name>)( 349 <type>void</type>* pUserData, 350 <type>void</type>* pMemory);</type> 351 352 <!-- The PFN_vkVoidFunction type are used by VkGet*ProcAddr below --> 353 <type category="funcpointer">typedef void (VKAPI_PTR *<name>PFN_vkVoidFunction</name>)(void);</type> 354 355 <!-- The PFN_vkDebugReportCallbackEXT type are used by the DEBUG_REPORT extension--> 356 <type category="funcpointer">typedef VkBool32 (VKAPI_PTR *<name>PFN_vkDebugReportCallbackEXT</name>)( 357 <type>VkDebugReportFlagsEXT</type> flags, 358 <type>VkDebugReportObjectTypeEXT</type> objectType, 359 <type>uint64_t</type> object, 360 <type>size_t</type> location, 361 <type>int32_t</type> messageCode, 362 const <type>char</type>* pLayerPrefix, 363 const <type>char</type>* pMessage, 364 <type>void</type>* pUserData);</type> 365 366 <!-- Struct types --> 367 <type category="struct" name="VkOffset2D"> 368 <member><type>int32_t</type> <name>x</name></member> 369 <member><type>int32_t</type> <name>y</name></member> 370 </type> 371 <type category="struct" name="VkOffset3D"> 372 <member><type>int32_t</type> <name>x</name></member> 373 <member><type>int32_t</type> <name>y</name></member> 374 <member><type>int32_t</type> <name>z</name></member> 375 </type> 376 <type category="struct" name="VkExtent2D"> 377 <member><type>uint32_t</type> <name>width</name></member> 378 <member><type>uint32_t</type> <name>height</name></member> 379 </type> 380 <type category="struct" name="VkExtent3D"> 381 <member><type>uint32_t</type> <name>width</name></member> 382 <member><type>uint32_t</type> <name>height</name></member> 383 <member><type>uint32_t</type> <name>depth</name></member> 384 </type> 385 <type category="struct" name="VkViewport"> 386 <member><type>float</type> <name>x</name></member> 387 <member><type>float</type> <name>y</name></member> 388 <member><type>float</type> <name>width</name></member> 389 <member><type>float</type> <name>height</name></member> 390 <member><type>float</type> <name>minDepth</name></member> 391 <member><type>float</type> <name>maxDepth</name></member> 392 <validity> 393 <usage>pname:width must: be greater than `0.0` and less than or equal to sname:VkPhysicalDeviceLimits::pname:maxViewportDimensions[0]</usage> 394 <usage>pname:height must: be greater than `0.0` and less than or equal to sname:VkPhysicalDeviceLimits::pname:maxViewportDimensions[1]</usage> 395 <usage>pname:x and pname:y must: each be between pname:viewportBoundsRange[0] and pname:viewportBoundsRange[1], inclusive</usage> 396 <usage>pname:x + pname:width must: be less than or equal to pname:viewportBoundsRange[1]</usage> 397 <usage>pname:y + pname:height must: be less than or equal to pname:viewportBoundsRange[1]</usage> 398 <usage>pname:minDepth must: be between `0.0` and `1.0`, inclusive</usage> 399 <usage>pname:maxDepth must: be between `0.0` and `1.0`, inclusive</usage> 400 </validity> 401 </type> 402 <type category="struct" name="VkRect2D"> 403 <member><type>VkOffset2D</type> <name>offset</name></member> 404 <member><type>VkExtent2D</type> <name>extent</name></member> 405 </type> 406 <type category="struct" name="VkRect3D"> 407 <member><type>VkOffset3D</type> <name>offset</name></member> 408 <member><type>VkExtent3D</type> <name>extent</name></member> 409 </type> 410 <type category="struct" name="VkClearRect"> 411 <member><type>VkRect2D</type> <name>rect</name></member> 412 <member><type>uint32_t</type> <name>baseArrayLayer</name></member> 413 <member><type>uint32_t</type> <name>layerCount</name></member> 414 </type> 415 <type category="struct" name="VkComponentMapping"> 416 <member><type>VkComponentSwizzle</type> <name>r</name></member> 417 <member><type>VkComponentSwizzle</type> <name>g</name></member> 418 <member><type>VkComponentSwizzle</type> <name>b</name></member> 419 <member><type>VkComponentSwizzle</type> <name>a</name></member> 420 </type> 421 <type category="struct" name="VkPhysicalDeviceProperties" returnedonly="true"> 422 <member><type>uint32_t</type> <name>apiVersion</name></member> 423 <member><type>uint32_t</type> <name>driverVersion</name></member> 424 <member><type>uint32_t</type> <name>vendorID</name></member> 425 <member><type>uint32_t</type> <name>deviceID</name></member> 426 <member><type>VkPhysicalDeviceType</type> <name>deviceType</name></member> 427 <member><type>char</type> <name>deviceName</name>[<enum>VK_MAX_PHYSICAL_DEVICE_NAME_SIZE</enum>]</member> 428 <member><type>uint8_t</type> <name>pipelineCacheUUID</name>[<enum>VK_UUID_SIZE</enum>]</member> 429 <member><type>VkPhysicalDeviceLimits</type> <name>limits</name></member> 430 <member><type>VkPhysicalDeviceSparseProperties</type> <name>sparseProperties</name></member> 431 </type> 432 <type category="struct" name="VkExtensionProperties" returnedonly="true"> 433 <member><type>char</type> <name>extensionName</name>[<enum>VK_MAX_EXTENSION_NAME_SIZE</enum>]</member> <!-- extension name --> 434 <member><type>uint32_t</type> <name>specVersion</name></member> <!-- version of the extension specification implemented --> 435 </type> 436 <type category="struct" name="VkLayerProperties" returnedonly="true"> 437 <member><type>char</type> <name>layerName</name>[<enum>VK_MAX_EXTENSION_NAME_SIZE</enum>]</member> <!-- layer name --> 438 <member><type>uint32_t</type> <name>specVersion</name></member> <!-- version of the layer specification implemented --> 439 <member><type>uint32_t</type> <name>implementationVersion</name></member> <!-- build or release version of the layer's library --> 440 <member><type>char</type> <name>description</name>[<enum>VK_MAX_DESCRIPTION_SIZE</enum>]</member> <!-- Free-form description of the layer --> 441 </type> 442 <type category="struct" name="VkApplicationInfo"> 443 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Type of structure. Should be VK_STRUCTURE_TYPE_APPLICATION_INFO --> 444 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 445 <member optional="true" len="null-terminated">const <type>char</type>* <name>pApplicationName</name></member> 446 <member><type>uint32_t</type> <name>applicationVersion</name></member> 447 <member optional="true" len="null-terminated">const <type>char</type>* <name>pEngineName</name></member> 448 <member><type>uint32_t</type> <name>engineVersion</name></member> 449 <member><type>uint32_t</type> <name>apiVersion</name></member> 450 <validity> 451 <usage>pname:apiVersion must: be a version that the implementation supports, or supports an effective substitute for</usage> 452 </validity> 453 </type> 454 <type category="struct" name="VkAllocationCallbacks"> 455 <member optional="true"><type>void</type>* <name>pUserData</name></member> 456 <member><type>PFN_vkAllocationFunction</type> <name>pfnAllocation</name></member> 457 <member><type>PFN_vkReallocationFunction</type> <name>pfnReallocation</name></member> 458 <member><type>PFN_vkFreeFunction</type> <name>pfnFree</name></member> 459 <member optional="true"><type>PFN_vkInternalAllocationNotification</type> <name>pfnInternalAllocation</name></member> 460 <member optional="true"><type>PFN_vkInternalFreeNotification</type> <name>pfnInternalFree</name></member> 461 <validity> 462 <usage>pname:pfnAllocation must: be a pointer to a valid user-defined PFN_vkAllocationFunction</usage> 463 <usage>pname:pfnReallocation must: be a pointer to a valid user-defined PFN_vkReallocationFunction</usage> 464 <usage>pname:pfnFree must: be a pointer to a valid user-defined PFN_vkFreeFunction</usage> 465 <usage>If either of pname:pfnInternalAllocatione or pname:pfnInternalFree is not `NULL`, both must: be valid callbacks</usage> 466 </validity> 467 </type> 468 <type category="struct" name="VkDeviceQueueCreateInfo"> 469 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Should be VK_STRUCTURE_TYPE_DEVICE_QUEUE_CREATE_INFO --> 470 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 471 <member optional="true"><type>VkDeviceQueueCreateFlags</type> <name>flags</name></member> <!-- Reserved --> 472 <member><type>uint32_t</type> <name>queueFamilyIndex</name></member> 473 <member><type>uint32_t</type> <name>queueCount</name></member> 474 <member len="queueCount">const <type>float</type>* <name>pQueuePriorities</name></member> 475 <validity> 476 <usage>pname:queueFamilyIndex must: be less than the value of pname:pQueueFamilyPropertyCount returned by fname:vkGetPhysicalDeviceQueueFamilyProperties</usage> 477 <usage>pname:queueCount must: be less than or equal to the value of the pname:queueCount member of the sname:VkQueueFamilyProperties structure, as returned by fname:vkGetPhysicalDeviceQueueFamilyProperties in the pname:pQueueFamilyProperties[pname:queueFamilyIndex]</usage> 478 <usage>The value of any given element of pname:pQueuePriorities must: be between `0.0` and `1.0` inclusive</usage> 479 </validity> 480 </type> 481 <type category="struct" name="VkDeviceCreateInfo"> 482 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Should be VK_STRUCTURE_TYPE_DEVICE_CREATE_INFO --> 483 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 484 <member optional="true"><type>VkDeviceCreateFlags</type> <name>flags</name></member> <!-- Reserved --> 485 <member><type>uint32_t</type> <name>queueCreateInfoCount</name></member> 486 <member len="queueCreateInfoCount">const <type>VkDeviceQueueCreateInfo</type>* <name>pQueueCreateInfos</name></member> 487 <member optional="true"><type>uint32_t</type> <name>enabledLayerCount</name></member> 488 <member optional="true" len="enabledLayerCount,null-terminated">const <type>char</type>* const* <name>ppEnabledLayerNames</name></member> <!-- Ordered list of layer names to be enabled --> 489 <member optional="true"><type>uint32_t</type> <name>enabledExtensionCount</name></member> 490 <member optional="true" len="enabledExtensionCount,null-terminated">const <type>char</type>* const* <name>ppEnabledExtensionNames</name></member> 491 <member optional="true">const <type>VkPhysicalDeviceFeatures</type>* <name>pEnabledFeatures</name></member> 492 <validity> 493 <usage>Any given element of pname:ppEnabledLayerNames must: be the name of a layer present on the system, exactly matching a string returned in the sname:VkLayerProperties structure by fname:vkEnumerateDeviceLayerProperties</usage> 494 <usage>Any given element of pname:ppEnabledExtensionNames must: be the name of an extension present on the system, exactly matching a string returned in the sname:VkExtensionProperties structure by fname:vkEnumerateDeviceExtensionProperties</usage> 495 <usage>If an extension listed in pname:ppEnabledExtensionNames is provided as part of a layer, then both the layer and extension must: be enabled to enable that extension</usage> 496 <usage>The pname:queueFamilyIndex member of any given element of pname:pQueueCreateInfos must: be unique within pname:pQueueCreateInfos</usage> 497 </validity> 498 </type> 499 <type category="struct" name="VkInstanceCreateInfo"> 500 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Should be VK_STRUCTURE_TYPE_INSTANCE_CREATE_INFO --> 501 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 502 <member optional="true"><type>VkInstanceCreateFlags</type> <name>flags</name></member> <!-- Reserved --> 503 <member optional="true">const <type>VkApplicationInfo</type>* <name>pApplicationInfo</name></member> 504 <member optional="true"><type>uint32_t</type> <name>enabledLayerCount</name></member> 505 <member len="enabledLayerCount,null-terminated">const <type>char</type>* const* <name>ppEnabledLayerNames</name></member> <!-- Ordered list of layer names to be enabled --> 506 <member optional="true"><type>uint32_t</type> <name>enabledExtensionCount</name></member> 507 <member len="enabledExtensionCount,null-terminated">const <type>char</type>* const* <name>ppEnabledExtensionNames</name></member> <!-- Extension names to be enabled --> 508 <validity> 509 <usage>Any given element of pname:ppEnabledLayerNames must: be the name of a layer present on the system, exactly matching a string returned in the sname:VkLayerProperties structure by fname:vkEnumerateInstanceLayerProperties</usage> 510 <usage>Any given element of pname:ppEnabledExtensionNames must: be the name of an extension present on the system, exactly matching a string returned in the sname:VkExtensionProperties structure by fname:vkEnumerateInstanceExtensionProperties</usage> 511 <usage>If an extension listed in pname:ppEnabledExtensionNames is provided as part of a layer, then both the layer and extension must: be enabled to enable that extension</usage> 512 </validity> 513 </type> 514 <type category="struct" name="VkQueueFamilyProperties" returnedonly="true"> 515 <member optional="true"><type>VkQueueFlags</type> <name>queueFlags</name></member> <!-- Queue flags --> 516 <member><type>uint32_t</type> <name>queueCount</name></member> 517 <member><type>uint32_t</type> <name>timestampValidBits</name></member> 518 <member><type>VkExtent3D</type> <name>minImageTransferGranularity</name></member> <!-- Minimum alignment requirement for image transfers --> 519 </type> 520 <type category="struct" name="VkPhysicalDeviceMemoryProperties" returnedonly="true"> 521 <member><type>uint32_t</type> <name>memoryTypeCount</name></member> 522 <member><type>VkMemoryType</type> <name>memoryTypes</name>[<enum>VK_MAX_MEMORY_TYPES</enum>]</member> 523 <member><type>uint32_t</type> <name>memoryHeapCount</name></member> 524 <member><type>VkMemoryHeap</type> <name>memoryHeaps</name>[<enum>VK_MAX_MEMORY_HEAPS</enum>]</member> 525 </type> 526 <type category="struct" name="VkMemoryAllocateInfo"> 527 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_MEMORY_ALLOCATE_INFO --> 528 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 529 <member><type>VkDeviceSize</type> <name>allocationSize</name></member> <!-- Size of memory allocation --> 530 <member><type>uint32_t</type> <name>memoryTypeIndex</name></member> <!-- Index of the of the memory type to allocate from --> 531 <validity> 532 <usage>The value of pname:allocationSize must: be less than or equal to the amount of memory available to the sname:VkMemoryHeap specified by pname:memoryTypeIndex and the calling command's sname:VkDevice</usage> 533 <usage>The value of pname:allocationSize must: be greater than `0`</usage> 534 </validity> 535 </type> 536 <type category="struct" name="VkMemoryRequirements" returnedonly="true"> 537 <member><type>VkDeviceSize</type> <name>size</name></member> <!-- Specified in bytes --> 538 <member><type>VkDeviceSize</type> <name>alignment</name></member> <!-- Specified in bytes --> 539 <member><type>uint32_t</type> <name>memoryTypeBits</name></member> <!-- Bitfield of the allowed memory type indices into memoryTypes[] for this object --> 540 </type> 541 <type category="struct" name="VkSparseImageFormatProperties" returnedonly="true"> 542 <member optional="true"><type>VkImageAspectFlags</type> <name>aspectMask</name></member> 543 <member><type>VkExtent3D</type> <name>imageGranularity</name></member> 544 <member optional="true"><type>VkSparseImageFormatFlags</type> <name>flags</name></member> 545 </type> 546 <type category="struct" name="VkSparseImageMemoryRequirements" returnedonly="true"> 547 <member><type>VkSparseImageFormatProperties</type> <name>formatProperties</name></member> 548 <member><type>uint32_t</type> <name>imageMipTailFirstLod</name></member> 549 <member><type>VkDeviceSize</type> <name>imageMipTailSize</name></member> <!-- Specified in bytes, must be a multiple of image block size / alignment --> 550 <member><type>VkDeviceSize</type> <name>imageMipTailOffset</name></member> <!-- Specified in bytes, must be a multiple of image block size / alignment --> 551 <member><type>VkDeviceSize</type> <name>imageMipTailStride</name></member> <!-- Specified in bytes, must be a multiple of image block size / alignment --> 552 </type> 553 <type category="struct" name="VkMemoryType" returnedonly="true"> 554 <member optional="true"><type>VkMemoryPropertyFlags</type> <name>propertyFlags</name></member> <!-- Memory properties of this memory type --> 555 <member><type>uint32_t</type> <name>heapIndex</name></member> <!-- Index of the memory heap allocations of this memory type are taken from --> 556 </type> 557 <type category="struct" name="VkMemoryHeap" returnedonly="true"> 558 <member><type>VkDeviceSize</type> <name>size</name></member> <!-- Available memory in the heap--> 559 <member optional="true"><type>VkMemoryHeapFlags</type> <name>flags</name></member> <!-- Flags for the heap--> 560 </type> 561 <type category="struct" name="VkMappedMemoryRange"> 562 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_MAPPED_MEMORY_RANGE --> 563 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 564 <member><type>VkDeviceMemory</type> <name>memory</name></member> <!-- Mapped memory object --> 565 <member><type>VkDeviceSize</type> <name>offset</name></member> <!-- Offset within the mapped memory the range starts from --> 566 <member><type>VkDeviceSize</type> <name>size</name></member> <!-- Size of the range within the mapped memory --> 567 <validity> 568 <usage>pname:memory must: currently be mapped</usage> 569 <usage>pname:offset must: be less than the size of the currently mapped range of pname:memory</usage> 570 <usage>If pname:size is not equal to ename:VK_WHOLE_SIZE, the sum of pname:offset and pname:size must: be less than or equal to the size of the currently mapped range of pname:memory</usage> 571 <usage>pname:offset and pname:size must: each be a multiple of sname:VkPhysicalDeviceLimits::pname:nonCoherentAtomSize</usage> 572 </validity> 573 </type> 574 <type category="struct" name="VkFormatProperties" returnedonly="true"> 575 <member optional="true"><type>VkFormatFeatureFlags</type> <name>linearTilingFeatures</name></member> <!-- Format features in case of linear tiling --> 576 <member optional="true"><type>VkFormatFeatureFlags</type> <name>optimalTilingFeatures</name></member> <!-- Format features in case of optimal tiling --> 577 <member optional="true"><type>VkFormatFeatureFlags</type> <name>bufferFeatures</name></member> <!-- Format features supported by buffers --> 578 </type> 579 <type category="struct" name="VkImageFormatProperties" returnedonly="true"> 580 <member><type>VkExtent3D</type> <name>maxExtent</name></member> <!-- max image dimensions for this resource type --> 581 <member><type>uint32_t</type> <name>maxMipLevels</name></member> <!-- max number of mipmap levels for this resource type --> 582 <member><type>uint32_t</type> <name>maxArrayLayers</name></member> <!-- max array size for this resource type --> 583 <member optional="true"><type>VkSampleCountFlags</type> <name>sampleCounts</name></member> <!-- supported sample counts for this resource type --> 584 <member><type>VkDeviceSize</type> <name>maxResourceSize</name></member> <!-- max size (in bytes) of this resource type --> 585 </type> 586 <type category="struct" name="VkDescriptorBufferInfo"> 587 <member><type>VkBuffer</type> <name>buffer</name></member> <!-- Buffer used for this descriptor slot when the descriptor is UNIFORM_BUFFER[_DYNAMIC] or STORAGE_BUFFER[_DYNAMIC]. VK_NULL_HANDLE otherwise. --> 588 <member><type>VkDeviceSize</type> <name>offset</name></member> <!-- Base offset from buffer start in bytes to update in the descriptor set. --> 589 <member><type>VkDeviceSize</type> <name>range</name></member> <!-- Size in bytes of the buffer resource for this descriptor update. --> 590 <validity> 591 <usage>If pname:range is not equal to ename:VK_WHOLE_SIZE, the sum of pname:offset and pname:range must: be less than or equal to the size of pname:buffer</usage> 592 </validity> 593 </type> 594 <type category="struct" name="VkDescriptorImageInfo"> 595 <member noautovalidity="true"><type>VkSampler</type> <name>sampler</name></member> <!-- Sampler to write to the descriptor in case it's a SAMPLER or COMBINED_IMAGE_SAMPLER descriptor. Ignored otherwise. --> 596 <member noautovalidity="true"><type>VkImageView</type> <name>imageView</name></member> <!-- Image view to write to the descriptor in case it's a SAMPLED_IMAGE, STORAGE_IMAGE, COMBINED_IMAGE_SAMPLER, or INPUT_ATTACHMENT descriptor. Ignored otherwise. --> 597 <member noautovalidity="true"><type>VkImageLayout</type> <name>imageLayout</name></member> <!-- Layout the image is expected to be in when accessed using this descriptor (only used if imageView is not VK_NULL_HANDLE). --> 598 </type> 599 <type category="struct" name="VkWriteDescriptorSet"> 600 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_WRITE_DESCRIPTOR_SET --> 601 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 602 <member><type>VkDescriptorSet</type> <name>dstSet</name></member> <!-- Destination descriptor set --> 603 <member><type>uint32_t</type> <name>dstBinding</name></member> <!-- Binding within the destination descriptor set to write --> 604 <member><type>uint32_t</type> <name>dstArrayElement</name></member> <!-- Array element within the destination binding to write --> 605 <member><type>uint32_t</type> <name>descriptorCount</name></member> <!-- Number of descriptors to write (determines the size of the array pointed by pDescriptors) --> 606 <member><type>VkDescriptorType</type> <name>descriptorType</name></member> <!-- Descriptor type to write (determines which members of the array pointed by pDescriptors are going to be used) --> 607 <member noautovalidity="true" len="descriptorCount">const <type>VkDescriptorImageInfo</type>* <name>pImageInfo</name></member> <!-- Sampler, image view, and layout for SAMPLER, COMBINED_IMAGE_SAMPLER, {SAMPLED,STORAGE}_IMAGE, and INPUT_ATTACHMENT descriptor types. --> 608 <member noautovalidity="true" len="descriptorCount">const <type>VkDescriptorBufferInfo</type>* <name>pBufferInfo</name></member> <!-- Raw buffer, size, and offset for {UNIFORM,STORAGE}_BUFFER[_DYNAMIC] descriptor types. --> 609 <member noautovalidity="true" len="descriptorCount">const <type>VkBufferView</type>* <name>pTexelBufferView</name></member> <!-- Buffer view to write to the descriptor for {UNIFORM,STORAGE}_TEXEL_BUFFER descriptor types. --> 610 <validity> 611 <usage>pname:dstBinding must: be a valid binding point within pname:dstSet</usage> 612 <usage>pname:descriptorType must: match the type of pname:dstBinding within pname:dstSet</usage> 613 <usage>The sum of pname:dstArrayElement and pname:descriptorCount must: be less than or equal to the number of array elements in the descriptor set binding specified by pname:dstBinding, and all applicable consecutive bindings, as described by <<descriptorsets-updates-consecutive>></usage> 614 <usage>If pname:descriptorType is ename:VK_DESCRIPTOR_TYPE_SAMPLER, ename:VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER, ename:VK_DESCRIPTOR_TYPE_SAMPLED_IMAGE, ename:VK_DESCRIPTOR_TYPE_STORAGE_IMAGE or ename:VK_DESCRIPTOR_TYPE_INPUT_ATTACHMENT, pname:pImageInfo must: be a pointer to an array of pname:descriptorCount valid sname:VkDescriptorImageInfo structures</usage> 615 <usage>If pname:descriptorType is ename:VK_DESCRIPTOR_TYPE_UNIFORM_TEXEL_BUFFER or ename:VK_DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER, pname:pTexelBufferView must: be a pointer to an array of pname:descriptorCount valid sname:VkBufferView handles</usage> 616 <usage>If pname:descriptorType is ename:VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER, ename:VK_DESCRIPTOR_TYPE_STORAGE_BUFFER, ename:VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER_DYNAMIC or ename:VK_DESCRIPTOR_TYPE_STORAGE_BUFFER_DYNAMIC, pname:pBufferInfo must: be a pointer to an array of pname:descriptorCount valid sname:VkDescriptorBufferInfo structures</usage> 617 <usage>If pname:descriptorType is ename:VK_DESCRIPTOR_TYPE_SAMPLER or ename:VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER, and pname:dstSet was not created with a layout that included immutable samplers for pname:dstBinding with pname:descriptorType, the pname:sampler member of any given element of pname:pImageInfo must: be a valid sname:VkSampler object</usage> 618 <usage>If pname:descriptorType is ename:VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER, ename:VK_DESCRIPTOR_TYPE_SAMPLED_IMAGE, ename:VK_DESCRIPTOR_TYPE_STORAGE_IMAGE or ename:VK_DESCRIPTOR_TYPE_INPUT_ATTACHMENT, the pname:imageView and pname:imageLayout members of any given element of pname:pImageInfo must: be a valid sname:VkImageView and elink:VkImageLayout, respectively</usage> 619 <usage>If pname:descriptorType is ename:VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER or ename:VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER_DYNAMIC, the pname:offset member of any given element of pname:pBufferInfo must: be a multiple of the value of sname:VkPhysicalDeviceLimits::pname:minUniformBufferOffsetAlignment</usage> 620 <usage>If pname:descriptorType is ename:VK_DESCRIPTOR_TYPE_STORAGE_BUFFER or ename:VK_DESCRIPTOR_TYPE_STORAGE_BUFFER_DYNAMIC, the pname:offset member of any given element of pname:pBufferInfo must: be a multiple of the value of sname:VkPhysicalDeviceLimits::pname:minStorageBufferOffsetAlignment</usage> 621 <usage>If pname:descriptorType is ename:VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER or ename:VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER_DYNAMIC, the pname:buffer member of any given element of pname:pBufferInfo must: have been created with ename:VK_BUFFER_USAGE_UNIFORM_BUFFER_BIT set</usage> 622 <usage>If pname:descriptorType is ename:VK_DESCRIPTOR_TYPE_STORAGE_BUFFER or ename:VK_DESCRIPTOR_TYPE_STORAGE_BUFFER_DYNAMIC, the pname:buffer member of any given element of pname:pBufferInfo must: have been created with ename:VK_BUFFER_USAGE_STORAGE_BUFFER_BIT set</usage> 623 <usage>If pname:descriptorType is ename:VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER or ename:VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER_DYNAMIC, the pname:range member of any given element of pname:pBufferInfo must: be less than or equal to the value of sname:VkPhysicalDeviceLimits::pname:maxUniformBufferRange</usage> 624 <usage>If pname:descriptorType is ename:VK_DESCRIPTOR_TYPE_STORAGE_BUFFER or ename:VK_DESCRIPTOR_TYPE_STORAGE_BUFFER_DYNAMIC, the pname:range member of any given element of pname:pBufferInfo must: be less than or equal to the value of sname:VkPhysicalDeviceLimits::pname:maxStorageBufferRange</usage> 625 <usage>If pname:descriptorType is ename:VK_DESCRIPTOR_TYPE_UNIFORM_TEXEL_BUFFER, the sname:VkBuffer that pname:pTexelBufferView was created from must: have been created with ename:VK_BUFFER_USAGE_UNIFORM_TEXEL_BUFFER_BIT set</usage> 626 <usage>If pname:descriptorType is ename:VK_DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER, the sname:VkBuffer that pname:pTexelBufferView was created from must: have been created with ename:VK_BUFFER_USAGE_STORAGE_TEXEL_BUFFER_BIT set</usage> 627 <usage>If pname:descriptorType is ename:VK_DESCRIPTOR_TYPE_STORAGE_IMAGE or ename:VK_DESCRIPTOR_TYPE_INPUT_ATTACHMENT, the pname:imageView must: have been created with identity swizzle</usage> 628 </validity> 629 </type> 630 <type category="struct" name="VkCopyDescriptorSet"> 631 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_COPY_DESCRIPTOR_SET --> 632 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 633 <member><type>VkDescriptorSet</type> <name>srcSet</name></member> <!-- Source descriptor set --> 634 <member><type>uint32_t</type> <name>srcBinding</name></member> <!-- Binding within the source descriptor set to copy from --> 635 <member><type>uint32_t</type> <name>srcArrayElement</name></member> <!-- Array element within the source binding to copy from --> 636 <member><type>VkDescriptorSet</type> <name>dstSet</name></member> <!-- Destination descriptor set --> 637 <member><type>uint32_t</type> <name>dstBinding</name></member> <!-- Binding within the destination descriptor set to copy to --> 638 <member><type>uint32_t</type> <name>dstArrayElement</name></member> <!-- Array element within the destination binding to copy to --> 639 <member><type>uint32_t</type> <name>descriptorCount</name></member> <!-- Number of descriptors to write (determines the size of the array pointed by pDescriptors) --> 640 <validity> 641 <usage>pname:srcBinding must: be a valid binding within pname:srcSet</usage> 642 <usage>The sum of pname:srcArrayElement and pname:descriptorCount must: be less than or equal to the number of array elements in the descriptor set binding specified by pname:srcBinding, and all applicable consecutive bindings, as described by <<descriptorsets-updates-consecutive>></usage> 643 <usage>pname:dstBinding must: be a valid binding within pname:dstSet</usage> 644 <usage>The sum of pname:dstArrayElement and pname:descriptorCount must: be less than or equal to the number of array elements in the descriptor set binding specified by pname:dstBinding, and all applicable consecutive bindings, as described by <<descriptorsets-updates-consecutive>></usage> 645 </validity> 646 </type> 647 <type category="struct" name="VkBufferCreateInfo"> 648 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_BUFFER_CREATE_INFO --> 649 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure. --> 650 <member optional="true"><type>VkBufferCreateFlags</type> <name>flags</name></member> <!-- Buffer creation flags --> 651 <member><type>VkDeviceSize</type> <name>size</name></member> <!-- Specified in bytes --> 652 <member><type>VkBufferUsageFlags</type> <name>usage</name></member> <!-- Buffer usage flags --> 653 <member><type>VkSharingMode</type> <name>sharingMode</name></member> 654 <member optional="true"><type>uint32_t</type> <name>queueFamilyIndexCount</name></member> 655 <member noautovalidity="true" len="queueFamilyIndexCount">const <type>uint32_t</type>* <name>pQueueFamilyIndices</name></member> 656 <validity> 657 <usage>The value of pname:size must: be greater than `0`</usage> 658 <usage>If pname:sharingMode is ename:VK_SHARING_MODE_CONCURRENT, pname:pQueueFamilyIndices must: be a pointer to an array of pname:queueFamilyIndexCount basetype:uint32_t values</usage> 659 <usage>If pname:sharingMode is ename:VK_SHARING_MODE_CONCURRENT, pname:queueFamilyIndexCount must: be greater than `1`</usage> 660 <usage>If the <<features-features-sparseBinding,sparse bindings>> feature is not enabled, pname:flags mustnot: contain ename:VK_BUFFER_CREATE_SPARSE_BINDING_BIT</usage> 661 <usage>If the <<features-features-sparseResidencyBuffer,sparse buffer residency>> feature is not enabled, pname:flags mustnot: contain ename:VK_BUFFER_CREATE_SPARSE_RESIDENCY_BIT</usage> 662 <usage>If the <<features-features-sparseResidencyAliased,sparse aliased residency>> feature is not enabled, pname:flags mustnot: contain ename:VK_BUFFER_CREATE_SPARSE_ALIASED_BIT</usage> 663 <usage>If pname:flags contains ename:VK_BUFFER_CREATE_SPARSE_ALIASED_BIT, it must: also contain at least one of ename:VK_BUFFER_CREATE_SPARSE_BINDING_BIT or ename:VK_BUFFER_CREATE_SPARSE_RESIDENCY_BIT</usage> 664 </validity> 665 </type> 666 <type category="struct" name="VkBufferViewCreateInfo"> 667 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_BUFFER_VIEW_CREATE_INFO --> 668 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure. --> 669 <member optional="true"><type>VkBufferViewCreateFlags</type><name>flags</name></member> <!-- Reserved --> 670 <member><type>VkBuffer</type> <name>buffer</name></member> 671 <member><type>VkFormat</type> <name>format</name></member> <!-- Optionally specifies format of elements --> 672 <member><type>VkDeviceSize</type> <name>offset</name></member> <!-- Specified in bytes --> 673 <member><type>VkDeviceSize</type> <name>range</name></member> <!-- View size specified in bytes --> 674 <validity> 675 <usage>The value of pname:offset must: be a multiple of sname:VkPhysicalDeviceLimits::pname:minTexelBufferOffsetAlignment</usage> 676 <usage>The value of pname:range must: be greater than `0`</usage> 677 <usage>If pname:range is not equal to ename:VK_WHOLE_SIZE, the sum of pname:offset and pname:range must: be less than or equal to the size of pname:buffer</usage> 678 <usage>If pname:range is not equal to ename:VK_WHOLE_SIZE, the value of pname:range must: be a multiple of the element size of pname:format</usage> 679 <usage>The value of pname:range, divided by the size of an element of pname:format, must: be less than or equal to the value of sname:VkPhysicalDeviceLimits::pname:maxTexelBufferElements</usage> 680 <usage>pname:buffer must: have been created with a pname:usage value containing at least one of ename:VK_BUFFER_USAGE_UNIFORM_TEXEL_BUFFER_BIT or ename:VK_BUFFER_USAGE_STORAGE_TEXEL_BUFFER_BIT</usage> 681 <usage>If pname:buffer was created with pname:usage containing ename:VK_BUFFER_USAGE_UNIFORM_TEXEL_BUFFER_BIT, pname:format must: be supported for uniform texel buffers, as specified by the ename:VK_FORMAT_FEATURE_UNIFORM_TEXEL_BUFFER_BIT flag in sname:VkFormatProperties::pname:bufferFeatures returned by fname:vkGetPhysicalDeviceFormatProperties</usage> 682 <usage>If pname:buffer was created with pname:usage containing ename:VK_BUFFER_USAGE_STORAGE_TEXEL_BUFFER_BIT, pname:format must: be supported for storage texel buffers, as specified by the ename:VK_FORMAT_FEATURE_STORAGE_TEXEL_BUFFER_BIT flag in sname:VkFormatProperties::pname:bufferFeatures returned by fname:vkGetPhysicalDeviceFormatProperties</usage> 683 </validity> 684 </type> 685 <type category="struct" name="VkImageSubresource"> 686 <member><type>VkImageAspectFlags</type> <name>aspectMask</name></member> 687 <member><type>uint32_t</type> <name>mipLevel</name></member> 688 <member><type>uint32_t</type> <name>arrayLayer</name></member> 689 <validity> 690 <usage>pname:mipLevel must: be less than the pname:mipLevels specified in slink:VkImageCreateInfo when the image was created</usage> 691 <usage>pname:arrayLayer must: be less than the pname:arrayLayers specified in slink:VkImageCreateInfo when the image was created</usage> 692 </validity> 693 </type> 694 <type category="struct" name="VkImageSubresourceLayers"> 695 <member><type>VkImageAspectFlags</type> <name>aspectMask</name></member> 696 <member><type>uint32_t</type> <name>mipLevel</name></member> 697 <member><type>uint32_t</type> <name>baseArrayLayer</name></member> 698 <member><type>uint32_t</type> <name>layerCount</name></member> 699 <validity> 700 <usage>If pname:aspectMask contains ename:VK_IMAGE_ASPECT_COLOR_BIT, it mustnot: contain either of ename:VK_IMAGE_ASPECT_DEPTH_BIT or ename:VK_IMAGE_ASPECT_STENCIL_BIT</usage> 701 <usage>pname:aspectMask mustnot: contain ename:VK_IMAGE_ASPECT_METADATA_BIT</usage> 702 <usage>pname:mipLevel must: be less than the pname:mipLevels specified in slink:VkImageCreateInfo when the image was created</usage> 703 <usage>latexmath:[$(baseArrayLayer + layerCount)$] must: be less than or equal to the pname:arrayLayers specified in slink:VkImageCreateInfo when the image was created</usage> 704 </validity> 705 </type> 706 <type category="struct" name="VkImageSubresourceRange"> 707 <member><type>VkImageAspectFlags</type> <name>aspectMask</name></member> 708 <member><type>uint32_t</type> <name>baseMipLevel</name></member> 709 <member><type>uint32_t</type> <name>levelCount</name></member> 710 <member><type>uint32_t</type> <name>baseArrayLayer</name></member> 711 <member><type>uint32_t</type> <name>layerCount</name></member> 712 <validity> 713 <usage>latexmath:[$(baseMipLevel + levelCount)$] must: be less than or equal to the pname:mipLevels specified in slink:VkImageCreateInfo when the image was created</usage> 714 <usage>latexmath:[$(baseArrayLayer + layerCount)$] must: be less than or equal to the pname:arrayLayers specified in slink:VkImageCreateInfo when the image was created</usage> 715 </validity> 716 </type> 717 <type category="struct" name="VkMemoryBarrier"> 718 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_MEMORY_BARRIER --> 719 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure. --> 720 <member optional="true"><type>VkAccessFlags</type> <name>srcAccessMask</name></member> <!-- Memory accesses from the source of the dependency to synchronize --> 721 <member optional="true"><type>VkAccessFlags</type> <name>dstAccessMask</name></member> <!-- Memory accesses from the destination of the dependency to synchronize --> 722 </type> 723 <type category="struct" name="VkBufferMemoryBarrier"> 724 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_BUFFER_MEMORY_BARRIER --> 725 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure. --> 726 <member optional="true"><type>VkAccessFlags</type> <name>srcAccessMask</name></member> <!-- Memory accesses from the source of the dependency to synchronize --> 727 <member optional="true"><type>VkAccessFlags</type> <name>dstAccessMask</name></member> <!-- Memory accesses from the destination of the dependency to synchronize --> 728 <member><type>uint32_t</type> <name>srcQueueFamilyIndex</name></member> <!-- Queue family to transition ownership from --> 729 <member><type>uint32_t</type> <name>dstQueueFamilyIndex</name></member> <!-- Queue family to transition ownership to --> 730 <member><type>VkBuffer</type> <name>buffer</name></member> <!-- Buffer to sync --> 731 <member><type>VkDeviceSize</type> <name>offset</name></member> <!-- Offset within the buffer to sync --> 732 <member><type>VkDeviceSize</type> <name>size</name></member> <!-- Amount of bytes to sync --> 733 <validity> 734 <usage>The value of pname:offset must: be less than the size of pname:buffer</usage> 735 <usage>The sum of pname:offset and pname:size must: be less than or equal to than the size of pname:buffer</usage> 736 <usage>If pname:buffer was created with a sharing mode of ename:VK_SHARING_MODE_CONCURRENT, pname:srcQueueFamilyIndex and pname:dstQueueFamilyIndex must: both be VK_QUEUE_FAMILY_IGNORED</usage> 737 <usage>If pname:buffer was created with a sharing mode of ename:VK_SHARING_MODE_EXCLUSIVE, pname:srcQueueFamilyIndex and pname:dstQueueFamilyIndex must: either both be VK_QUEUE_FAMILY_IGNORED, or both be a valid queue family (see <<devsandqueues-queueprops>>)</usage> 738 <usage>If pname:buffer was created with a sharing mode of ename:VK_SHARING_MODE_EXCLUSIVE, and pname:srcQueueFamilyIndex and pname:dstQueueFamilyIndex are valid queue families, at least one of them must: be the same as the family of the queue that will execute this barrier</usage> 739 </validity> 740 </type> 741 <type category="struct" name="VkImageMemoryBarrier"> 742 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_IMAGE_MEMORY_BARRIER --> 743 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure. --> 744 <member optional="true"><type>VkAccessFlags</type> <name>srcAccessMask</name></member> <!-- Memory accesses from the source of the dependency to synchronize --> 745 <member optional="true"><type>VkAccessFlags</type> <name>dstAccessMask</name></member> <!-- Memory accesses from the destination of the dependency to synchronize --> 746 <member><type>VkImageLayout</type> <name>oldLayout</name></member> <!-- Current layout of the image --> 747 <member><type>VkImageLayout</type> <name>newLayout</name></member> <!-- New layout to transition the image to --> 748 <member><type>uint32_t</type> <name>srcQueueFamilyIndex</name></member> <!-- Queue family to transition ownership from --> 749 <member><type>uint32_t</type> <name>dstQueueFamilyIndex</name></member> <!-- Queue family to transition ownership to --> 750 <member><type>VkImage</type> <name>image</name></member> <!-- Image to sync --> 751 <member><type>VkImageSubresourceRange</type> <name>subresourceRange</name></member> <!-- Subresource range to sync --> 752 <validity> 753 <usage>pname:oldLayout must: be ename:VK_IMAGE_LAYOUT_UNDEFINED, ename:VK_IMAGE_LAYOUT_PREINITIALIZED or the current layout of the image region affected by the barrier</usage> 754 <usage>pname:newLayout mustnot: be ename:VK_IMAGE_LAYOUT_UNDEFINED or ename:VK_IMAGE_LAYOUT_PREINITIALIZED</usage> 755 <usage>If pname:image was created with a sharing mode of ename:VK_SHARING_MODE_CONCURRENT, pname:srcQueueFamilyIndex and pname:dstQueueFamilyIndex must: both be VK_QUEUE_FAMILY_IGNORED</usage> 756 <usage>If pname:image was created with a sharing mode of ename:VK_SHARING_MODE_EXCLUSIVE, pname:srcQueueFamilyIndex and pname:dstQueueFamilyIndex must: either both be VK_QUEUE_FAMILY_IGNORED, or both be a valid queue family (see <<devsandqueues-queueprops>>)</usage> 757 <usage>If pname:image was created with a sharing mode of ename:VK_SHARING_MODE_EXCLUSIVE, and pname:srcQueueFamilyIndex and pname:dstQueueFamilyIndex are valid queue families, at least one of them must: be the same as the family of the queue that will execute this barrier</usage> 758 <usage>pname:subresourceRange must: be a valid subresource range for the image (see <<resources-image-views>>)</usage> 759 <usage>If pname:image has a depth/stencil format with both depth and stencil components, then pname:aspectMask member of pname:subresourceRange must: include both ename:VK_IMAGE_ASPECT_DEPTH_BIT and ename:VK_IMAGE_ASPECT_STENCIL_BIT</usage> 760 </validity> 761 </type> 762 <type category="struct" name="VkImageCreateInfo"> 763 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_IMAGE_CREATE_INFO --> 764 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure. --> 765 <member optional="true"><type>VkImageCreateFlags</type> <name>flags</name></member> <!-- Image creation flags --> 766 <member><type>VkImageType</type> <name>imageType</name></member> 767 <member><type>VkFormat</type> <name>format</name></member> 768 <member><type>VkExtent3D</type> <name>extent</name></member> 769 <member><type>uint32_t</type> <name>mipLevels</name></member> 770 <member><type>uint32_t</type> <name>arrayLayers</name></member> 771 <member><type>VkSampleCountFlagBits</type> <name>samples</name></member> 772 <member><type>VkImageTiling</type> <name>tiling</name></member> 773 <member><type>VkImageUsageFlags</type> <name>usage</name></member> <!-- Image usage flags --> 774 <member><type>VkSharingMode</type> <name>sharingMode</name></member> <!-- Cross-queue-family sharing mode --> 775 <member optional="true"><type>uint32_t</type> <name>queueFamilyIndexCount</name></member> <!-- Number of queue families to share across --> 776 <member noautovalidity="true" len="queueFamilyIndexCount">const <type>uint32_t</type>* <name>pQueueFamilyIndices</name></member> <!-- Array of queue family indices to share across --> 777 <member><type>VkImageLayout</type> <name>initialLayout</name></member> <!-- Initial image layout for all subresources --> 778 <validity> 779 <usage>If pname:sharingMode is ename:VK_SHARING_MODE_CONCURRENT, pname:pQueueFamilyIndices must: be a pointer to an array of pname:queueFamilyIndexCount basetype:uint32_t values</usage> 780 <usage>If pname:sharingMode is ename:VK_SHARING_MODE_CONCURRENT, pname:queueFamilyIndexCount must: be greater than `1`</usage> 781 <usage>pname:format mustnot: be ename:VK_FORMAT_UNDEFINED</usage> 782 <usage>The values of the pname:width, pname:height and pname:depth members of pname:extent must: all be greater than `0`</usage> 783 <usage>The value of pname:mipLevels must: be greater than `0`</usage> 784 <usage>The value of pname:arrayLayers must: be greater than `0`</usage> 785 <usage>If pname:imageType is ename:VK_IMAGE_TYPE_1D, the value of pname:extent.width must: be less than or equal to the value of sname:VkPhysicalDeviceLimits::pname:maxImageDimension1D, or the value of sname:VkImageFormatProperties::pname:maxExtent.width (as returned by fname:vkGetPhysicalDeviceImageFormatProperties with values of pname:format, pname:type, pname:tiling, pname:usage and pname:flags equal to those in this structure) - whichever is higher</usage> 786 <usage>If pname:imageType is ename:VK_IMAGE_TYPE_2D and pname:flags does not contain ename:VK_IMAGE_CREATE_CUBE_COMPATIBLE_BIT, the value of pname:extent.width and pname:extent.height must: be less than or equal to the value of sname:VkPhysicalDeviceLimits::pname:maxImageDimension2D, or the value of sname:VkImageFormatProperties::pname:maxExtent.width/height (as returned by fname:vkGetPhysicalDeviceImageFormatProperties with values of pname:format, pname:type, pname:tiling, pname:usage and pname:flags equal to those in this structure) - whichever is higher</usage> 787 <usage>If pname:imageType is ename:VK_IMAGE_TYPE_2D and pname:flags contains ename:VK_IMAGE_CREATE_CUBE_COMPATIBLE_BIT, the value of pname:extent.width and pname:extent.height must: be less than or equal to the value of sname:VkPhysicalDeviceLimits::pname:maxImageDimensionCube, or the value of sname:VkImageFormatProperties::pname:maxExtent.width/height (as returned by fname:vkGetPhysicalDeviceImageFormatProperties with values of pname:format, pname:type, pname:tiling, pname:usage and pname:flags equal to those in this structure) - whichever is higher</usage> 788 <usage>If pname:imageType is ename:VK_IMAGE_TYPE_2D and pname:flags contains ename:VK_IMAGE_CREATE_CUBE_COMPATIBLE_BIT, the value of pname:extent.width and pname:extent.height must: be equal</usage> 789 <usage>If pname:imageType is ename:VK_IMAGE_TYPE_3D, the value of pname:extent.width, pname:extent.height and pname:extent.depth must: be less than or equal to the value of sname:VkPhysicalDeviceLimits::pname:maxImageDimension3D, or the value of sname:VkImageFormatProperties::pname:maxExtent.width/height/depth (as returned by fname:vkGetPhysicalDeviceImageFormatProperties with values of pname:format, pname:type, pname:tiling, pname:usage and pname:flags equal to those in this structure) - whichever is higher</usage> 790 <usage>The value of pname:mipLevels must: be less than or equal to or equal to the value of latexmath:[$\lfloor\log_2(\max(\mathit{extent.width}, \mathit{extent.height}, \mathit{extent.depth}))\rfloor + 1$]</usage> 791 <usage>If the values of any of pname:extent.width, pname:extent.height or pname:extent.depth are greater than the values of the equivalently named members of sname:VkPhysicalDeviceLimits::pname:maxImageDimension3D, pname:mipLevels must: be less than or equal to the value of sname:VkImageFormatProperties::pname:maxMipLevels (as returned by fname:vkGetPhysicalDeviceImageFormatProperties with values of pname:format, pname:type, pname:tiling, pname:usage and pname:flags equal to those in this structure)</usage> 792 <usage>If the values of any of pname:extent.width, pname:extent.height or pname:extent.depth are greater than the values of the equivalently named members of sname:VkPhysicalDeviceLimits::pname:maxImageDimension3D, (pname:extent.width * pname:extent.height * pname:extent.depth) must: be less than or equal to the value of sname:VkImageFormatProperties::pname:maxResourceSize (as returned by flink:vkGetPhysicalDeviceImageFormatProperties with values of pname:format, pname:type, pname:tiling, pname:usage and pname:flags equal to those in this structure)</usage> 793 <usage>The value of pname:arrayLayers must: be less than or equal to the value of sname:VkPhysicalDeviceLimits::pname:maxImageArrayLayers, or the value of sname:VkImageFormatProperties::pname:maxArrayLayers (as returned by fname:vkGetPhysicalDeviceImageFormatProperties with values of pname:format, pname:type, pname:tiling, pname:usage and pname:flags equal to those in this structure) - whichever is higher</usage> 794 <usage>The value of pname:samples must: be a bit value that is set in the value of sname:VkPhysicalDeviceLimits::pname:sampleCounts returned by flink:vkGetPhysicalDeviceProperties, or the value of sname:VkImageFormatProperties::pname:maxExtent.sampleCounts returned by fname:vkGetPhysicalDeviceImageFormatProperties with values of pname:format, pname:type, pname:tiling, pname:usage and pname:flags equal to those in this structure</usage> 795 <usage>If pname:usage includes ename:VK_IMAGE_USAGE_COLOR_ATTACHMENT_BIT, ename:VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT, ename:VK_IMAGE_USAGE_TRANSIENT_ATTACHMENT_BIT or ename:VK_IMAGE_USAGE_INPUT_ATTACHMENT_BIT, the value of pname:extent.width must: be less than or equal to sname:VkPhysicalDeviceLimits::pname:maxFramebufferWidth</usage> 796 <usage>If pname:usage includes ename:VK_IMAGE_USAGE_COLOR_ATTACHMENT_BIT, ename:VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT, ename:VK_IMAGE_USAGE_TRANSIENT_ATTACHMENT_BIT or ename:VK_IMAGE_USAGE_INPUT_ATTACHMENT_BIT, the value of pname:extent.height must: be less than or equal to sname:VkPhysicalDeviceLimits::pname:maxFramebufferHeight</usage> 797 <usage>If pname:usage includes ename:VK_IMAGE_USAGE_COLOR_ATTACHMENT_BIT, the value of pname:samples must: be a bit value that is set in the value of sname:VkPhysicalDeviceLimits::pname:maxFramebufferColorSamples</usage> 798 <usage>If pname:usage includes ename:VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT, and pname:format includes a depth aspect, the value of pname:samples must: be a bit value that is set in the value of sname:VkPhysicalDeviceLimits::pname:maxFramebufferDepthSamples</usage> 799 <usage>If pname:usage includes ename:VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT, and pname:format includes a stencil aspect, the value of pname:samples must: be a bit value that is set in the value of sname:VkPhysicalDeviceLimits::pname:maxFramebufferStencilSamples</usage> 800 <usage>If pname:usage includes ename:VK_IMAGE_USAGE_SAMPLED_BIT, and pname:format includes a color aspect, the value of pname:samples must: be a bit value that is set in the value of sname:VkPhysicalDeviceLimits::pname:maxSampledImageColorSamples</usage> 801 <usage>If pname:usage includes ename:VK_IMAGE_USAGE_SAMPLED_BIT, and pname:format includes a depth aspect, the value of pname:samples must: be a bit value that is set in the value of sname:VkPhysicalDeviceLimits::pname:maxSampledImageDepthSamples</usage> 802 <usage>If pname:usage includes ename:VK_IMAGE_USAGE_SAMPLED_BIT, and pname:format is an integer format, the value of pname:samples must: be a bit value that is set in the value of sname:VkPhysicalDeviceLimits::pname:maxSampledImageIntegerSamples</usage> 803 <usage>If pname:usage includes ename:VK_IMAGE_USAGE_STORAGE_BIT, the value of pname:samples must: be a bit value that is set in the value of sname:VkPhysicalDeviceLimits::pname:maxStorageImageSamples</usage> 804 <usage>If the <<features-features-textureCompressionETC2,ETC2 texture compression>> feature is not enabled, pname:format mustnot: be ename:VK_FORMAT_ETC2_R8G8B8_UNORM_BLOCK, ename:VK_FORMAT_ETC2_R8G8B8_SRGB_BLOCK, ename:VK_FORMAT_ETC2_R8G8B8A1_UNORM_BLOCK, ename:VK_FORMAT_ETC2_R8G8B8A1_SRGB_BLOCK, ename:VK_FORMAT_ETC2_R8G8B8A8_UNORM_BLOCK, ename:VK_FORMAT_ETC2_R8G8B8A8_SRGB_BLOCK, ename:VK_FORMAT_EAC_R11_UNORM_BLOCK, ename:VK_FORMAT_EAC_R11_SNORM_BLOCK, ename:VK_FORMAT_EAC_R11G11_UNORM_BLOCK, or ename:VK_FORMAT_EAC_R11G11_SNORM_BLOCK</usage> 805 <usage>If the <<features-features-textureCompressionASTC_LDR,ASTC LDR texture compression>> feature is not enabled, pname:format mustnot: be ename:VK_FORMAT_ASTC_4x4_UNORM_BLOCK, ename:VK_FORMAT_ASTC_4x4_SRGB_BLOCK, ename:VK_FORMAT_ASTC_5x4_UNORM_BLOCK, ename:VK_FORMAT_ASTC_5x4_SRGB_BLOCK, ename:VK_FORMAT_ASTC_5x5_UNORM_BLOCK, ename:VK_FORMAT_ASTC_5x5_SRGB_BLOCK, ename:VK_FORMAT_ASTC_6x5_UNORM_BLOCK, ename:VK_FORMAT_ASTC_6x5_SRGB_BLOCK, ename:VK_FORMAT_ASTC_6x6_UNORM_BLOCK, ename:VK_FORMAT_ASTC_6x6_SRGB_BLOCK, ename:VK_FORMAT_ASTC_8x5_UNORM_BLOCK, ename:VK_FORMAT_ASTC_8x5_SRGB_BLOCK, ename:VK_FORMAT_ASTC_8x6_UNORM_BLOCK, ename:VK_FORMAT_ASTC_8x6_SRGB_BLOCK, ename:VK_FORMAT_ASTC_8x8_UNORM_BLOCK, ename:VK_FORMAT_ASTC_8x8_SRGB_BLOCK, ename:VK_FORMAT_ASTC_10x5_UNORM_BLOCK, ename:VK_FORMAT_ASTC_10x5_SRGB_BLOCK, ename:VK_FORMAT_ASTC_10x6_UNORM_BLOCK, ename:VK_FORMAT_ASTC_10x6_SRGB_BLOCK, ename:VK_FORMAT_ASTC_10x8_UNORM_BLOCK, ename:VK_FORMAT_ASTC_10x8_SRGB_BLOCK, ename:VK_FORMAT_ASTC_10x10_UNORM_BLOCK, ename:VK_FORMAT_ASTC_10x10_SRGB_BLOCK, ename:VK_FORMAT_ASTC_12x10_UNORM_BLOCK, ename:VK_FORMAT_ASTC_12x10_SRGB_BLOCK, ename:VK_FORMAT_ASTC_12x12_UNORM_BLOCK, or ename:VK_FORMAT_ASTC_12x12_SRGB_BLOCK</usage> 806 <usage>If the <<features-features-textureCompressionBC,BC texture compression>> feature is not enabled, pname:format mustnot: be ename:VK_FORMAT_BC1_RGB_UNORM_BLOCK, ename:VK_FORMAT_BC1_RGB_SRGB_BLOCK, ename:VK_FORMAT_BC1_RGBA_UNORM_BLOCK, ename:VK_FORMAT_BC1_RGBA_SRGB_BLOCK, ename:VK_FORMAT_BC2_UNORM_BLOCK, ename:VK_FORMAT_BC2_SRGB_BLOCK, ename:VK_FORMAT_BC3_UNORM_BLOCK, ename:VK_FORMAT_BC3_SRGB_BLOCK, ename:VK_FORMAT_BC4_UNORM_BLOCK, ename:VK_FORMAT_BC4_SNORM_BLOCK, ename:VK_FORMAT_BC5_UNORM_BLOCK, ename:VK_FORMAT_BC5_SNORM_BLOCK, ename:VK_FORMAT_BC6H_UFLOAT_BLOCK, ename:VK_FORMAT_BC6H_SFLOAT_BLOCK, ename:VK_FORMAT_BC7_UNORM_BLOCK, or ename:VK_FORMAT_BC7_SRGB_BLOCK</usage> 807 <usage>If the <<features-features-shaderStorageImageMultisample,multisampled storage images>> feature is not enabled, and pname:usage contains ename:VK_IMAGE_USAGE_STORAGE_BIT, pname:samples must: be ename:VK_SAMPLE_COUNT_1_BIT</usage> 808 <usage>If the <<features-features-sparseBinding,sparse bindings>> feature is not enabled, pname:flags mustnot: contain ename:VK_IMAGE_CREATE_SPARSE_BINDING_BIT</usage> 809 <usage>If the <<features-features-sparseResidencyImage2D,sparse residency for 2D images>> feature is not enabled, and pname:imageType is VK_IMAGE_TYPE_2D, pname:flags mustnot: contain ename:VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT</usage> 810 <usage>If the <<features-features-sparseResidencyImage3D,sparse residency for 3D images>> feature is not enabled, and pname:imageType is VK_IMAGE_TYPE_3D, pname:flags mustnot: contain ename:VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT</usage> 811 <usage>If the <<features-features-sparseResidency2Samples,sparse residency for images with 2 samples>> feature is not enabled, pname:imageType is VK_IMAGE_TYPE_2D, and pname:samples is ename:VK_SAMPLE_COUNT_2_BIT, pname:flags mustnot: contain ename:VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT</usage> 812 <usage>If the <<features-features-sparseResidency4Samples,sparse residency for images with 4 samples>> feature is not enabled, pname:imageType is VK_IMAGE_TYPE_2D, and pname:samples is ename:VK_SAMPLE_COUNT_4_BIT, pname:flags mustnot: contain ename:VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT</usage> 813 <usage>If the <<features-features-sparseResidency8Samples,sparse residency for images with 8 samples>> feature is not enabled, pname:imageType is VK_IMAGE_TYPE_2D, and pname:samples is ename:VK_SAMPLE_COUNT_8_BIT, pname:flags mustnot: contain ename:VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT</usage> 814 <usage>If the <<features-features-sparseResidency16Samples,sparse residency for images with 16 samples>> feature is not enabled, pname:imageType is VK_IMAGE_TYPE_2D, and pname:samples is ename:VK_SAMPLE_COUNT_16_BIT, pname:flags mustnot: contain ename:VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT</usage> 815 <usage>If the value of pname:tiling is ename:VK_IMAGE_TILING_LINEAR, and the value of sname:VkFormatProperties::pname:linearTilingFeatures (as returned by fname:vkGetPhysicalDeviceFormatProperties with the same value of pname:format) does not include VK_FORMAT_FEATURE_SAMPLED_IMAGE_BIT, pname:usage mustnot: contain ename:VK_IMAGE_USAGE_SAMPLED_BIT</usage> 816 <usage>If the value of pname:tiling is ename:VK_IMAGE_TILING_LINEAR, and the value of sname:VkFormatProperties::pname:linearTilingFeatures (as returned by fname:vkGetPhysicalDeviceFormatProperties with the same value of pname:format) does not include VK_FORMAT_FEATURE_STORAGE_IMAGE_BIT, pname:usage mustnot: contain ename:VK_IMAGE_USAGE_STORAGE_BIT</usage> 817 <usage>If the value of pname:tiling is ename:VK_IMAGE_TILING_LINEAR, and the value of sname:VkFormatProperties::pname:linearTilingFeatures (as returned by fname:vkGetPhysicalDeviceFormatProperties with the same value of pname:format) does not include VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BIT, pname:usage mustnot: contain ename:VK_IMAGE_USAGE_COLOR_ATTACHMENT_BIT</usage> 818 <usage>If the value of pname:tiling is ename:VK_IMAGE_TILING_LINEAR, and the value of sname:VkFormatProperties::pname:linearTilingFeatures (as returned by fname:vkGetPhysicalDeviceFormatProperties with the same value of pname:format) does not include VK_FORMAT_FEATURE_DEPTH_STENCIL_ATTACHMENT_BIT, pname:usage mustnot: contain ename:VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</usage> 819 <usage>If the value of pname:tiling is ename:VK_IMAGE_TILING_OPTIMAL, and the value of sname:VkFormatProperties::pname:optimalTilingFeatures (as returned by fname:vkGetPhysicalDeviceFormatProperties with the same value of pname:format) does not include VK_FORMAT_FEATURE_SAMPLED_IMAGE_BIT, pname:usage mustnot: contain ename:VK_IMAGE_USAGE_SAMPLED_BIT</usage> 820 <usage>If the value of pname:tiling is ename:VK_IMAGE_TILING_OPTIMAL, and the value of sname:VkFormatProperties::pname:optimalTilingFeatures (as returned by fname:vkGetPhysicalDeviceFormatProperties with the same value of pname:format) does not include VK_FORMAT_FEATURE_STORAGE_IMAGE_BIT, pname:usage mustnot: contain ename:VK_IMAGE_USAGE_STORAGE_BIT</usage> 821 <usage>If the value of pname:tiling is ename:VK_IMAGE_TILING_OPTIMAL, and the value of sname:VkFormatProperties::pname:optimalTilingFeatures (as returned by fname:vkGetPhysicalDeviceFormatProperties with the same value of pname:format) does not include VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BIT, pname:usage mustnot: contain ename:VK_IMAGE_USAGE_COLOR_ATTACHMENT_BIT</usage> 822 <usage>If the value of pname:tiling is ename:VK_IMAGE_TILING_OPTIMAL, and the value of sname:VkFormatProperties::pname:optimalTilingFeatures (as returned by fname:vkGetPhysicalDeviceFormatProperties with the same value of pname:format) does not include VK_FORMAT_FEATURE_DEPTH_STENCIL_ATTACHMENT_BIT, pname:usage mustnot: contain ename:VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</usage> 823 <usage>If pname:flags contains ename:VK_IMAGE_CREATE_SPARSE_ALIASED_BIT, it must: also contain at least one of ename:VK_IMAGE_CREATE_SPARSE_BINDING_BIT or ename:VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT</usage> 824 </validity> 825 </type> 826 <type category="struct" name="VkSubresourceLayout"> 827 <member><type>VkDeviceSize</type> <name>offset</name></member> <!-- Specified in bytes --> 828 <member><type>VkDeviceSize</type> <name>size</name></member> <!-- Specified in bytes --> 829 <member><type>VkDeviceSize</type> <name>rowPitch</name></member> <!-- Specified in bytes --> 830 <member><type>VkDeviceSize</type> <name>arrayPitch</name></member> <!-- Specified in bytes --> 831 <member><type>VkDeviceSize</type> <name>depthPitch</name></member> <!-- Specified in bytes --> 832 </type> 833 <type category="struct" name="VkImageViewCreateInfo"> 834 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_IMAGE_VIEW_CREATE_INFO --> 835 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 836 <member optional="true"><type>VkImageViewCreateFlags</type> <name>flags</name></member> <!-- Reserved --> 837 <member><type>VkImage</type> <name>image</name></member> 838 <member><type>VkImageViewType</type> <name>viewType</name></member> 839 <member><type>VkFormat</type> <name>format</name></member> 840 <member><type>VkComponentMapping</type> <name>components</name></member> 841 <member><type>VkImageSubresourceRange</type> <name>subresourceRange</name></member> 842 <validity> 843 <usage>If pname:image was not created with ename:VK_IMAGE_CREATE_CUBE_COMPATIBLE_BIT then pname:viewType mustnot: be ename:VK_IMAGE_VIEW_TYPE_CUBE or ename:VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</usage> 844 <usage>If the <<features-features-imageCubeArray,image cubemap arrays>> feature is not enabled, pname:viewType mustnot: be ename:VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</usage> 845 <usage>If the <<features-features-textureCompressionETC2,ETC2 texture compression>> feature is not enabled, pname:format mustnot: be ename:VK_FORMAT_ETC2_R8G8B8_UNORM_BLOCK, ename:VK_FORMAT_ETC2_R8G8B8_SRGB_BLOCK, ename:VK_FORMAT_ETC2_R8G8B8A1_UNORM_BLOCK, ename:VK_FORMAT_ETC2_R8G8B8A1_SRGB_BLOCK, ename:VK_FORMAT_ETC2_R8G8B8A8_UNORM_BLOCK, ename:VK_FORMAT_ETC2_R8G8B8A8_SRGB_BLOCK, ename:VK_FORMAT_EAC_R11_UNORM_BLOCK, ename:VK_FORMAT_EAC_R11_SNORM_BLOCK, ename:VK_FORMAT_EAC_R11G11_UNORM_BLOCK, or ename:VK_FORMAT_EAC_R11G11_SNORM_BLOCK</usage> 846 <usage>If the <<features-features-textureCompressionASTC_LDR,ASTC LDR texture compression>> feature is not enabled, pname:format mustnot: be ename:VK_FORMAT_ASTC_4x4_UNORM_BLOCK, ename:VK_FORMAT_ASTC_4x4_SRGB_BLOCK, ename:VK_FORMAT_ASTC_5x4_UNORM_BLOCK, ename:VK_FORMAT_ASTC_5x4_SRGB_BLOCK, ename:VK_FORMAT_ASTC_5x5_UNORM_BLOCK, ename:VK_FORMAT_ASTC_5x5_SRGB_BLOCK, ename:VK_FORMAT_ASTC_6x5_UNORM_BLOCK, ename:VK_FORMAT_ASTC_6x5_SRGB_BLOCK, ename:VK_FORMAT_ASTC_6x6_UNORM_BLOCK, ename:VK_FORMAT_ASTC_6x6_SRGB_BLOCK, ename:VK_FORMAT_ASTC_8x5_UNORM_BLOCK, ename:VK_FORMAT_ASTC_8x5_SRGB_BLOCK, ename:VK_FORMAT_ASTC_8x6_UNORM_BLOCK, ename:VK_FORMAT_ASTC_8x6_SRGB_BLOCK, ename:VK_FORMAT_ASTC_8x8_UNORM_BLOCK, ename:VK_FORMAT_ASTC_8x8_SRGB_BLOCK, ename:VK_FORMAT_ASTC_10x5_UNORM_BLOCK, ename:VK_FORMAT_ASTC_10x5_SRGB_BLOCK, ename:VK_FORMAT_ASTC_10x6_UNORM_BLOCK, ename:VK_FORMAT_ASTC_10x6_SRGB_BLOCK, ename:VK_FORMAT_ASTC_10x8_UNORM_BLOCK, ename:VK_FORMAT_ASTC_10x8_SRGB_BLOCK, ename:VK_FORMAT_ASTC_10x10_UNORM_BLOCK, ename:VK_FORMAT_ASTC_10x10_SRGB_BLOCK, ename:VK_FORMAT_ASTC_12x10_UNORM_BLOCK, ename:VK_FORMAT_ASTC_12x10_SRGB_BLOCK, ename:VK_FORMAT_ASTC_12x12_UNORM_BLOCK, or ename:VK_FORMAT_ASTC_12x12_SRGB_BLOCK</usage> 847 <usage>If the <<features-features-textureCompressionBC,BC texture compression>> feature is not enabled, pname:format mustnot: be ename:VK_FORMAT_BC1_RGB_UNORM_BLOCK, ename:VK_FORMAT_BC1_RGB_SRGB_BLOCK, ename:VK_FORMAT_BC1_RGBA_UNORM_BLOCK, ename:VK_FORMAT_BC1_RGBA_SRGB_BLOCK, ename:VK_FORMAT_BC2_UNORM_BLOCK, ename:VK_FORMAT_BC2_SRGB_BLOCK, ename:VK_FORMAT_BC3_UNORM_BLOCK, ename:VK_FORMAT_BC3_SRGB_BLOCK, ename:VK_FORMAT_BC4_UNORM_BLOCK, ename:VK_FORMAT_BC4_SNORM_BLOCK, ename:VK_FORMAT_BC5_UNORM_BLOCK, ename:VK_FORMAT_BC5_SNORM_BLOCK, ename:VK_FORMAT_BC6H_UFLOAT_BLOCK, ename:VK_FORMAT_BC6H_SFLOAT_BLOCK, ename:VK_FORMAT_BC7_UNORM_BLOCK, or ename:VK_FORMAT_BC7_SRGB_BLOCK</usage> 848 <usage>If pname:image was created with ename:VK_IMAGE_TILING_LINEAR and pname:usage containing ename:VK_IMAGE_USAGE_SAMPLED_BIT, pname:format must: be supported for sampled images, as specified by the ename:VK_FORMAT_FEATURE_SAMPLED_IMAGE_BIT flag in sname:VkFormatProperties::pname:linearTilingFeatures returned by fname:vkGetPhysicalDeviceFormatProperties</usage> 849 <usage>If pname:image was created with ename:VK_IMAGE_TILING_LINEAR and pname:usage containing ename:VK_IMAGE_USAGE_STORAGE_BIT, pname:format must: be supported for storage images, as specified by the ename:VK_FORMAT_FEATURE_STORAGE_IMAGE_BIT flag in sname:VkFormatProperties::pname:linearTilingFeatures returned by fname:vkGetPhysicalDeviceFormatProperties</usage> 850 <usage>If pname:image was created with ename:VK_IMAGE_TILING_LINEAR and pname:usage containing ename:VK_IMAGE_USAGE_COLOR_ATTACHMENT_BIT, pname:format must: be supported for color attachments, as specified by the ename:VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BIT flag in sname:VkFormatProperties::pname:linearTilingFeatures returned by fname:vkGetPhysicalDeviceFormatProperties</usage> 851 <usage>If pname:image was created with ename:VK_IMAGE_TILING_LINEAR and pname:usage containing ename:VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT, pname:format must: be supported for depth/stencil attachments, as specified by the ename:VK_FORMAT_FEATURE_DEPTH_STENCIL_ATTACHMENT_BIT flag in sname:VkFormatProperties::pname:linearTilingFeatures (as returned by fname:vkGetPhysicalDeviceFormatProperties</usage> 852 <usage>If pname:image was created with ename:VK_IMAGE_TILING_OPTIMAL and pname:usage containing ename:VK_IMAGE_USAGE_SAMPLED_BIT, pname:format must: be supported for sampled images, as specified by the ename:VK_FORMAT_FEATURE_SAMPLED_IMAGE_BIT flag in sname:VkFormatProperties::pname:optimalTilingFeatures returned by fname:vkGetPhysicalDeviceFormatProperties</usage> 853 <usage>If pname:image was created with ename:VK_IMAGE_TILING_OPTIMAL and pname:usage containing ename:VK_IMAGE_USAGE_STORAGE_BIT, pname:format must: be supported for storage images, as specified by the ename:VK_FORMAT_FEATURE_STORAGE_IMAGE_BIT flag in sname:VkFormatProperties::pname:optimalTilingFeatures returned by fname:vkGetPhysicalDeviceFormatProperties</usage> 854 <usage>If pname:image was created with ename:VK_IMAGE_TILING_OPTIMAL and pname:usage containing ename:VK_IMAGE_USAGE_COLOR_ATTACHMENT_BIT, pname:format must: be supported for color attachments, as specified by the ename:VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BIT flag in sname:VkFormatProperties::pname:optimalTilingFeatures returned by fname:vkGetPhysicalDeviceFormatProperties</usage> 855 <usage>If pname:image was created with ename:VK_IMAGE_TILING_OPTIMAL and pname:usage containing ename:VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT, pname:format must: be supported for depth/stencil attachments, as specified by the ename:VK_FORMAT_FEATURE_DEPTH_STENCIL_ATTACHMENT_BIT flag in sname:VkFormatProperties::pname:optimalTilingFeatures returned by fname:vkGetPhysicalDeviceFormatProperties</usage> 856 <usage>pname:subresourceRange must: be a valid subresource range for pname:image (see <<resources-image-views>>)</usage> 857 <usage>If pname:image was created with the ename:VK_IMAGE_CREATE_MUTABLE_FORMAT_BIT flag, pname:format must: be compatible with the pname:format used to create pname:image, as defined in <<features-formats-compatibility-classes,Format Compatibility Classes>></usage> 858 <usage>If pname:image was not created with the ename:VK_IMAGE_CREATE_MUTABLE_FORMAT_BIT flag, pname:format must: be identical to the pname:format used to create pname:image</usage> 859 <usage>pname:subResourceRange and pname:viewType must: be compatible with the image, as described in the <<resources-image-views-compatibility,table below>></usage> 860 </validity> 861 </type> 862 <type category="struct" name="VkBufferCopy"> 863 <member><type>VkDeviceSize</type> <name>srcOffset</name></member> <!-- Specified in bytes --> 864 <member><type>VkDeviceSize</type> <name>dstOffset</name></member> <!-- Specified in bytes --> 865 <member><type>VkDeviceSize</type> <name>size</name></member> <!-- Specified in bytes --> 866 </type> 867 <type category="struct" name="VkSparseMemoryBind"> 868 <member><type>VkDeviceSize</type> <name>resourceOffset</name></member> <!-- Specified in bytes --> 869 <member><type>VkDeviceSize</type> <name>size</name></member> <!-- Specified in bytes --> 870 <member optional="true"><type>VkDeviceMemory</type> <name>memory</name></member> 871 <member><type>VkDeviceSize</type> <name>memoryOffset</name></member> <!-- Specified in bytes --> 872 <member optional="true"><type>VkSparseMemoryBindFlags</type><name>flags</name></member> <!-- Reserved for future --> 873 <validity> 874 <usage>If pname:memory is not sname:VK_NULL_HANDLE, pname:memory and pname:memoryOffset must: match the memory requirements of the resource, as described in section <<resources-association>></usage> 875 <usage>If pname:memory is not sname:VK_NULL_HANDLE, pname:memory mustnot: have been created with a memory type that reports ename:VK_MEMORY_PROPERTY_LAZILY_ALLOCATED_BIT bit set</usage> 876 <usage>pname:resourceOffset must: be less than the size of the resource</usage> 877 <usage>The sum of pname:resourceOffset and pname:size must: be less than or equal to the size of the resource</usage> 878 <usage>pname:memoryOffset must: be less than the size of pname:memory</usage> 879 <usage>The sum of pname:memoryOffset and pname:size must: be less than or equal to the size of pname:memory</usage> 880 </validity> 881 </type> 882 <type category="struct" name="VkSparseImageMemoryBind"> 883 <member><type>VkImageSubresource</type> <name>subresource</name></member> 884 <member><type>VkOffset3D</type> <name>offset</name></member> 885 <member><type>VkExtent3D</type> <name>extent</name></member> 886 <member optional="true"><type>VkDeviceMemory</type> <name>memory</name></member> 887 <member><type>VkDeviceSize</type> <name>memoryOffset</name></member> <!-- Specified in bytes --> 888 <member optional="true"><type>VkSparseMemoryBindFlags</type><name>flags</name></member> <!-- Reserved for future --> 889 <validity> 890 <usage>If the <<features-features-sparseResidencyAliased,sparse aliased residency>> feature is not enabled, and if any other resources are bound to ranges of pname:memory, the range of pname:memory being bound mustnot: overlap with those bound ranges</usage> 891 <usage>pname:memory and pname:memoryOffset must: match the memory requirements of the calling command's pname:image, as described in section <<resources-association>></usage> 892 <usage>pname:subresource must: be a valid subresource for pname:image (see <<resources-image-views>>)</usage> 893 <usage>pname:offset.x must: be a multiple of the block width (sname:VkSparseImageFormatProperties::pname:imageGranularity.width) of the image</usage> 894 <usage>pname:extent.width must: either be a multiple of the block width of the image, or else pname:extent.width + pname:offset.x must: equal the width of the image subresource</usage> 895 <usage>pname:offset.y must: be a multiple of the block height (sname:VkSparseImageFormatProperties::pname:imageGranularity.height) of the image</usage> 896 <usage>pname:extent.height must: either be a multiple of the block height of the image, or else pname:extent.height + pname:offset.y must: equal the height of the image subresource</usage> 897 <usage>pname:offset.z must: be a multiple of the block depth (sname:VkSparseImageFormatProperties::pname:imageGranularity.depth) of the image</usage> 898 <usage>pname:extent.depth must: either be a multiple of the block depth of the image, or else pname:extent.depth + pname:offset.z must: equal the depth of the image subresource</usage> 899 </validity> 900 </type> 901 <type category="struct" name="VkSparseBufferMemoryBindInfo"> 902 <member><type>VkBuffer</type> <name>buffer</name></member> 903 <member><type>uint32_t</type> <name>bindCount</name></member> 904 <member len="bindCount">const <type>VkSparseMemoryBind</type>* <name>pBinds</name></member> 905 </type> 906 <type category="struct" name="VkSparseImageOpaqueMemoryBindInfo"> 907 <member><type>VkImage</type> <name>image</name></member> 908 <member><type>uint32_t</type> <name>bindCount</name></member> 909 <member len="bindCount">const <type>VkSparseMemoryBind</type>* <name>pBinds</name></member> 910 <validity> 911 <usage>For any given element of pname:pBinds, if the pname:flags member of that element contains ename:VK_SPARSE_MEMORY_BIND_METADATA_BIT, the 'binding range' defined must: be within the mip tail region of the metadata aspect of pname:image</usage> 912 </validity> 913 </type> 914 <type category="struct" name="VkSparseImageMemoryBindInfo"> 915 <member><type>VkImage</type> <name>image</name></member> 916 <member><type>uint32_t</type> <name>bindCount</name></member> 917 <member len="bindCount">const <type>VkSparseImageMemoryBind</type>* <name>pBinds</name></member> 918 </type> 919 <type category="struct" name="VkBindSparseInfo"> 920 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_BIND_SPARSE_INFO --> 921 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure. --> 922 <member optional="true"><type>uint32_t</type> <name>waitSemaphoreCount</name></member> 923 <member len="waitSemaphoreCount">const <type>VkSemaphore</type>* <name>pWaitSemaphores</name></member> 924 <member optional="true"><type>uint32_t</type> <name>bufferBindCount</name></member> 925 <member len="bufferBindCount">const <type>VkSparseBufferMemoryBindInfo</type>* <name>pBufferBinds</name></member> 926 <member optional="true"><type>uint32_t</type> <name>imageOpaqueBindCount</name></member> 927 <member len="imageOpaqueBindCount">const <type>VkSparseImageOpaqueMemoryBindInfo</type>* <name>pImageOpaqueBinds</name></member> 928 <member optional="true"><type>uint32_t</type> <name>imageBindCount</name></member> 929 <member len="imageBindCount">const <type>VkSparseImageMemoryBindInfo</type>* <name>pImageBinds</name></member> 930 <member optional="true"><type>uint32_t</type> <name>signalSemaphoreCount</name></member> 931 <member len="signalSemaphoreCount">const <type>VkSemaphore</type>* <name>pSignalSemaphores</name></member> 932 </type> 933 <type category="struct" name="VkImageCopy"> 934 <member><type>VkImageSubresourceLayers</type> <name>srcSubresource</name></member> 935 <member><type>VkOffset3D</type> <name>srcOffset</name></member> <!-- Specified in pixels for both compressed and uncompressed images --> 936 <member><type>VkImageSubresourceLayers</type> <name>dstSubresource</name></member> 937 <member><type>VkOffset3D</type> <name>dstOffset</name></member> <!-- Specified in pixels for both compressed and uncompressed images --> 938 <member><type>VkExtent3D</type> <name>extent</name></member> <!-- Specified in pixels for both compressed and uncompressed images --> 939 <validity> 940 <usage>The pname:aspectMask member of pname:srcSubresource and pname:dstSubresource must: match</usage> 941 <usage>The pname:layerCount member of pname:srcSubresource and pname:dstSubresource must: match</usage> 942 <usage>If either of the calling command's pname:srcImage or pname:dstImage parameters are of elink:VkImageType ename:VK_IMAGE_TYPE_3D, the pname:baseArrayLayer and pname:layerCount members of both pname:srcSubresource and pname:dstSubresource must: be `0` and `1`, respectively</usage> 943 <usage>The pname:aspectMask member of pname:srcSubresource must: specify aspects present in the calling command's pname:srcImage</usage> 944 <usage>The pname:aspectMask member of pname:dstSubresource must: specify aspects present in the calling command's pname:dstImage</usage> 945 <usage>pname:srcOffset.x and (pname:extent.width + pname:srcOffset.x) must: both be greater than or equal to `0` and less than or equal to the source image subresource width</usage> 946 <usage>pname:srcOffset.y and (pname:extent.height + pname:srcOffset.y) must: both be greater than or equal to `0` and less than or equal to the source image subresource height</usage> 947 <usage>pname:srcOffset.z and (pname:extent.depth + pname:srcOffset.z) must: both be greater than or equal to `0` and less than or equal to the source image subresource depth</usage> 948 <usage>pname:dstOffset.x and (pname:extent.width + pname:dstOffset.x) must: both be greater than or equal to `0` and less than or equal to the destination image subresource width</usage> 949 <usage>pname:dstOffset.y and (pname:extent.height + pname:dstOffset.y) must: both be greater than or equal to `0` and less than or equal to the destination image subresource height</usage> 950 <usage>pname:dstOffset.z and (pname:extent.depth + pname:dstOffset.z) must: both be greater than or equal to `0` and less than or equal to the destination image subresource depth</usage> 951 <usage>If the calling command's pname:srcImage is a compressed format image:</usage> 952 <usage>* all members of pname:srcOffset must: be a multiple of the block size in the relevant dimensions</usage> 953 <usage>* pname:extent.width must: be a multiple of the block width or (pname:extent.width + pname:srcOffset.x) must: equal the source image subresource width</usage> 954 <usage>* pname:extent.height must: be a multiple of the block height or (pname:extent.height + pname:srcOffset.y) must: equal the source image subresource height</usage> 955 <usage>* pname:extent.depth must: be a multiple of the block depth or (pname:extent.depth + pname:srcOffset.z) must: equal the source image subresource depth</usage> 956 <usage>If the calling command's pname:dstImage is a compressed format image:</usage> 957 <usage>* all members of pname:dstOffset must: be a multiple of the block size in the relevant dimensions</usage> 958 <usage>* pname:extent.width must: be a multiple of the block width or (pname:extent.width + pname:dstOffset.x) must: equal the destination image subresource width</usage> 959 <usage>* pname:extent.height must: be a multiple of the block height or (pname:extent.height + pname:dstOffset.y) must: equal the destination image subresource height</usage> 960 <usage>* pname:extent.depth must: be a multiple of the block depth or (pname:extent.depth + pname:dstOffset.z) must: equal the destination image subresource depth</usage> 961 <usage>pname:srcOffset, pname:dstOffset, and pname:extent must: respect the image transfer granularity requirements of the queue family that it will be submitted against, as described in <<execution-physical-device-enumeration,Physical Device Enumeration>></usage> 962 </validity> 963 </type> 964 <type category="struct" name="VkImageBlit"> 965 <member><type>VkImageSubresourceLayers</type> <name>srcSubresource</name></member> 966 <member><type>VkOffset3D</type> <name>srcOffsets[2]</name></member> <!-- Specified in pixels for both compressed and uncompressed images --> 967 <member><type>VkImageSubresourceLayers</type> <name>dstSubresource</name></member> 968 <member><type>VkOffset3D</type> <name>dstOffsets[2]</name></member> <!-- Specified in pixels for both compressed and uncompressed images --> 969 <validity> 970 <usage>The pname:aspectMask member of pname:srcSubresource and pname:dstSubresource must: match</usage> 971 <usage>The pname:layerCount member of pname:srcSubresource and pname:dstSubresource must: match</usage> 972 <usage>If either of the calling command's pname:srcImage or pname:dstImage parameters are of elink:VkImageType ename:VK_IMAGE_TYPE_3D, the pname:baseArrayLayer and pname:layerCount members of both pname:srcSubresource and pname:dstSubresource must: be `0` and `1`, respectively</usage> 973 <usage>The pname:aspectMask member of pname:srcSubresource must: specify aspects present in the calling command's pname:srcImage</usage> 974 <usage>The pname:aspectMask member of pname:dstSubresource must: specify aspects present in the calling command's pname:dstImage</usage> 975 </validity> 976 </type> 977 <type category="struct" name="VkBufferImageCopy"> 978 <member><type>VkDeviceSize</type> <name>bufferOffset</name></member> <!-- Specified in bytes --> 979 <member><type>uint32_t</type> <name>bufferRowLength</name></member> <!-- Specified in texels --> 980 <member><type>uint32_t</type> <name>bufferImageHeight</name></member> 981 <member><type>VkImageSubresourceLayers</type> <name>imageSubresource</name></member> 982 <member><type>VkOffset3D</type> <name>imageOffset</name></member> <!-- Specified in pixels for both compressed and uncompressed images --> 983 <member><type>VkExtent3D</type> <name>imageExtent</name></member> <!-- Specified in pixels for both compressed and uncompressed images --> 984 <validity> 985 <usage>pname:bufferOffset must: be a multiple of the calling command's sname:VkImage parameter's texel size</usage> 986 <usage>pname:bufferOffset must: be a multiple of `4`</usage> 987 <usage>pname:bufferRowLength must: be `0`, or greater than or equal to the pname:width member of pname:imageExtent</usage> 988 <usage>pname:bufferImageHeight must: be `0`, or greater than or equal to the pname:height member of pname:imageExtent</usage> 989 <usage>pname:imageOffset.x and (pname:imageExtent.width + pname:imageOffset.x) must: both be greater than or equal to `0` and less than or equal to the image subresource width</usage> 990 <usage>pname:imageOffset.y and (imageExtent.height + pname:imageOffset.y) must: both be greater than or equal to `0` and less than or equal to the image subresource height</usage> 991 <usage>pname:imageOffset.z and (imageExtent.depth + pname:imageOffset.z) must: both be greater than or equal to `0` and less than or equal to the image subresource depth</usage> 992 <usage>If the calling command's sname:VkImage parameter is a compressed format image:</usage> 993 <usage>* pname:bufferRowLength, pname:bufferImageHeight and all members of pname:imageOffset must: be a multiple of the block size in the relevant dimensions</usage> 994 <usage>* pname:bufferOffset must: be a multiple of the block size in bytes</usage> 995 <usage>* pname:imageExtent.width must: be a multiple of the block width or (pname:imageExtent.width + pname:imageOffset.x) must: equal the image subresource width</usage> 996 <usage>* pname:imageExtent.height must: be a multiple of the block height or (pname:imageExtent.height + pname:imageOffset.y) must: equal the image subresource height</usage> 997 <usage>* pname:imageExtent.depth must: be a multiple of the block depth or (pname:imageExtent.depth + pname:imageOffset.z) must: equal the image subresource depth</usage> 998 <usage>pname:bufferOffset, pname:bufferRowLength, pname:bufferImageHeight and all members of pname:imageOffset and pname:imageExtent must: respect the image transfer granularity requirements of the queue family that it will be submitted against, as described in <<execution-physical-device-enumeration,Physical Device Enumeration>></usage> 999 <usage>The pname:aspectMask member of pname:srcSubresource must: specify aspects present in the calling command's sname:VkImage parameter</usage> 1000 <usage>The pname:aspectMask member of pname:pSubresource must: only have a single bit set</usage> 1001 <usage>If the calling command's sname:VkImage parameter is of elink:VkImageType ename:VK_IMAGE_TYPE_3D, the pname:baseArrayLayer and pname:layerCount members of both pname:srcSubresource and pname:dstSubresource must: be `0` and `1`, respectively</usage> 1002 </validity> 1003 </type> 1004 <type category="struct" name="VkImageResolve"> 1005 <member><type>VkImageSubresourceLayers</type> <name>srcSubresource</name></member> 1006 <member><type>VkOffset3D</type> <name>srcOffset</name></member> 1007 <member><type>VkImageSubresourceLayers</type> <name>dstSubresource</name></member> 1008 <member><type>VkOffset3D</type> <name>dstOffset</name></member> 1009 <member><type>VkExtent3D</type> <name>extent</name></member> 1010 <validity> 1011 <usage>The pname:aspectMask member of pname:srcSubresource and pname:dstSubresource must: only contain ename:VK_IMAGE_ASPECT_COLOR_BIT</usage> 1012 <usage>The pname:layerCount member of pname:srcSubresource and pname:dstSubresource must: match</usage> 1013 <usage>If either of the calling command's pname:srcImage or pname:dstImage parameters are of elink:VkImageType ename:VK_IMAGE_TYPE_3D, the pname:baseArrayLayer and pname:layerCount members of both pname:srcSubresource and pname:dstSubresource must: be `0` and `1`, respectively</usage> 1014 </validity> 1015 </type> 1016 <type category="struct" name="VkShaderModuleCreateInfo"> 1017 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_SHADER_MODULE_CREATE_INFO --> 1018 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 1019 <member optional="true"><type>VkShaderModuleCreateFlags</type> <name>flags</name></member> <!-- Reserved --> 1020 <member><type>size_t</type> <name>codeSize</name></member> <!-- Specified in bytes --> 1021 <member len="codeSize/4">const <type>uint32_t</type>* <name>pCode</name></member> <!-- Binary code of size codeSize --> 1022 <validity> 1023 <usage>pname:codeSize must: be greater than 0</usage> 1024 <usage>pname:codeSize must: be a multiple of 4</usage> 1025 <usage>pname:pCode must: point to valid SPIR-V code, formatted and packed as described by https://www.khronos.org/registry/spir-v/specs/1.0/SPIRV.html[the SPIR-V Specification v1.0]</usage> 1026 <usage>pname:pCode must: adhere to the validation rules described by the <<spirvenv-module-validation, Validation Rules within a Module>> section of the <<spirvenv-capabilities,SPIR-V Environment>> appendix</usage> 1027 <usage>pname:pCode must: declare the code:Shader capability</usage> 1028 <usage>pname:pCode mustnot: declare any capability that is not supported by the API, as described by the <<spirvenv-module-validation, Capabilities>> section of the <<spirvenv-capabilities,SPIR-V Environment>> appendix</usage> 1029 <usage>If pname:pCode declares any of the capabilities that are listed as not required by the implementation, the relevant feature must: be enabled, as listed in the <<spirvenv-capabilities-table,SPIR-V Environment>> appendix</usage> 1030 </validity> 1031 </type> 1032 <type category="struct" name="VkDescriptorSetLayoutBinding"> 1033 <member><type>uint32_t</type> <name>binding</name></member> <!-- Binding number for this entry --> 1034 <member><type>VkDescriptorType</type> <name>descriptorType</name></member> <!-- Type of the descriptors in this binding --> 1035 <member optional="true"><type>uint32_t</type> <name>descriptorCount</name></member> <!-- Number of descriptors in this binding --> 1036 <member noautovalidity="true"><type>VkShaderStageFlags</type> <name>stageFlags</name></member> <!-- Shader stages this binding is visible to --> 1037 <member noautovalidity="true" optional="true" len="descriptorCount">const <type>VkSampler</type>* <name>pImmutableSamplers</name></member> <!-- Immutable samplers (used if descriptor type is SAMPLER or COMBINED_IMAGE_SAMPLER, is either NULL or contains count number of elements) --> 1038 <validity> 1039 <usage>If pname:descriptorType is ename:VK_DESCRIPTOR_TYPE_SAMPLER or ename:VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER, and pname:descriptorCount is not `0` and pname:pImmutableSamplers is not `NULL`, pname:pImmutableSamplers must: be a pointer to an array of pname:descriptorCount valid sname:VkSampler handles</usage> 1040 <usage>If pname:descriptorCount is not `0`, pname:stageFlags must: be a valid combination of elink:VkShaderStageFlagBits values</usage> 1041 </validity> 1042 </type> 1043 <type category="struct" name="VkDescriptorSetLayoutCreateInfo"> 1044 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_DESCRIPTOR_SET_LAYOUT_CREATE_INFO --> 1045 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 1046 <member optional="true"><type>VkDescriptorSetLayoutCreateFlags</type> <name>flags</name></member> <!-- Reserved --> 1047 <member optional="true"><type>uint32_t</type> <name>bindingCount</name></member> <!-- Number of bindings in the descriptor set layout --> 1048 <member len="bindingCount">const <type>VkDescriptorSetLayoutBinding</type>* <name>pBindings</name></member> <!-- Array of descriptor set layout bindings --> 1049 </type> 1050 <type category="struct" name="VkDescriptorPoolSize"> 1051 <member><type>VkDescriptorType</type> <name>type</name></member> 1052 <member><type>uint32_t</type> <name>descriptorCount</name></member> 1053 <validity> 1054 <usage>The value of pname:descriptorCount must: be greater than `0`</usage> 1055 </validity> 1056 </type> 1057 <type category="struct" name="VkDescriptorPoolCreateInfo"> 1058 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_DESCRIPTOR_POOL_CREATE_INFO --> 1059 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 1060 <member optional="true"><type>VkDescriptorPoolCreateFlags</type> <name>flags</name></member> 1061 <member><type>uint32_t</type> <name>maxSets</name></member> 1062 <member><type>uint32_t</type> <name>poolSizeCount</name></member> 1063 <member len="poolSizeCount">const <type>VkDescriptorPoolSize</type>* <name>pPoolSizes</name></member> 1064 <validity> 1065 <usage>The value of pname:maxSets must: be greater than `0`</usage> 1066 </validity> 1067 </type> 1068 <type category="struct" name="VkDescriptorSetAllocateInfo"> 1069 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_DESCRIPTOR_SET_ALLOCATE_INFO --> 1070 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 1071 <member><type>VkDescriptorPool</type> <name>descriptorPool</name></member> 1072 <member><type>uint32_t</type> <name>descriptorSetCount</name></member> 1073 <member len="descriptorSetCount">const <type>VkDescriptorSetLayout</type>* <name>pSetLayouts</name></member> 1074 <validity> 1075 <usage>The value of pname:descriptorSetCount mustnot: be greater than the number of sets that are currently available for allocation in pname:descriptorPool</usage> 1076 </validity> 1077 </type> 1078 <type category="struct" name="VkSpecializationMapEntry"> 1079 <member><type>uint32_t</type> <name>constantID</name></member> <!-- The SpecConstant ID specified in the BIL --> 1080 <member><type>uint32_t</type> <name>offset</name></member> <!-- Offset of the value in the data block --> 1081 <member><type>size_t</type> <name>size</name></member> <!-- Size in bytes of the SpecConstant --> 1082 </type> 1083 <type category="struct" name="VkSpecializationInfo"> 1084 <member optional="true"><type>uint32_t</type> <name>mapEntryCount</name></member> <!-- Number of entries in the map --> 1085 <member len="mapEntryCount">const <type>VkSpecializationMapEntry</type>* <name>pMapEntries</name></member> <!-- Array of map entries --> 1086 <member optional="true"><type>size_t</type> <name>dataSize</name></member> <!-- Size in bytes of pData --> 1087 <member len="dataSize">const <type>void</type>* <name>pData</name></member> <!-- Pointer to SpecConstant data --> 1088 <validity> 1089 <usage>The pname:offset member of any given element of pname:pMapEntries must: be less than pname:dataSize</usage> 1090 <usage>The sum of the pname:offset and pname:size members of any given element of pname:pMapEntries must: be less than or equal to pname:dataSize</usage> 1091 </validity> 1092 </type> 1093 <type category="struct" name="VkPipelineShaderStageCreateInfo"> 1094 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_PIPELINE_SHADER_STAGE_CREATE_INFO --> 1095 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 1096 <member optional="true"><type>VkPipelineShaderStageCreateFlags</type> <name>flags</name></member> <!-- Reserved --> 1097 <member><type>VkShaderStageFlagBits</type> <name>stage</name></member> <!-- Shader stage --> 1098 <member><type>VkShaderModule</type> <name>module</name></member> <!-- Module containing entry point --> 1099 <member len="null-terminated">const <type>char</type>* <name>pName</name></member> <!-- Null-terminated entry point name --> 1100 <member optional="true">const <type>VkSpecializationInfo</type>* <name>pSpecializationInfo</name></member> 1101 <validity> 1102 <usage>If the <<features-features-geometryShader,geometry shaders>> feature is not enabled, pname:stage mustnot: be pname:VK_SHADER_STAGE_GEOMETRY_BIT</usage> 1103 <usage>If the <<features-features-tessellationShader,tessellation shaders>> feature is not enabled, pname:stage mustnot: be pname:VK_SHADER_STAGE_TESSELLATION_CONTROL_BIT or pname:VK_SHADER_STAGE_TESSELLATION_EVALUATION_BIT</usage> 1104 <usage>pname:stage mustnot: be ename:VK_SHADER_STAGE_ALL_GRAPHICS, or ename:VK_SHADER_STAGE_ALL</usage> 1105 <usage>pname:pName must: be the name of an code:OpEntryPoint in pname:module with an execution model that matches pname:stage</usage> 1106 <usage>If the identified entry point includes any variable in its interface that is declared with the code:ClipDistance code:BuiltIn decoration, that variable mustnot: have an array size greater than sname:VkPhysicalDeviceLimits::pname:maxClipDistances</usage> 1107 <usage>If the identified entry point includes any variable in its interface that is declared with the code:CullDistance code:BuiltIn decoration, that variable mustnot: have an array size greater than sname:VkPhysicalDeviceLimits::pname:maxCullDistances</usage> 1108 <usage>If the identified entry point includes any variables in its interface that are declared with the code:ClipDistance or code:CullDistance code:BuiltIn decoration, those variables mustnot: have array sizes which sum to more than sname:VkPhysicalDeviceLimits::pname:maxCombinedClipAndCullDistances</usage> 1109 <usage>If the identified entry point includes any variable in its interface that is declared with the code:SampleMask code:BuiltIn decoration, that variable mustnot: have an array size greater than sname:VkPhysicalDeviceLimits::pname:maxSampleMaskWords</usage> 1110 <usage>If pname:stage is ename:VK_SHADER_STAGE_VERTEX_BIT, the identified entry point mustnot: include any input variable in its interface that is decorated with code:CullDistance</usage> 1111 <usage>If pname:stage is ename:VK_SHADER_STAGE_TESSELLATION_CONTROL_BIT or ename:VK_SHADER_STAGE_TESSELLATION_EVALUATION_BIT, and the identified entry point has an code:OpExecutionMode instruction that specifies a patch size with code:OutputVertices, the patch size must: be greater than `0` and less than or equal to sname:VkPhysicalDeviceLimits::pname:maxTessellationPatchSize</usage> 1112 <usage>If pname:stage is ename:VK_SHADER_STAGE_GEOMETRY_BIT, the identified entry point must: have an code:OpExecutionMode instruction that specifies a maximum output vertex count that is greater than `0` and less than or equal to sname:VkPhysicalDeviceLimits::pname:maxGeometryOutputVertices</usage> 1113 <usage>If pname:stage is ename:VK_SHADER_STAGE_GEOMETRY_BIT, the identified entry point must: have an code:OpExecutionMode instruction that specifies an invocation count that is greater than `0` and less than or equal to sname:VkPhysicalDeviceLimits::pname:maxGeometryShaderInvocations</usage> 1114 <usage>If pname:stage is ename:VK_SHADER_STAGE_GEOMETRY_BIT, and the identified entry point writes to code:Layer for any primitive, it must: write the same value to code:Layer for all vertices of a given primitive</usage> 1115 <usage>If pname:stage is ename:VK_SHADER_STAGE_GEOMETRY_BIT, and the identified entry point writes to code:ViewportIndex for any primitive, it must: write the same value to code:ViewportIndex for all vertices of a given primitive</usage> 1116 <usage>If pname:stage is ename:VK_SHADER_STAGE_FRAGMENT_BIT, the identified entry point mustnot: include any output variables in its interface decorated with code:CullDistance</usage> 1117 <usage>If pname:stage is ename:VK_SHADER_STAGE_FRAGMENT_BIT, and the identified entry point writes to code:FragDepth in any execution path, it must: write to code:FragDepth in all execution paths</usage> 1118 </validity> 1119 </type> 1120 <type category="struct" name="VkComputePipelineCreateInfo"> 1121 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_COMPUTE_PIPELINE_CREATE_INFO --> 1122 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 1123 <member optional="true"><type>VkPipelineCreateFlags</type> <name>flags</name></member> <!-- Pipeline creation flags --> 1124 <member><type>VkPipelineShaderStageCreateInfo</type> <name>stage</name></member> 1125 <member><type>VkPipelineLayout</type> <name>layout</name></member> <!-- Interface layout of the pipeline --> 1126 <member noautovalidity="true" optional="true"><type>VkPipeline</type> <name>basePipelineHandle</name></member> <!-- If VK_PIPELINE_CREATE_DERIVATIVE_BIT is set and this value is nonzero, it specifies the handle of the base pipeline this is a derivative of --> 1127 <member><type>int32_t</type> <name>basePipelineIndex</name></member> <!-- If VK_PIPELINE_CREATE_DERIVATIVE_BIT is set and this value is not -1, it specifies an index into pCreateInfos of the base pipeline this is a derivative of --> 1128 <validity> 1129 <usage>If pname:flags contains the ename:VK_PIPELINE_CREATE_DERIVATIVE_BIT flag, and pname:basePipelineIndex is not `-1`, pname:basePipelineHandle must: be sname:VK_NULL_HANDLE</usage> 1130 <usage>If pname:flags contains the ename:VK_PIPELINE_CREATE_DERIVATIVE_BIT flag, and pname:basePipelineIndex is not `-1`, it must: be a valid index into the calling command's pname:pCreateInfos parameter</usage> 1131 <usage>If pname:flags contains the ename:VK_PIPELINE_CREATE_DERIVATIVE_BIT flag, and pname:basePipelineHandle is not sname:VK_NULL_HANDLE, pname:basePipelineIndex must: be `-1`</usage> 1132 <usage>If pname:flags contains the ename:VK_PIPELINE_CREATE_DERIVATIVE_BIT flag, and pname:basePipelineHandle is not sname:VK_NULL_HANDLE, pname:basePipelineHandle must: be a valid sname:VkPipeline handle</usage> 1133 <usage>If pname:flags contains the ename:VK_PIPELINE_CREATE_DERIVATIVE_BIT flag, and pname:basePipelineHandle is not sname:VK_NULL_HANDLE, it must: be a valid handle to a compute sname:VkPipeline</usage> 1134 <usage>The pname:stage member of pname:stage must: be ename:VK_SHADER_STAGE_COMPUTE_BIT</usage> 1135 <usage>The shader code for the entry point identified by pname:stage and the rest of the state identified by this structure must: adhere to the pipeline linking rules described in the <<interfaces,Shader Interfaces>> chapter</usage> 1136 <usage>pname:layout must: be <<descriptorsets-pipelinelayout-consistency,consistent>> with all shaders specified in pname:pStages</usage> 1137 </validity> 1138 </type> 1139 <type category="struct" name="VkVertexInputBindingDescription"> 1140 <member><type>uint32_t</type> <name>binding</name></member> <!-- Vertex buffer binding id --> 1141 <member><type>uint32_t</type> <name>stride</name></member> <!-- Distance between vertices in bytes (0 = no advancement) --> 1142 <member><type>VkVertexInputRate</type> <name>inputRate</name></member> <!-- The rate at which the vertex data is consumed --> 1143 <validity> 1144 <usage>pname:binding must: be less than or equal to sname:VkPhysicalDeviceLimits::pname:maxVertexInputBindings</usage> 1145 <usage>pname:stride must: be less than or equal to sname:VkPhysicalDeviceLimits::pname:maxVertexInputBindingStride</usage> 1146 </validity> 1147 </type> 1148 <type category="struct" name="VkVertexInputAttributeDescription"> 1149 <member><type>uint32_t</type> <name>location</name></member> <!-- location of the shader vertex attrib --> 1150 <member><type>uint32_t</type> <name>binding</name></member> <!-- Vertex buffer binding id --> 1151 <member><type>VkFormat</type> <name>format</name></member> <!-- format of source data --> 1152 <member><type>uint32_t</type> <name>offset</name></member> <!-- Offset of first element in bytes from base of vertex --> 1153 <validity> 1154 <usage>pname:binding must: be less than sname:VkPhysicalDeviceLimits::pname:maxVertexInputBindings</usage> 1155 <usage>pname:offset must: be less than or equal to sname:VkPhysicalDeviceLimits::pname:maxVertexInputAttributeOffset</usage> 1156 <usage>pname:format must: be allowed as a vertex buffer format, as specified by the ename:VK_FORMAT_FEATURE_VERTEX_BUFFER_BIT flag in sname:VkFormatProperties::pname:bufferFeatures returned by fname:vkGetPhysicalDeviceFormatProperties</usage> 1157 </validity> 1158 </type> 1159 <type category="struct" name="VkPipelineVertexInputStateCreateInfo"> 1160 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Should be VK_STRUCTURE_TYPE_PIPELINE_VERTEX_INPUT_STATE_CREATE_INFO --> 1161 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 1162 <member optional="true"><type>VkPipelineVertexInputStateCreateFlags</type> <name>flags</name></member> <!-- Reserved --> 1163 <member optional="true"><type>uint32_t</type> <name>vertexBindingDescriptionCount</name></member> <!-- number of bindings --> 1164 <member len="vertexBindingDescriptionCount">const <type>VkVertexInputBindingDescription</type>* <name>pVertexBindingDescriptions</name></member> 1165 <member optional="true"><type>uint32_t</type> <name>vertexAttributeDescriptionCount</name></member> <!-- number of attributes --> 1166 <member len="vertexAttributeDescriptionCount">const <type>VkVertexInputAttributeDescription</type>* <name>pVertexAttributeDescriptions</name></member> 1167 <validity> 1168 <usage>pname:vertexBindingDescriptionCount must: be less than or equal to sname:VkPhysicalDeviceLimits::pname:maxVertexInputBindings</usage> 1169 <usage>pname:vertexAttributeDescriptionCount must: be less than or equal to sname:VkPhysicalDeviceLimits::pname:maxVertexInputAttributes</usage> 1170 <usage>For every value of pname:binding specified by any given element of pname:pVertexAttributeDescriptions, a sname:VkVertexInputBindingDescription must: exist in pname:pVertexBindingDescriptions with the same value of pname:binding</usage> 1171 <usage>All elements of pname:pVertexBindingDescriptions must: describe distinct binding numbers</usage> 1172 <usage>All elements of pname:pVertexAttributeDescriptions must: describe distinct attribute locations</usage> 1173 1174 </validity> 1175 </type> 1176 <type category="struct" name="VkPipelineInputAssemblyStateCreateInfo"> 1177 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_PIPELINE_INPUT_ASSEMBLY_STATE_CREATE_INFO --> 1178 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 1179 <member optional="true"><type>VkPipelineInputAssemblyStateCreateFlags</type> <name>flags</name></member> <!-- Reserved --> 1180 <member><type>VkPrimitiveTopology</type> <name>topology</name></member> 1181 <member><type>VkBool32</type> <name>primitiveRestartEnable</name></member> 1182 <validity> 1183 <usage>If pname:topology is ename:VK_PRIMITIVE_TOPOLOGY_POINT_LIST, ename:VK_PRIMITIVE_TOPOLOGY_LINE_LIST, ename:VK_PRIMITIVE_TOPOLOGY_TRIANGLE_LIST, ename:VK_PRIMITIVE_TOPOLOGY_LINE_LIST_WITH_ADJACENCY, ename:VK_PRIMITIVE_TOPOLOGY_TRIANGLE_LIST_WITH_ADJACENCY or ename:VK_PRIMITIVE_TOPOLOGY_PATCH_LIST, the value of pname:primitiveRestartEnable must: be ename:VK_FALSE</usage> 1184 <usage>If the <<features-features-geometryShader,geometry shaders>> feature is not enabled, pname:topology mustnot: be any of ename:VK_PRIMITIVE_TOPOLOGY_LINE_LIST_WITH_ADJACENCY, ename:VK_PRIMITIVE_TOPOLOGY_LINE_STRIP_WITH_ADJACENCY, ename:VK_PRIMITIVE_TOPOLOGY_TRIANGLE_LIST_WITH_ADJACENCY or ename:VK_PRIMITIVE_TOPOLOGY_TRIANGLE_STRIP_WITH_ADJACENCY</usage> 1185 <usage>If the <<features-features-tessellationShader,tessellation shaders>> feature is not enabled, pname:topology mustnot: be VK_PRIMITIVE_TOPOLOGY_PATCH_LIST</usage> 1186 </validity> 1187 </type> 1188 <type category="struct" name="VkPipelineTessellationStateCreateInfo"> 1189 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_PIPELINE_TESSELLATION_STATE_CREATE_INFO --> 1190 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 1191 <member optional="true"><type>VkPipelineTessellationStateCreateFlags</type> <name>flags</name></member> <!-- Reserved --> 1192 <member><type>uint32_t</type> <name>patchControlPoints</name></member> 1193 <validity> 1194 <usage>pname:patchControlPoints must: be greater than zero and less than or equal to sname:VkPhysicalDeviceLimits::pname:maxTessellationPatchSize</usage> 1195 </validity> 1196 </type> 1197 <type category="struct" name="VkPipelineViewportStateCreateInfo"> 1198 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_PIPELINE_VIEWPORT_STATE_CREATE_INFO --> 1199 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 1200 <member optional="true"><type>VkPipelineViewportStateCreateFlags</type> <name>flags</name></member> <!-- Reserved --> 1201 <member><type>uint32_t</type> <name>viewportCount</name></member> 1202 <member noautovalidity="true" optional="true" len="viewportCount">const <type>VkViewport</type>* <name>pViewports</name></member> 1203 <member><type>uint32_t</type> <name>scissorCount</name></member> 1204 <member noautovalidity="true" optional="true" len="scissorCount">const <type>VkRect2D</type>* <name>pScissors</name></member> 1205 <validity> 1206 <usage>If the <<features-features-multiViewport,multiple viewports>> feature is not enabled, pname:viewportCount must: be `1`</usage> 1207 <usage>If the <<features-features-multiViewport,multiple viewports>> feature is not enabled, pname:scissorCount must: be `1`</usage> 1208 <usage>pname:viewportCount must: be between `1` and sname:VkPhysicalDeviceLimits::pname:maxViewports, inclusive</usage> 1209 <usage>pname:scissorCount must: be between `1` and sname:VkPhysicalDeviceLimits::pname:maxViewports, inclusive</usage> 1210 <usage>The values of pname:scissorCount and pname:viewportCount must: be identical</usage> 1211 </validity> 1212 </type> 1213 <type category="struct" name="VkPipelineRasterizationStateCreateInfo"> 1214 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_PIPELINE_RASTERIZATION_STATE_CREATE_INFO --> 1215 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 1216 <member optional="true"><type>VkPipelineRasterizationStateCreateFlags</type> <name>flags</name></member> <!-- Reserved --> 1217 <member><type>VkBool32</type> <name>depthClampEnable</name></member> 1218 <member><type>VkBool32</type> <name>rasterizerDiscardEnable</name></member> 1219 <member><type>VkPolygonMode</type> <name>polygonMode</name></member> <!-- optional (GL45) --> 1220 <member optional="true"><type>VkCullModeFlags</type> <name>cullMode</name></member> 1221 <member><type>VkFrontFace</type> <name>frontFace</name></member> 1222 <member><type>VkBool32</type> <name>depthBiasEnable</name></member> 1223 <member><type>float</type> <name>depthBiasConstantFactor</name></member> 1224 <member><type>float</type> <name>depthBiasClamp</name></member> 1225 <member><type>float</type> <name>depthBiasSlopeFactor</name></member> 1226 <member><type>float</type> <name>lineWidth</name></member> 1227 <validity> 1228 <usage>If the <<features-features-depthClamp,depth clamping>> feature is not enabled, the value of pname:depthClampEnable must: be ename:VK_FALSE</usage> 1229 <usage>If the <<features-features-fillModeNonSolid,non-solid fill modes>> feature is not enabled, the value of pname:fillMode must: be ename:VK_POLYGON_MODE_FILL</usage> 1230 </validity> 1231 </type> 1232 <type category="struct" name="VkPipelineMultisampleStateCreateInfo"> 1233 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_PIPELINE_MULTISAMPLE_STATE_CREATE_INFO --> 1234 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 1235 <member optional="true"><type>VkPipelineMultisampleStateCreateFlags</type> <name>flags</name></member> <!-- Reserved --> 1236 <member><type>VkSampleCountFlagBits</type> <name>rasterizationSamples</name></member> <!-- Number of samples used for rasterization --> 1237 <member><type>VkBool32</type> <name>sampleShadingEnable</name></member> <!-- optional (GL45) --> 1238 <member><type>float</type> <name>minSampleShading</name></member> <!-- optional (GL45) --> 1239 <member optional="true" len="latexmath:[$\lceil{\mathit{rasterizationSamples} \over 32}\rceil$]">const <type>VkSampleMask</type>* <name>pSampleMask</name></member> <!-- Array of sampleMask words, containing ceil(rasterSamples/32) words --> 1240 <member><type>VkBool32</type> <name>alphaToCoverageEnable</name></member> 1241 <member><type>VkBool32</type> <name>alphaToOneEnable</name></member> 1242 <validity> 1243 <usage>If the <<features-features-sampleRateShading,sample rate shading>> feature is not enabled, pname:sampleShadingEnable must: be ename:VK_FALSE</usage> 1244 <usage>If the <<features-features-alphaToOne,alpha to one>> feature is not enabled, pname:alphaToOneEnable must: be ename:VK_FALSE</usage> 1245 </validity> 1246 </type> 1247 <type category="struct" name="VkPipelineColorBlendAttachmentState"> 1248 <member><type>VkBool32</type> <name>blendEnable</name></member> 1249 <member><type>VkBlendFactor</type> <name>srcColorBlendFactor</name></member> 1250 <member><type>VkBlendFactor</type> <name>dstColorBlendFactor</name></member> 1251 <member><type>VkBlendOp</type> <name>colorBlendOp</name></member> 1252 <member><type>VkBlendFactor</type> <name>srcAlphaBlendFactor</name></member> 1253 <member><type>VkBlendFactor</type> <name>dstAlphaBlendFactor</name></member> 1254 <member><type>VkBlendOp</type> <name>alphaBlendOp</name></member> 1255 <member optional="true"><type>VkColorComponentFlags</type> <name>colorWriteMask</name></member> 1256 <validity> 1257 <usage>If the <<features-features-dualSrcBlend,dual source blending>> feature is not enabled, pname:srcColorBlendFactor mustnot: be pname:VK_BLEND_SRC1_COLOR, pname:VK_BLEND_ONE_MINUS_SRC1_COLOR, pname:VK_BLEND_SRC1_ALPHA, or pname:VK_BLEND_ONE_MINUS_SRC1_ALPHA</usage> 1258 <usage>If the <<features-features-dualSrcBlend,dual source blending>> feature is not enabled, pname:dstColorBlendFactor mustnot: be pname:VK_BLEND_SRC1_COLOR, pname:VK_BLEND_ONE_MINUS_SRC1_COLOR, pname:VK_BLEND_SRC1_ALPHA, or pname:VK_BLEND_ONE_MINUS_SRC1_ALPHA</usage> 1259 <usage>If the <<features-features-dualSrcBlend,dual source blending>> feature is not enabled, pname:srcAlphaBlendFactor mustnot: be pname:VK_BLEND_SRC1_COLOR, pname:VK_BLEND_ONE_MINUS_SRC1_COLOR, pname:VK_BLEND_SRC1_ALPHA, or pname:VK_BLEND_ONE_MINUS_SRC1_ALPHA</usage> 1260 <usage>If the <<features-features-dualSrcBlend,dual source blending>> feature is not enabled, pname:dstAlphaBlendFactor mustnot: be pname:VK_BLEND_SRC1_COLOR, pname:VK_BLEND_ONE_MINUS_SRC1_COLOR, pname:VK_BLEND_SRC1_ALPHA, or pname:VK_BLEND_ONE_MINUS_SRC1_ALPHA</usage> 1261 </validity> 1262 </type> 1263 <type category="struct" name="VkPipelineColorBlendStateCreateInfo"> 1264 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_PIPELINE_COLOR_BLEND_STATE_CREATE_INFO --> 1265 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 1266 <member optional="true"><type>VkPipelineColorBlendStateCreateFlags</type> <name>flags</name></member> <!-- Reserved --> 1267 <member><type>VkBool32</type> <name>logicOpEnable</name></member> 1268 <member noautovalidity="true"><type>VkLogicOp</type> <name>logicOp</name></member> 1269 <member optional="true"><type>uint32_t</type> <name>attachmentCount</name></member> <!-- # of pAttachments --> 1270 <member len="attachmentCount">const <type>VkPipelineColorBlendAttachmentState</type>* <name>pAttachments</name></member> 1271 <member><type>float</type> <name>blendConstants</name>[4]</member> 1272 <validity> 1273 <usage>If the <<features-features-independentBlend,independent blending>> feature is not enabled, all elements of pname:pAttachments must: be identical</usage> 1274 <usage>If the <<features-features-logicOp,logic operations>> feature is not enabled, pname:logicOpEnable must: be ename:VK_FALSE</usage> 1275 <usage>If pname:logicOpEnable is ename:VK_TRUE, pname:logicOp must: be a valid elink:VkLogicOp value</usage> 1276 </validity> 1277 </type> 1278 <type category="struct" name="VkPipelineDynamicStateCreateInfo"> 1279 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_PIPELINE_DYNAMIC_STATE_CREATE_INFO --> 1280 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 1281 <member optional="true"><type>VkPipelineDynamicStateCreateFlags</type> <name>flags</name></member> <!-- Reserved --> 1282 <member><type>uint32_t</type> <name>dynamicStateCount</name></member> 1283 <member len="dynamicStateCount">const <type>VkDynamicState</type>* <name>pDynamicStates</name></member> 1284 </type> 1285 <type category="struct" name="VkStencilOpState"> 1286 <member><type>VkStencilOp</type> <name>failOp</name></member> 1287 <member><type>VkStencilOp</type> <name>passOp</name></member> 1288 <member><type>VkStencilOp</type> <name>depthFailOp</name></member> 1289 <member><type>VkCompareOp</type> <name>compareOp</name></member> 1290 <member><type>uint32_t</type> <name>compareMask</name></member> 1291 <member><type>uint32_t</type> <name>writeMask</name></member> 1292 <member><type>uint32_t</type> <name>reference</name></member> 1293 </type> 1294 <type category="struct" name="VkPipelineDepthStencilStateCreateInfo"> 1295 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_PIPELINE_DEPTH_STENCIL_STATE_CREATE_INFO --> 1296 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 1297 <member optional="true"><type>VkPipelineDepthStencilStateCreateFlags</type> <name>flags</name></member> <!-- Reserved --> 1298 <member><type>VkBool32</type> <name>depthTestEnable</name></member> 1299 <member><type>VkBool32</type> <name>depthWriteEnable</name></member> 1300 <member><type>VkCompareOp</type> <name>depthCompareOp</name></member> 1301 <member><type>VkBool32</type> <name>depthBoundsTestEnable</name></member> <!-- optional (depth_bounds_test) --> 1302 <member><type>VkBool32</type> <name>stencilTestEnable</name></member> 1303 <member><type>VkStencilOpState</type> <name>front</name></member> 1304 <member><type>VkStencilOpState</type> <name>back</name></member> 1305 <member><type>float</type> <name>minDepthBounds</name></member> 1306 <member><type>float</type> <name>maxDepthBounds</name></member> 1307 <validity> 1308 <usage>If the <<features-features-depthBounds,depth bounds testing>> feature is not enabled, the value of pname:depthBoundsTestEnable must: be ename:VK_FALSE</usage> 1309 </validity> 1310 </type> 1311 <type category="struct" name="VkGraphicsPipelineCreateInfo"> 1312 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_GRAPHICS_PIPELINE_CREATE_INFO --> 1313 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 1314 <member optional="true"><type>VkPipelineCreateFlags</type> <name>flags</name></member> <!-- Pipeline creation flags --> 1315 <member><type>uint32_t</type> <name>stageCount</name></member> 1316 <member len="stageCount">const <type>VkPipelineShaderStageCreateInfo</type>* <name>pStages</name></member> <!-- One entry for each active shader stage --> 1317 <member>const <type>VkPipelineVertexInputStateCreateInfo</type>* <name>pVertexInputState</name></member> 1318 <member>const <type>VkPipelineInputAssemblyStateCreateInfo</type>* <name>pInputAssemblyState</name></member> 1319 <member noautovalidity="true" optional="true">const <type>VkPipelineTessellationStateCreateInfo</type>* <name>pTessellationState</name></member> 1320 <member noautovalidity="true" optional="true">const <type>VkPipelineViewportStateCreateInfo</type>* <name>pViewportState</name></member> 1321 <member>const <type>VkPipelineRasterizationStateCreateInfo</type>* <name>pRasterizationState</name></member> 1322 <member noautovalidity="true" optional="true">const <type>VkPipelineMultisampleStateCreateInfo</type>* <name>pMultisampleState</name></member> 1323 <member noautovalidity="true" optional="true">const <type>VkPipelineDepthStencilStateCreateInfo</type>* <name>pDepthStencilState</name></member> 1324 <member noautovalidity="true" optional="true">const <type>VkPipelineColorBlendStateCreateInfo</type>* <name>pColorBlendState</name></member> 1325 <member optional="true">const <type>VkPipelineDynamicStateCreateInfo</type>* <name>pDynamicState</name></member> 1326 <member><type>VkPipelineLayout</type> <name>layout</name></member> <!-- Interface layout of the pipeline --> 1327 <member><type>VkRenderPass</type> <name>renderPass</name></member> 1328 <member><type>uint32_t</type> <name>subpass</name></member> 1329 <member noautovalidity="true" optional="true"><type>VkPipeline</type> <name>basePipelineHandle</name></member> <!-- If VK_PIPELINE_CREATE_DERIVATIVE_BIT is set and this value is nonzero, it specifies the handle of the base pipeline this is a derivative of --> 1330 <member><type>int32_t</type> <name>basePipelineIndex</name></member> <!-- If VK_PIPELINE_CREATE_DERIVATIVE_BIT is set and this value is not -1, it specifies an index into pCreateInfos of the base pipeline this is a derivative of --> 1331 <validity> 1332 <usage>If pname:flags contains the ename:VK_PIPELINE_CREATE_DERIVATIVE_BIT flag, and pname:basePipelineIndex is not `-1`, pname:basePipelineHandle must: be sname:VK_NULL_HANDLE</usage> 1333 <usage>If pname:flags contains the ename:VK_PIPELINE_CREATE_DERIVATIVE_BIT flag, and pname:basePipelineIndex is not `-1`, it must: be a valid index into the calling command's pname:pCreateInfos parameter</usage> 1334 <usage>If pname:flags contains the ename:VK_PIPELINE_CREATE_DERIVATIVE_BIT flag, and pname:basePipelineHandle is not sname:VK_NULL_HANDLE, pname:basePipelineIndex must: be `-1`</usage> 1335 <usage>If pname:flags contains the ename:VK_PIPELINE_CREATE_DERIVATIVE_BIT flag, and pname:basePipelineHandle is not sname:VK_NULL_HANDLE, pname:basePipelineHandle must: be a valid sname:VkPipeline handle</usage> 1336 <usage>If pname:flags contains the ename:VK_PIPELINE_CREATE_DERIVATIVE_BIT flag, and pname:basePipelineHandle is not sname:VK_NULL_HANDLE, it must: be a valid handle to a graphics sname:VkPipeline</usage> 1337 <usage>pname:stageCount must: be greater than or equal to `1`</usage> 1338 <usage>The pname:stage member of each element of pname:pStages must: be unique</usage> 1339 <usage>The pname:stage member of one element of pname:pStages must: be ename:VK_SHADER_STAGE_VERTEX_BIT</usage> 1340 <usage>The pname:stage member of any given element of pname:pStages mustnot: be ename:VK_SHADER_STAGE_COMPUTE_BIT</usage> 1341 <usage>If pname:pStages includes a tessellation control shader stage, it must: include a tessellation evaluation shader stage</usage> 1342 <usage>If pname:pStages includes a tessellation evaluation shader stage, it must: include a tessellation control shader stage</usage> 1343 <usage>If pname:pStages includes a tessellation control shader stage and a tessellation evaluation shader stage, pname:pTessellationState mustnot: be `NULL`</usage> 1344 <usage>If pname:pStages includes both a tessellation control shader stage and a tessellation evaluation shader stage, the shader code of at least one must: contain an code:OpExecutionMode instruction that specifies the type of subdivision in the pipeline</usage> 1345 <usage>If pname:pStages includes both a tessellation control shader stage and a tessellation evaluation shader stage, and the shader code of both contain an code:OpExecutionMode instruction that specifies the type of subdivision in the pipeline, they must: both specify the same subdivision mode</usage> 1346 <usage>If pname:pStages includes both a tessellation control shader stage and a tessellation evaluation shader stage, the shader code of at least one must: contain an code:OpExecutionMode instruction that specifies the output patch size in the pipeline</usage> 1347 <usage>If pname:pStages includes both a tessellation control shader stage and a tessellation evaluation shader stage, and the shader code of both contain an code:OpExecutionMode instruction that specifies the out patch size in the pipeline, they must: both specify the same patch size</usage> 1348 <usage>If pname:pStages includes tessellation shader stages, the pname:topology member of pname:pInputAssembly must: be ename:VK_PRIMITIVE_TOPOLOGY_PATCH_LIST</usage> 1349 <usage>If pname:pStages includes a geometry shader stage, and doesn't include any tessellation shader stages, its shader code must: contain an code:OpExecutionMode instruction that specifies an input primitive type that is <<shaders-geometry-execution, compatible>> with the primitive topology specified in pname:pInputAssembly</usage> 1350 <usage>If pname:pStages includes a geometry shader stage, and also includes tessellation shader stages, its shader code must: contain an code:OpExecutionMode instruction that specifies an input primitive type that is <<shaders-geometry-execution, compatible>> with the primitive topology that is output by the tessellation stages</usage> 1351 <usage>If pname:pStages includes a fragment shader stage and a geometry shader stage, and the fragment shader code reads from an input variable that is decorated with code:PrimitiveID, then the geometry shader code must: write to a matching output variable, decorated with code:PrimitiveID, in all execution paths</usage> 1352 <usage>If pname:pStages includes a fragment shader stage, its shader code mustnot: read from any input attachment that is defined as ename:VK_ATTACHMENT_UNUSED in pname:subpass</usage> 1353 <usage>The shader code for the entry points identified by pname:pStages, and the rest of the state identified by this structure must: adhere to the pipeline linking rules described in the <<interfaces,Shader Interfaces>> chapter</usage> 1354 <usage>If pname:subpass uses a depth/stencil attachment in pname:renderpass that has a layout of ename:VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL in the sname:VkAttachmentReference defined by pname:subpass, and pname:pDepthStencilState is not `NULL`, the pname:depthWriteEnable member of pname:pDepthStencilState must: be ename:VK_FALSE</usage> 1355 <usage>If pname:subpass uses a depth/stencil attachment in pname:renderpass that has a layout of ename:VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL in the sname:VkAttachmentReference defined by pname:subpass, and pname:pDepthStencilState is not `NULL`, the value of the pname:failOp, pname:passOp and pname:depthFailOp members of each of the pname:front and pname:back members of pname:pDepthStencilState must: be ename:VK_STENCIL_OP_KEEP</usage> 1356 <usage>If pname:pColorBlendState is not `NULL`, the value of the pname:blendEnable member of each element of the pname:pAttachment member of pname:pColorBlendState must: be ename:VK_FALSE if the pname:format of the attachment referred to in pname:subpass of pname:renderPass does not support color blend operations, as specified by the ename:VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BLEND_BIT flag in sname:VkFormatProperties::pname:linearTilingFeatures or sname:VkFormatProperties::pname:optimalTilingFeatures returned by fname:vkGetPhysicalDeviceFormatProperties</usage> 1357 <usage>If pname:pColorBlendState is not `NULL`, The pname:attachmentCount member of pname:pColorBlendState must: be equal to the value of pname:colorAttachmentCount used to create pname:subpass</usage> 1358 <usage>If no element of the pname:pDynamicStates member of pname:pDynamicState is ename:VK_DYNAMIC_STATE_VIEWPORT, the pname:pViewports member of pname:pViewportState must: be a pointer to an array of pname:pViewportState->viewportCount sname:VkViewport structures</usage> 1359 <usage>If no element of the pname:pDynamicStates member of pname:pDynamicState is ename:VK_DYNAMIC_STATE_SCISSOR, the pname:pScissors member of pname:pViewportState must: be a pointer to an array of pname:pViewportState->scissorCount sname:VkRect2D structures</usage> 1360 <usage>If the wide lines feature is not enabled, and no element of the pname:pDynamicStates member of pname:pDynamicState is ename:VK_DYNAMIC_STATE_LINE_WIDTH, the pname:lineWidth member of pname:pRasterizationState must: be `1.0`</usage> 1361 <usage>If the pname:rasterizerDiscardEnable member of pname:pRasterizationState is ename:VK_FALSE, pname:pViewportState must: be a pointer to a valid sname:VkPipelineViewportStateCreateInfo structure</usage> 1362 <usage>If the pname:rasterizerDiscardEnable member of pname:pRasterizationState is ename:VK_FALSE, pname:pMultisampleState must: be a pointer to a valid sname:VkPipelineMultisampleStateCreateInfo structure</usage> 1363 <usage>If the pname:rasterizerDiscardEnable member of pname:pRasterizationState is ename:VK_FALSE, and pname:subpass uses a depth/stencil attachment, pname:pDepthStencilState must: be a pointer to a valid sname:VkPipelineDepthStencilStateCreateInfo structure</usage> 1364 <usage>If the pname:rasterizerDiscardEnable member of pname:pRasterizationState is ename:VK_FALSE, and pname:subpass uses color attachments, pname:pColorBlendState must: be a pointer to a valid sname:VkPipelineColorBlendStateCreateInfo structure</usage> 1365 <usage>If the depth bias clamping feature is not enabled, no element of the pname:pDynamicStates member of pname:pDynamicState is ename:VK_DYNAMIC_STATE_DEPTH_BIAS, and the pname:depthBiasEnable member of pname:pDepthStencil is ename:VK_TRUE, the pname:depthBiasClamp member of pname:pDepthStencil must: be `0.0`</usage> 1366 <usage>If no element of the pname:pDynamicStates member of pname:pDynamicState is ename:VK_DYNAMIC_STATE_DEPTH_BOUNDS, and the pname:depthBoundsTestEnable member of pname:pDepthStencil is ename:VK_TRUE, the value of the pname:minDepthBounds and pname:maxDepthBounds members of pname:pDepthStencil must: be between `0.0` and `1.0`, inclusive</usage> 1367 <usage>pname:layout must: be <<descriptorsets-pipelinelayout-consistency,consistent>> with all shaders specified in pname:pStages</usage> 1368 <usage>If pname:subpass uses color and/or depth/stencil attachments, then the pname:rasterizationSamples member of pname:pMultisampleState must: be the same as the sample count for those subpass attachments</usage> 1369 <usage>If pname:subpass does not use any color and/or depth/stencil attachments, then the pname:rasterizationSamples member of pname:pMultisampleState must: follow the rules for a <<renderpass-noattachments, zero-attachment subpass>></usage> 1370 <usage>pname:subpass must: be a valid subpass within pname:renderpass</usage> 1371 </validity> 1372 </type> 1373 <type category="struct" name="VkPipelineCacheCreateInfo"> 1374 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_PIPELINE_CACHE_CREATE_INFO --> 1375 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 1376 <member optional="true"><type>VkPipelineCacheCreateFlags</type> <name>flags</name></member> <!-- Reserved --> 1377 <member optional="true"><type>size_t</type> <name>initialDataSize</name></member> <!-- Size of initial data to populate cache, in bytes --> 1378 <member len="initialDataSize">const <type>void</type>* <name>pInitialData</name></member> <!-- Initial data to populate cache --> 1379 <validity> 1380 <usage>If pname:initialDataSize is not `0`, it must: be equal to the size of pname:pInitialData, as returned by fname:vkGetPipelineCacheData when pname:pInitialData was originally retrieved</usage> 1381 <usage>If pname:initialDataSize is not `0`, pname:pInitialData must: have been retrieved from a previous call to fname:vkGetPipelineCacheData</usage> 1382 </validity> 1383 </type> 1384 <type category="struct" name="VkPushConstantRange"> 1385 <member><type>VkShaderStageFlags</type> <name>stageFlags</name></member> <!-- Which stages use the range --> 1386 <member><type>uint32_t</type> <name>offset</name></member> <!-- Start of the range, in bytes --> 1387 <member><type>uint32_t</type> <name>size</name></member> <!-- Size of the range, in bytes --> 1388 <validity> 1389 <usage>The sum of pname:offset and pname:size must: be less than or equal to the value of sname:VkPhysicalDeviceLimits::pname:maxPushConstantsSize</usage> 1390 <usage>The value of pname:size must: be greater than `0`</usage> 1391 <usage>The value of pname:size must: be a multiple of `4`</usage> 1392 </validity> 1393 </type> 1394 <type category="struct" name="VkPipelineLayoutCreateInfo"> 1395 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_PIPELINE_LAYOUT_CREATE_INFO --> 1396 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 1397 <member optional="true"><type>VkPipelineLayoutCreateFlags</type> <name>flags</name></member> <!-- Reserved --> 1398 <member optional="true"><type>uint32_t</type> <name>setLayoutCount</name></member> <!-- Number of descriptor sets interfaced by the pipeline --> 1399 <member len="setLayoutCount">const <type>VkDescriptorSetLayout</type>* <name>pSetLayouts</name></member> <!-- Array of setCount number of descriptor set layout objects defining the layout of the --> 1400 <member optional="true"><type>uint32_t</type> <name>pushConstantRangeCount</name></member> <!-- Number of push-constant ranges used by the pipeline --> 1401 <member len="pushConstantRangeCount">const <type>VkPushConstantRange</type>* <name>pPushConstantRanges</name></member> <!-- Array of pushConstantRangeCount number of ranges used by various shader stages --> 1402 <validity> 1403 <usage>pname:setLayoutCount must: be less than or equal to sname:VkPhysicalDeviceLimits::pname:maxBoundDescriptorSets</usage> 1404 <usage>The total number of descriptors of the type ename:VK_DESCRIPTOR_TYPE_SAMPLER and ename:VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER accessible to any given shader stage across all elements of pname:pSetLayouts must: be less than or equal to the value of sname:VkPhysicalDeviceLimits::pname:maxPerStageDescriptorSamplers</usage> 1405 <usage>The total number of descriptors of the type ename:VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER and ename:VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER_DYNAMIC accessible to any given shader stage across all elements of pname:pSetLayouts must: be less than or equal to the value of sname:VkPhysicalDeviceLimits::pname:maxPerStageDescriptorUniformBuffers</usage> 1406 <usage>The total number of descriptors of the type ename:VK_DESCRIPTOR_TYPE_STORAGE_BUFFER and ename:VK_DESCRIPTOR_TYPE_STORAGE_BUFFER_DYNAMIC accessible to any given shader stage across all elements of pname:pSetLayouts must: be less than or equal to the value of sname:VkPhysicalDeviceLimits::pname:maxPerStageDescriptorStorageBuffers</usage> 1407 <usage>The total number of descriptors of the type ename:VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER, ename:VK_DESCRIPTOR_TYPE_SAMPLED_IMAGE, and ename:VK_DESCRIPTOR_TYPE_UNIFORM_TEXEL_BUFFER accessible to any given shader stage across all elements of pname:pSetLayouts must: be less than or equal to the value of sname:VkPhysicalDeviceLimits::pname:maxPerStageDescriptorSampledImages</usage> 1408 <usage>The total number of descriptors of the type ename:VK_DESCRIPTOR_TYPE_STORAGE_IMAGE, and ename:VK_DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER accessible to any given shader stage across all elements of pname:pSetLayouts must: be less than or equal to the value of sname:VkPhysicalDeviceLimits::pname:maxPerStageDescriptorStorageImages</usage> 1409 </validity> 1410 </type> 1411 <type category="struct" name="VkSamplerCreateInfo"> 1412 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_SAMPLER_CREATE_INFO --> 1413 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 1414 <member optional="true"><type>VkSamplerCreateFlags</type> <name>flags</name></member> <!-- Reserved --> 1415 <member><type>VkFilter</type> <name>magFilter</name></member> <!-- Filter mode for magnification --> 1416 <member><type>VkFilter</type> <name>minFilter</name></member> <!-- Filter mode for minifiation --> 1417 <member><type>VkSamplerMipmapMode</type> <name>mipmapMode</name></member> <!-- Mipmap selection mode --> 1418 <member><type>VkSamplerAddressMode</type> <name>addressModeU</name></member> 1419 <member><type>VkSamplerAddressMode</type> <name>addressModeV</name></member> 1420 <member><type>VkSamplerAddressMode</type> <name>addressModeW</name></member> 1421 <member><type>float</type> <name>mipLodBias</name></member> 1422 <member><type>VkBool32</type> <name>anisotropyEnable</name></member> 1423 <member><type>float</type> <name>maxAnisotropy</name></member> 1424 <member><type>VkBool32</type> <name>compareEnable</name></member> 1425 <member noautovalidity="true"><type>VkCompareOp</type> <name>compareOp</name></member> 1426 <member><type>float</type> <name>minLod</name></member> 1427 <member><type>float</type> <name>maxLod</name></member> 1428 <member noautovalidity="true"><type>VkBorderColor</type> <name>borderColor</name></member> 1429 <member><type>VkBool32</type> <name>unnormalizedCoordinates</name></member> 1430 <validity> 1431 <usage>The absolute value of pname:mipLodBias must: be less than or equal to sname:VkPhysicalDeviceLimits::pname:maxSamplerLodBias</usage> 1432 <usage>If the <<features-features-samplerAnisotropy,anisotropic sampling>> feature is not enabled, pname:anisotropyEnable must: be ename:VK_FALSE</usage> 1433 <usage>If pname:anisotropyEnable is ename:VK_TRUE, the value of pname:maxAnisotropy must: be between `1.0` and sname:VkPhysicalDeviceLimits::pname:maxSamplerAnisotropy, inclusive</usage> 1434 <usage>If pname:unnormalizedCoordinates is ename:VK_TRUE, pname:minFilter and pname:magFilter must: be equal</usage> 1435 <usage>If pname:unnormalizedCoordinates is ename:VK_TRUE, pname:mipmapMode must: be ename:VK_SAMPLER_MIPMAP_MODE_NEAREST</usage> 1436 <usage>If pname:unnormalizedCoordinates is ename:VK_TRUE, pname:minLod and pname:maxLod must: be zero</usage> 1437 <usage>If pname:unnormalizedCoordinates is ename:VK_TRUE, pname:addressModeU and pname:addressModeV must: each be either ename:VK_SAMPLER_ADDRESS_MODE_CLAMP_TO_EDGE or ename:VK_SAMPLER_ADDRESS_MODE_CLAMP_TO_BORDER</usage> 1438 <usage>If pname:unnormalizedCoordinates is ename:VK_TRUE, pname:anisotropyEnable must: be ename:VK_FALSE</usage> 1439 <usage>If pname:unnormalizedCoordinates is ename:VK_TRUE, pname:compareEnable must: be ename:VK_FALSE</usage> 1440 <usage>If any of pname:addressModeU, pname:addressModeV or pname:addressModeW are ename:VK_SAMPLER_ADDRESS_MODE_CLAMP_TO_BORDER, pname:borderColor must: be a valid elink:VkBorderColor value</usage> 1441 <usage>If pname:compareEnable is ename:VK_TRUE, pname:compareOp must: be a valid elink:VkCompareOp value</usage> 1442 </validity> 1443 </type> 1444 <type category="struct" name="VkCommandPoolCreateInfo"> 1445 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_COMMAND_POOL_CREATE_INFO --> 1446 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 1447 <member optional="true"><type>VkCommandPoolCreateFlags</type> <name>flags</name></member> <!-- Command pool creation flags --> 1448 <member><type>uint32_t</type> <name>queueFamilyIndex</name></member> 1449 <validity> 1450 <usage>pname:queueFamilyIndex must: be the index of a queue family available in the calling command's pname:device parameter</usage> 1451 </validity> 1452 </type> 1453 <type category="struct" name="VkCommandBufferAllocateInfo"> 1454 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_COMMAND_BUFFER_ALLOCATE_INFO --> 1455 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 1456 <member><type>VkCommandPool</type> <name>commandPool</name></member> 1457 <member><type>VkCommandBufferLevel</type> <name>level</name></member> 1458 <member><type>uint32_t</type> <name>commandBufferCount</name></member> 1459 </type> 1460 <type category="struct" name="VkCommandBufferInheritanceInfo"> 1461 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_COMMAND_BUFFER_INHERITANCE_INFO --> 1462 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 1463 <member optional="true" noautovalidity="true"><type>VkRenderPass</type> <name>renderPass</name></member> <!-- Render pass for secondary command buffers --> 1464 <member><type>uint32_t</type> <name>subpass</name></member> 1465 <member optional="true" noautovalidity="true"><type>VkFramebuffer</type> <name>framebuffer</name></member> <!-- Framebuffer for secondary command buffers --> 1466 <member><type>VkBool32</type> <name>occlusionQueryEnable</name></member> <!-- Whether this secondary command buffer may be executed during an occlusion query --> 1467 <member optional="true" noautovalidity="true"><type>VkQueryControlFlags</type> <name>queryFlags</name></member> <!-- Query flags used by this secondary command buffer, if executed during an occlusion query --> 1468 <member optional="true" noautovalidity="true"><type>VkQueryPipelineStatisticFlags</type> <name>pipelineStatistics</name></member> <!-- Pipeline statistics that may be counted for this secondary command buffer --> 1469 <validity> 1470 <usage>If the <<features-features-inheritedQueries,inherited queries>> feature is not enabled, pname:occlusionQueryEnable must: be ename:VK_FALSE</usage> 1471 <usage>If the <<features-features-inheritedQueries,inherited queries>> feature is enabled, pname:queryFlags must: be a valid combination of elink:VkQueryControlFlagBits values</usage> 1472 <usage>If the <<features-features-pipelineStatisticsQuery,pipeline statistics queries>> feature is not enabled, pname:pipelineStatistics must: be code:0</usage> 1473 </validity> 1474 </type> 1475 <type category="struct" name="VkCommandBufferBeginInfo"> 1476 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_COMMAND_BUFFER_BEGIN_INFO --> 1477 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 1478 <member optional="true"><type>VkCommandBufferUsageFlags</type> <name>flags</name></member> <!-- Command buffer usage flags --> 1479 <member optional="true" noautovalidity="true">const <type>VkCommandBufferInheritanceInfo</type>* <name>pInheritanceInfo</name></member> <!-- Pointer to inheritance info for secondary command buffers --> 1480 <validity> 1481 <usage>If pname:flags contains ename:VK_COMMAND_BUFFER_USAGE_RENDER_PASS_CONTINUE_BIT, the pname:renderPass member of pname:pInheritanceInfo must: be a valid sname:VkRenderPass</usage> 1482 <usage>If pname:flags contains ename:VK_COMMAND_BUFFER_USAGE_RENDER_PASS_CONTINUE_BIT, the pname:subpass member of pname:pInheritanceInfo must: be a valid subpass index within the pname:renderPass member of pname:pInheritanceInfo</usage> 1483 <usage>If pname:flags contains ename:VK_COMMAND_BUFFER_USAGE_RENDER_PASS_CONTINUE_BIT, the pname:framebuffer member of pname:pInheritanceInfo must: be either sname:VK_NULL_HANDLE, or a valid sname:VkFramebuffer that is compatible with the pname:renderPass member of pname:pInheritanceInfo</usage> 1484 </validity> 1485 </type> 1486 <type category="struct" name="VkRenderPassBeginInfo"> 1487 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_RENDER_PASS_BEGIN_INFO --> 1488 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 1489 <member><type>VkRenderPass</type> <name>renderPass</name></member> 1490 <member><type>VkFramebuffer</type> <name>framebuffer</name></member> 1491 <member><type>VkRect2D</type> <name>renderArea</name></member> 1492 <member optional="true"><type>uint32_t</type> <name>clearValueCount</name></member> 1493 <member len="clearValueCount">const <type>VkClearValue</type>* <name>pClearValues</name></member> 1494 <validity> 1495 <usage>The value of pname:clearValueCount must: be greater than or equal to the number of attachments in pname:renderPass that specify a pname:loadOp of ename:VK_ATTACHMENT_LOAD_OP_CLEAR</usage> 1496 </validity> 1497 </type> 1498 <type category="union" name="VkClearColorValue" comment="// Union allowing specification of floating point, integer, or unsigned integer color data. Actual value selected is based on image/attachment being cleared."> 1499 <member><type>float</type> <name>float32</name>[4]</member> 1500 <member><type>int32_t</type> <name>int32</name>[4]</member> 1501 <member><type>uint32_t</type> <name>uint32</name>[4]</member> 1502 </type> 1503 <type category="struct" name="VkClearDepthStencilValue"> 1504 <member><type>float</type> <name>depth</name></member> 1505 <member><type>uint32_t</type> <name>stencil</name></member> 1506 </type> 1507 <type category="union" name="VkClearValue" comment="// Union allowing specification of color or depth and stencil values. Actual value selected is based on attachment being cleared."> 1508 <member><type>VkClearColorValue</type> <name>color</name></member> 1509 <member><type>VkClearDepthStencilValue</type> <name>depthStencil</name></member> 1510 </type> 1511 <type category="struct" name="VkClearAttachment"> 1512 <member><type>VkImageAspectFlags</type> <name>aspectMask</name></member> 1513 <member><type>uint32_t</type> <name>colorAttachment</name></member> 1514 <member><type>VkClearValue</type> <name>clearValue</name></member> 1515 <validity> 1516 <usage>If pname:aspectMask includes ename:VK_IMAGE_ASPECT_COLOR_BIT, it mustnot: include ename:VK_IMAGE_ASPECT_DEPTH_BIT or ename:VK_IMAGE_ASPECT_STENCIL_BIT</usage> 1517 <usage>pname:aspectMask mustnot: include ename:VK_IMAGE_ASPECT_METADATA_BIT</usage> 1518 </validity> 1519 </type> 1520 <type category="struct" name="VkAttachmentDescription"> 1521 <member optional="true"><type>VkAttachmentDescriptionFlags</type> <name>flags</name></member> 1522 <member><type>VkFormat</type> <name>format</name></member> 1523 <member><type>VkSampleCountFlagBits</type> <name>samples</name></member> 1524 <member><type>VkAttachmentLoadOp</type> <name>loadOp</name></member> <!-- Load operation for color or depth data --> 1525 <member><type>VkAttachmentStoreOp</type> <name>storeOp</name></member> <!-- Store operation for color or depth data --> 1526 <member><type>VkAttachmentLoadOp</type> <name>stencilLoadOp</name></member> <!-- Load operation for stencil data --> 1527 <member><type>VkAttachmentStoreOp</type> <name>stencilStoreOp</name></member> <!-- Store operation for stencil data --> 1528 <member><type>VkImageLayout</type> <name>initialLayout</name></member> 1529 <member><type>VkImageLayout</type> <name>finalLayout</name></member> 1530 </type> 1531 <type category="struct" name="VkAttachmentReference"> 1532 <member><type>uint32_t</type> <name>attachment</name></member> 1533 <member><type>VkImageLayout</type> <name>layout</name></member> 1534 </type> 1535 <type category="struct" name="VkSubpassDescription"> 1536 <member optional="true"><type>VkSubpassDescriptionFlags</type> <name>flags</name></member> 1537 <member><type>VkPipelineBindPoint</type> <name>pipelineBindPoint</name></member> <!-- Must be VK_PIPELINE_BIND_POINT_GRAPHICS for now --> 1538 <member optional="true"><type>uint32_t</type> <name>inputAttachmentCount</name></member> 1539 <member len="inputAttachmentCount">const <type>VkAttachmentReference</type>* <name>pInputAttachments</name></member> 1540 <member optional="true"><type>uint32_t</type> <name>colorAttachmentCount</name></member> 1541 <member len="colorAttachmentCount">const <type>VkAttachmentReference</type>* <name>pColorAttachments</name></member> 1542 <member optional="true" len="colorAttachmentCount">const <type>VkAttachmentReference</type>* <name>pResolveAttachments</name></member> 1543 <member optional="true">const <type>VkAttachmentReference</type>* <name>pDepthStencilAttachment</name></member> 1544 <member optional="true"><type>uint32_t</type> <name>preserveAttachmentCount</name></member> 1545 <member len="preserveAttachmentCount">const <type>uint32_t</type>* <name>pPreserveAttachments</name></member> 1546 <validity> 1547 <usage>pname:pipelineBindPoint must: be ename:VK_PIPELINE_BIND_POINT_GRAPHICS</usage> 1548 <usage>The value of pname:colorCount must: be less than or equal to sname:VkPhysicalDeviceLimits::pname:maxColorAttachments</usage> 1549 <usage>If the first use of an attachment in this render pass is as an input attachment, and the attachment is not also used as a color or depth/stencil attachment in the same subpass, then pname:loadOp mustnot: be ename:VK_ATTACHMENT_LOAD_OP_CLEAR</usage> 1550 <usage>If pname:pResolveAttachments is not `NULL`, for each resolve attachment that does not have the value ename:VK_ATTACHMENT_UNUSED, the corresponding color attachment mustnot: have the value ename:VK_ATTACHMENT_UNUSED</usage> 1551 <usage>If pname:pResolveAttachments is not `NULL`, the sample count of each element of pname:pColorAttachments must: be anything other than ename:VK_SAMPLE_COUNT_1_BIT</usage> 1552 <usage>Any given element of pname:pResolveAttachments must: have a sample count of ename:VK_SAMPLE_COUNT_1_BIT</usage> 1553 <usage>Any given element of pname:pResolveAttachments must: have the same elink:VkFormat as its corresponding color attachment</usage> 1554 <usage>All attachments in pname:pColorAttachments and pname:pDepthStencilAttachment that are not ename:VK_ATTACHMENT_UNUSED must: have the same sample count</usage> 1555 <usage>If any input attachments are ename:VK_ATTACHMENT_UNUSED, then any pipelines bound during the subpass mustnot: accesss those input attachments from the fragment shader</usage> 1556 <usage>The pname:attachment member of any element of pname:pPreserveAttachments mustnot: be ename:VK_ATTACHMENT_UNUSED</usage> 1557 <usage>Any given element of pname:pPreserveAttachments mustnot: also be an element of any other member of the subpass description</usage> 1558 <usage>If any attachment is used as both an input attachment and a color or depth/stencil attachment, then each use must use the same pname:layout</usage> 1559 </validity> 1560 </type> 1561 <type category="struct" name="VkSubpassDependency"> 1562 <member><type>uint32_t</type> <name>srcSubpass</name></member> 1563 <member><type>uint32_t</type> <name>dstSubpass</name></member> 1564 <member><type>VkPipelineStageFlags</type> <name>srcStageMask</name></member> 1565 <member><type>VkPipelineStageFlags</type> <name>dstStageMask</name></member> 1566 <member optional="true"><type>VkAccessFlags</type> <name>srcAccessMask</name></member> <!-- Memory accesses from the source of the dependency to synchronize --> 1567 <member optional="true"><type>VkAccessFlags</type> <name>dstAccessMask</name></member> <!-- Memory accesses from the destination of the dependency to synchronize --> 1568 <member optional="true"><type>VkDependencyFlags</type> <name>dependencyFlags</name></member> 1569 <validity> 1570 <usage>If the <<features-features-geometryShader,geometry shaders>> feature is not enabled, pname:srcStageMask mustnot: contain pname:VK_PIPELINE_STAGE_GEOMETRY_SHADER_BIT</usage> 1571 <usage>If the <<features-features-geometryShader,geometry shaders>> feature is not enabled, pname:dstStageMask mustnot: contain pname:VK_PIPELINE_STAGE_GEOMETRY_SHADER_BIT</usage> 1572 <usage>If the <<features-features-tessellationShader,tessellation shaders>> feature is not enabled, pname:srcStageMask mustnot: contain pname:VK_PIPELINE_STAGE_TESSELLATION_CONTROL_SHADER_BIT or pname:VK_PIPELINE_STAGE_TESSELLATION_EVALUATION_SHADER_BIT</usage> 1573 <usage>If the <<features-features-tessellationShader,tessellation shaders>> feature is not enabled, pname:dstStageMask mustnot: contain pname:VK_PIPELINE_STAGE_TESSELLATION_CONTROL_SHADER_BIT or pname:VK_PIPELINE_STAGE_TESSELLATION_EVALUATION_SHADER_BIT</usage> 1574 <usage>The value of pname:srcSubpass must: be less than or equal to pname:dstSubpass, unless one of them is ename:VK_SUBPASS_EXTERNAL, to avoid cyclic dependencies and ensure a valid execution order</usage> 1575 <usage>The values of pname:srcSubpass and pname:dstSubpass mustnot: both be equal to ename:VK_SUBPASS_EXTERNAL</usage> 1576 </validity> 1577 </type> 1578 <type category="struct" name="VkRenderPassCreateInfo"> 1579 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_RENDER_PASS_CREATE_INFO --> 1580 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 1581 <member optional="true"><type>VkRenderPassCreateFlags</type> <name>flags</name></member> <!-- Reserved --> 1582 <member optional="true"><type>uint32_t</type> <name>attachmentCount</name></member> 1583 <member len="attachmentCount">const <type>VkAttachmentDescription</type>* <name>pAttachments</name></member> 1584 <member><type>uint32_t</type> <name>subpassCount</name></member> 1585 <member len="subpassCount">const <type>VkSubpassDescription</type>* <name>pSubpasses</name></member> 1586 <member optional="true"><type>uint32_t</type> <name>dependencyCount</name></member> 1587 <member len="dependencyCount">const <type>VkSubpassDependency</type>* <name>pDependencies</name></member> 1588 <validity> 1589 <usage>If any two subpasses operate on attachments with overlapping ranges of the same sname:VkDeviceMemory object, and at least one subpass writes to that area of sname:VkDeviceMemory, a subpass dependency must: be included (either directly or via some intermediate subpasses) between them</usage> 1590 <usage>If the pname:attachment member of any element of pname:pInputAttachments, pname:pColorAttachments, pname:pResolveAttachments or pname:pDepthStencilAttachment, or the attachment indexed by any element of pname:pPreserveAttachments in any given element of pname:pSubpasses is bound to a range of a sname:VkDeviceMemory object that overlaps with any other attachment in any subpass (including the same subpass), the sname:VkAttachmentReference structures describing them must: include ename:VK_ATTACHMENT_DESCRIPTION_MAY_ALIAS_BIT in pname:flags</usage> 1591 <usage>If the pname:attachment member of any element of pname:pInputAttachments, pname:pColorAttachments, pname:pResolveAttachments or pname:pDepthStencilAttachment, or the value of any element of pname:pPreserveAttachments in any given element of pname:pSubpasses is not ename:VK_ATTACHMENT_UNUSED, it must: be less than the value of pname:attachmentCount</usage> 1592 <usage>The value of any element of the pname:pPreserveAttachments member in any given element of pname:pSubpasses mustnot: be ename:VK_ATTACHMENT_UNUSED</usage> 1593 </validity> 1594 </type> 1595 <type category="struct" name="VkEventCreateInfo"> 1596 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_EVENT_CREATE_INFO --> 1597 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 1598 <member optional="true"><type>VkEventCreateFlags</type> <name>flags</name></member> <!-- Event creation flags --> 1599 </type> 1600 <type category="struct" name="VkFenceCreateInfo"> 1601 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_FENCE_CREATE_INFO --> 1602 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 1603 <member optional="true"><type>VkFenceCreateFlags</type> <name>flags</name></member> <!-- Fence creation flags --> 1604 </type> 1605 <type category="struct" name="VkPhysicalDeviceFeatures"> 1606 <member><type>VkBool32</type> <name>robustBufferAccess</name></member> <!-- out of bounds buffer accesses are well defined --> 1607 <member><type>VkBool32</type> <name>fullDrawIndexUint32</name></member> <!-- full 32-bit range of indices for indexed draw calls --> 1608 <member><type>VkBool32</type> <name>imageCubeArray</name></member> <!-- image views which are arrays of cube maps --> 1609 <member><type>VkBool32</type> <name>independentBlend</name></member> <!-- blending operations are controlled per-attachment --> 1610 <member><type>VkBool32</type> <name>geometryShader</name></member> <!-- geometry stage --> 1611 <member><type>VkBool32</type> <name>tessellationShader</name></member> <!-- tessellation control and evaluation stage --> 1612 <member><type>VkBool32</type> <name>sampleRateShading</name></member> <!-- per-sample shading and interpolation --> 1613 <member><type>VkBool32</type> <name>dualSrcBlend</name></member> <!-- blend operations which take two sources --> 1614 <member><type>VkBool32</type> <name>logicOp</name></member> <!-- logic operations --> 1615 <member><type>VkBool32</type> <name>multiDrawIndirect</name></member> <!-- multi draw indirect --> 1616 <member><type>VkBool32</type> <name>drawIndirectFirstInstance</name></member> <!-- indirect draws can use non-zero firstInstance --> 1617 <member><type>VkBool32</type> <name>depthClamp</name></member> <!-- depth clamping --> 1618 <member><type>VkBool32</type> <name>depthBiasClamp</name></member> <!-- depth bias clamping --> 1619 <member><type>VkBool32</type> <name>fillModeNonSolid</name></member> <!-- point and wireframe fill modes --> 1620 <member><type>VkBool32</type> <name>depthBounds</name></member> <!-- depth bounds test --> 1621 <member><type>VkBool32</type> <name>wideLines</name></member> <!-- lines with width greater than 1 --> 1622 <member><type>VkBool32</type> <name>largePoints</name></member> <!-- points with size greater than 1 --> 1623 <member><type>VkBool32</type> <name>alphaToOne</name></member> <!-- the fragment alpha component can be forced to maximum representable alpha value --> 1624 <member><type>VkBool32</type> <name>multiViewport</name></member> <!-- viewport arrays --> 1625 <member><type>VkBool32</type> <name>samplerAnisotropy</name></member> <!-- anisotropic sampler filtering --> 1626 <member><type>VkBool32</type> <name>textureCompressionETC2</name></member> <!-- ETC texture compression formats --> 1627 <member><type>VkBool32</type> <name>textureCompressionASTC_LDR</name></member> <!-- ASTC LDR texture compression formats --> 1628 <member><type>VkBool32</type> <name>textureCompressionBC</name></member> <!-- BC1-7 texture compressed formats --> 1629 <member><type>VkBool32</type> <name>occlusionQueryPrecise</name></member> <!-- precise occlusion queries returning actual sample counts --> 1630 <member><type>VkBool32</type> <name>pipelineStatisticsQuery</name></member> <!-- pipeline statistics query --> 1631 <member><type>VkBool32</type> <name>vertexPipelineStoresAndAtomics</name></member> <!-- stores and atomic ops on storage buffers and images are supported in vertex, tessellation, and geometry stages --> 1632 <member><type>VkBool32</type> <name>fragmentStoresAndAtomics</name></member> <!-- stores and atomic ops on storage buffers and images are supported in the fragment stage --> 1633 <member><type>VkBool32</type> <name>shaderTessellationAndGeometryPointSize</name></member><!-- tessellation and geometry stages can export point size --> 1634 <member><type>VkBool32</type> <name>shaderImageGatherExtended</name></member> <!-- image gather with run-time values and independent offsets --> 1635 <member><type>VkBool32</type> <name>shaderStorageImageExtendedFormats</name></member> <!-- the extended set of formats can be used for storage images --> 1636 <member><type>VkBool32</type> <name>shaderStorageImageMultisample</name></member> <!-- multisample images can be used for storage images --> 1637 <member><type>VkBool32</type> <name>shaderStorageImageReadWithoutFormat</name></member> <!-- read from storage image does not require format qualifier --> 1638 <member><type>VkBool32</type> <name>shaderStorageImageWriteWithoutFormat</name></member> <!-- write to storage image does not require format qualifier --> 1639 <member><type>VkBool32</type> <name>shaderUniformBufferArrayDynamicIndexing</name></member> <!-- arrays of uniform buffers can be accessed with dynamically uniform indices --> 1640 <member><type>VkBool32</type> <name>shaderSampledImageArrayDynamicIndexing</name></member> <!-- arrays of sampled images can be accessed with dynamically uniform indices --> 1641 <member><type>VkBool32</type> <name>shaderStorageBufferArrayDynamicIndexing</name></member> <!-- arrays of storage buffers can be accessed with dynamically uniform indices --> 1642 <member><type>VkBool32</type> <name>shaderStorageImageArrayDynamicIndexing</name></member> <!-- arrays of storage images can be accessed with dynamically uniform indices --> 1643 <member><type>VkBool32</type> <name>shaderClipDistance</name></member> <!-- clip distance in shaders --> 1644 <member><type>VkBool32</type> <name>shaderCullDistance</name></member> <!-- cull distance in shaders --> 1645 <member><type>VkBool32</type> <name>shaderFloat64</name></member> <!-- 64-bit floats (doubles) in shaders --> 1646 <member><type>VkBool32</type> <name>shaderInt64</name></member> <!-- 64-bit integers in shaders --> 1647 <member><type>VkBool32</type> <name>shaderInt16</name></member> <!-- 16-bit integers in shaders --> 1648 <member><type>VkBool32</type> <name>shaderResourceResidency</name></member> <!-- shader can use texture operations that return resource residency information (requires sparseNonResident support) --> 1649 <member><type>VkBool32</type> <name>shaderResourceMinLod</name></member> <!-- shader can use texture operations that specify minimum resource level of detail --> 1650 <member><type>VkBool32</type> <name>sparseBinding</name></member> <!-- Sparse resources support: Resource memory can be managed at opaque page level rather than object level --> 1651 <member><type>VkBool32</type> <name>sparseResidencyBuffer</name></member> <!-- Sparse resources support: GPU can access partially resident buffers --> 1652 <member><type>VkBool32</type> <name>sparseResidencyImage2D</name></member> <!-- Sparse resources support: GPU can access partially resident 2D (non-MSAA non-depth/stencil) images --> 1653 <member><type>VkBool32</type> <name>sparseResidencyImage3D</name></member> <!-- Sparse resources support: GPU can access partially resident 3D images --> 1654 <member><type>VkBool32</type> <name>sparseResidency2Samples</name></member> <!-- Sparse resources support: GPU can access partially resident MSAA 2D images with 2 samples --> 1655 <member><type>VkBool32</type> <name>sparseResidency4Samples</name></member> <!-- Sparse resources support: GPU can access partially resident MSAA 2D images with 4 samples --> 1656 <member><type>VkBool32</type> <name>sparseResidency8Samples</name></member> <!-- Sparse resources support: GPU can access partially resident MSAA 2D images with 8 samples --> 1657 <member><type>VkBool32</type> <name>sparseResidency16Samples</name></member> <!-- Sparse resources support: GPU can access partially resident MSAA 2D images with 16 samples --> 1658 <member><type>VkBool32</type> <name>sparseResidencyAliased</name></member> <!-- Sparse resources support: GPU can correctly access data aliased into multiple locations (opt-in) --> 1659 <member><type>VkBool32</type> <name>variableMultisampleRate</name></member> <!-- multisample rate must be the same for all pipelines in a subpass --> 1660 <member><type>VkBool32</type> <name>inheritedQueries</name></member> <!-- Queries may be inherited from primary to secondary command buffers --> 1661 <validity> 1662 <usage>If the value of any member of this structure is ename:VK_FALSE, as returned by flink:vkGetPhysicalDeviceFeatures, then it must: be ename:VK_FALSE when passed as part of the sname:VkDeviceCreateInfo struct when creating a device</usage> 1663 </validity> 1664 </type> 1665 <type category="struct" name="VkPhysicalDeviceSparseProperties" returnedonly="true"> 1666 <member><type>VkBool32</type> <name>residencyStandard2DBlockShape</name></member> <!-- Sparse resources support: GPU will access all 2D (single sample) sparse resources using the standard block shapes (based on pixel format) --> 1667 <member><type>VkBool32</type> <name>residencyStandard2DMultisampleBlockShape</name></member> <!-- Sparse resources support: GPU will access all 2D (multisample) sparse resources using the standard block shapes (based on pixel format) --> 1668 <member><type>VkBool32</type> <name>residencyStandard3DBlockShape</name></member> <!-- Sparse resources support: GPU will access all 3D sparse resources using the standard block shapes (based on pixel format) --> 1669 <member><type>VkBool32</type> <name>residencyAlignedMipSize</name></member> <!-- Sparse resources support: Images with mip-level dimensions that are NOT a multiple of the block size will be placed in the mip tail --> 1670 <member><type>VkBool32</type> <name>residencyNonResidentStrict</name></member> <!-- Sparse resources support: GPU can consistently access non-resident regions of a resource, all reads return as if data is 0, writes are discarded --> 1671 </type> 1672 <type category="struct" name="VkPhysicalDeviceLimits" returnedonly="true"> 1673 <!-- resource maximum sizes --> 1674 <member><type>uint32_t</type> <name>maxImageDimension1D</name></member> <!-- max 1D image dimension --> 1675 <member><type>uint32_t</type> <name>maxImageDimension2D</name></member> <!-- max 2D image dimension --> 1676 <member><type>uint32_t</type> <name>maxImageDimension3D</name></member> <!-- max 3D image dimension --> 1677 <member><type>uint32_t</type> <name>maxImageDimensionCube</name></member> <!-- max cubemap image dimension --> 1678 <member><type>uint32_t</type> <name>maxImageArrayLayers</name></member> <!-- max layers for image arrays --> 1679 <member><type>uint32_t</type> <name>maxTexelBufferElements</name></member> <!-- max texel buffer size (fstexels) --> 1680 <member><type>uint32_t</type> <name>maxUniformBufferRange</name></member> <!-- max uniform buffer range (bytes) --> 1681 <member><type>uint32_t</type> <name>maxStorageBufferRange</name></member> <!-- max storage buffer range (bytes) --> 1682 <member><type>uint32_t</type> <name>maxPushConstantsSize</name></member> <!-- max size of the push constants pool (bytes) --> 1683 <!-- memory limits --> 1684 <member><type>uint32_t</type> <name>maxMemoryAllocationCount</name></member> <!-- max number of device memory allocations supported --> 1685 <member><type>uint32_t</type> <name>maxSamplerAllocationCount</name></member> <!-- max number of samplers that can be allocated on a device --> 1686 <member><type>VkDeviceSize</type> <name>bufferImageGranularity</name></member> <!-- Granularity (in bytes) at which buffers and images can be bound to adjacent memory for simultaneous usage --> 1687 <member><type>VkDeviceSize</type> <name>sparseAddressSpaceSize</name></member> <!-- Total address space available for sparse allocations (bytes) --> 1688 <!-- descriptor set limits --> 1689 <member><type>uint32_t</type> <name>maxBoundDescriptorSets</name></member> <!-- max number of descriptors sets that can be bound to a pipeline --> 1690 <member><type>uint32_t</type> <name>maxPerStageDescriptorSamplers</name></member> <!-- max number of samplers allowed per-stage in a descriptor set --> 1691 <member><type>uint32_t</type> <name>maxPerStageDescriptorUniformBuffers</name></member> <!-- max number of uniform buffers allowed per-stage in a descriptor set --> 1692 <member><type>uint32_t</type> <name>maxPerStageDescriptorStorageBuffers</name></member> <!-- max number of storage buffers allowed per-stage in a descriptor set --> 1693 <member><type>uint32_t</type> <name>maxPerStageDescriptorSampledImages</name></member> <!-- max number of sampled images allowed per-stage in a descriptor set --> 1694 <member><type>uint32_t</type> <name>maxPerStageDescriptorStorageImages</name></member> <!-- max number of storage images allowed per-stage in a descriptor set --> 1695 <member><type>uint32_t</type> <name>maxPerStageDescriptorInputAttachments</name></member> <!-- max number of input attachments allowed per-stage in a descriptor set --> 1696 <member><type>uint32_t</type> <name>maxPerStageResources</name></member> <!-- max number of resources allowed by a single stage --> 1697 <member><type>uint32_t</type> <name>maxDescriptorSetSamplers</name></member> <!-- max number of samplers allowed in all stages in a descriptor set --> 1698 <member><type>uint32_t</type> <name>maxDescriptorSetUniformBuffers</name></member> <!-- max number of uniform buffers allowed in all stages in a descriptor set --> 1699 <member><type>uint32_t</type> <name>maxDescriptorSetUniformBuffersDynamic</name></member> <!-- max number of dynamic uniform buffers allowed in all stages in a descriptor set --> 1700 <member><type>uint32_t</type> <name>maxDescriptorSetStorageBuffers</name></member> <!-- max number of storage buffers allowed in all stages in a descriptor set --> 1701 <member><type>uint32_t</type> <name>maxDescriptorSetStorageBuffersDynamic</name></member> <!-- max number of dynamic storage buffers allowed in all stages in a descriptor set --> 1702 <member><type>uint32_t</type> <name>maxDescriptorSetSampledImages</name></member> <!-- max number of sampled images allowed in all stages in a descriptor set --> 1703 <member><type>uint32_t</type> <name>maxDescriptorSetStorageImages</name></member> <!-- max number of storage images allowed in all stages in a descriptor set --> 1704 <member><type>uint32_t</type> <name>maxDescriptorSetInputAttachments</name></member> <!-- max number of input attachments allowed in all stages in a descriptor set --> 1705 <!-- vertex stage limits --> 1706 <member><type>uint32_t</type> <name>maxVertexInputAttributes</name></member> <!-- max number of vertex input attribute slots --> 1707 <member><type>uint32_t</type> <name>maxVertexInputBindings</name></member> <!-- max number of vertex input binding slots --> 1708 <member><type>uint32_t</type> <name>maxVertexInputAttributeOffset</name></member> <!-- max vertex input attribute offset added to vertex buffer offset --> 1709 <member><type>uint32_t</type> <name>maxVertexInputBindingStride</name></member> <!-- max vertex input binding stride --> 1710 <member><type>uint32_t</type> <name>maxVertexOutputComponents</name></member> <!-- max number of output components written by vertex shader --> 1711 <!-- tessellation control stage limits --> 1712 <member><type>uint32_t</type> <name>maxTessellationGenerationLevel</name></member> <!-- max level supported by tessellation primitive generator --> 1713 <member><type>uint32_t</type> <name>maxTessellationPatchSize</name></member> <!-- max patch size (vertices) --> 1714 <member><type>uint32_t</type> <name>maxTessellationControlPerVertexInputComponents</name></member> <!-- max number of input components per-vertex in TCS --> 1715 <member><type>uint32_t</type> <name>maxTessellationControlPerVertexOutputComponents</name></member> <!-- max number of output components per-vertex in TCS --> 1716 <member><type>uint32_t</type> <name>maxTessellationControlPerPatchOutputComponents</name></member> <!-- max number of output components per-patch in TCS --> 1717 <member><type>uint32_t</type> <name>maxTessellationControlTotalOutputComponents</name></member> <!-- max total number of per-vertex and per-patch output components in TCS --> 1718 <!-- tessellation evaluation stage limits --> 1719 <member><type>uint32_t</type> <name>maxTessellationEvaluationInputComponents</name></member> <!-- max number of input components per vertex in TES --> 1720 <member><type>uint32_t</type> <name>maxTessellationEvaluationOutputComponents</name></member> <!-- max number of output components per vertex in TES --> 1721 <!-- geometry stage limits --> 1722 <member><type>uint32_t</type> <name>maxGeometryShaderInvocations</name></member> <!-- max invocation count supported in geometry shader --> 1723 <member><type>uint32_t</type> <name>maxGeometryInputComponents</name></member> <!-- max number of input components read in geometry stage --> 1724 <member><type>uint32_t</type> <name>maxGeometryOutputComponents</name></member> <!-- max number of output components written in geometry stage --> 1725 <member><type>uint32_t</type> <name>maxGeometryOutputVertices</name></member> <!-- max number of vertices that can be emitted in geometry stage --> 1726 <member><type>uint32_t</type> <name>maxGeometryTotalOutputComponents</name></member> <!-- max total number of components (all vertices) written in geometry stage --> 1727 <!-- fragment stage limits --> 1728 <member><type>uint32_t</type> <name>maxFragmentInputComponents</name></member> <!-- max number of input compontents read in fragment stage --> 1729 <member><type>uint32_t</type> <name>maxFragmentOutputAttachments</name></member> <!-- max number of output attachments written in fragment stage --> 1730 <member><type>uint32_t</type> <name>maxFragmentDualSrcAttachments</name></member> <!-- max number of output attachments written when using dual source blending --> 1731 <member><type>uint32_t</type> <name>maxFragmentCombinedOutputResources</name></member><!-- max total number of storage buffers, storage images and output buffers --> 1732 <!-- compute stage limits --> 1733 <member><type>uint32_t</type> <name>maxComputeSharedMemorySize</name></member> <!-- max total storage size of work group local storage (bytes) --> 1734 <member><type>uint32_t</type> <name>maxComputeWorkGroupCount</name>[3]</member> <!-- max num of compute work groups that may be dispatched 1735 by a single command (x,y,z) --> 1736 <member><type>uint32_t</type> <name>maxComputeWorkGroupInvocations</name></member> <!-- max total compute invocations in a single local work group --> 1737 <member><type>uint32_t</type> <name>maxComputeWorkGroupSize</name>[3]</member> <!-- max local size of a compute work group (x,y,z) --> 1738 1739 <member><type>uint32_t</type> <name>subPixelPrecisionBits</name></member> <!-- number bits of subpixel precision in screen x and y--> 1740 <member><type>uint32_t</type> <name>subTexelPrecisionBits</name></member> <!-- number bits of precision for selecting texel weights--> 1741 <member><type>uint32_t</type> <name>mipmapPrecisionBits</name></member> <!-- number bits of precision for selecting mipmap weights --> 1742 1743 <member><type>uint32_t</type> <name>maxDrawIndexedIndexValue</name></member> <!-- max index value for indexed draw calls (for 32-bit indices) --> 1744 <member><type>uint32_t</type> <name>maxDrawIndirectCount</name></member> <!-- max draw count for indirect draw calls --> 1745 1746 <member><type>float</type> <name>maxSamplerLodBias</name></member> <!-- max absolute sampler level of detail bias --> 1747 <member><type>float</type> <name>maxSamplerAnisotropy</name></member> <!-- max degree of sampler anisotropy --> 1748 1749 <member><type>uint32_t</type> <name>maxViewports</name></member> <!-- max number of active viewports --> 1750 <member><type>uint32_t</type> <name>maxViewportDimensions</name>[2]</member> <!-- max viewport dimensions (x,y) --> 1751 <member><type>float</type> <name>viewportBoundsRange</name>[2]</member> <!-- viewport bounds range (min,max) --> 1752 <member><type>uint32_t</type> <name>viewportSubPixelBits</name></member> <!-- number bits of subpixel precision for viewport --> 1753 1754 <member><type>size_t</type> <name>minMemoryMapAlignment</name></member> <!-- min required alignment of pointers returned by MapMemory (bytes) --> 1755 <member><type>VkDeviceSize</type> <name>minTexelBufferOffsetAlignment</name></member> <!-- min required alignment for texel buffer offsets (bytes) --> 1756 <member><type>VkDeviceSize</type> <name>minUniformBufferOffsetAlignment</name></member> <!-- min required alignment for uniform buffer sizes and offsets (bytes) --> 1757 <member><type>VkDeviceSize</type> <name>minStorageBufferOffsetAlignment</name></member> <!-- min required alignment for storage buffer offsets (bytes) --> 1758 1759 <member><type>int32_t</type> <name>minTexelOffset</name></member> <!-- min texel offset for OpTextureSampleOffset --> 1760 <member><type>uint32_t</type> <name>maxTexelOffset</name></member> <!-- max texel offset for OpTextureSampleOffset --> 1761 <member><type>int32_t</type> <name>minTexelGatherOffset</name></member> <!-- min texel offset for OpTextureGatherOffset --> 1762 <member><type>uint32_t</type> <name>maxTexelGatherOffset</name></member> <!-- max texel offset for OpTextureGatherOffset --> 1763 <member><type>float</type> <name>minInterpolationOffset</name></member> <!-- furthest negative offset for interpolateAtOffset --> 1764 <member><type>float</type> <name>maxInterpolationOffset</name></member> <!-- furthest positive offset for interpolateAtOffset --> 1765 <member><type>uint32_t</type> <name>subPixelInterpolationOffsetBits</name></member> <!-- number of subpixel bits for interpolateAtOffset --> 1766 1767 <member><type>uint32_t</type> <name>maxFramebufferWidth</name></member> <!-- max width for a framebuffer --> 1768 <member><type>uint32_t</type> <name>maxFramebufferHeight</name></member> <!-- max height for a framebuffer --> 1769 <member><type>uint32_t</type> <name>maxFramebufferLayers</name></member> <!-- max layer count for a layered framebuffer --> 1770 <member optional="true"><type>VkSampleCountFlags</type> <name>framebufferColorSampleCounts</name></member> <!-- supported color sample counts for a framebuffer --> 1771 <member optional="true"><type>VkSampleCountFlags</type> <name>framebufferDepthSampleCounts</name></member> <!-- supported depth sample counts for a framebuffer --> 1772 <member optional="true"><type>VkSampleCountFlags</type> <name>framebufferStencilSampleCounts</name></member> <!-- supported stencil sample counts for a framebuffer --> 1773 <member optional="true"><type>VkSampleCountFlags</type> <name>framebufferNoAttachmentsSampleCounts</name></member> <!-- supported sample counts for a framebuffer with no attachments --> 1774 <member><type>uint32_t</type> <name>maxColorAttachments</name></member> <!-- max number of color attachments per subpass --> 1775 1776 <member optional="true"><type>VkSampleCountFlags</type> <name>sampledImageColorSampleCounts</name></member> <!-- supported color sample counts for a non-integer sampled image --> 1777 <member optional="true"><type>VkSampleCountFlags</type> <name>sampledImageIntegerSampleCounts</name></member> <!-- supported sample counts for an integer image --> 1778 <member optional="true"><type>VkSampleCountFlags</type> <name>sampledImageDepthSampleCounts</name></member> <!-- supported depth sample counts for a sampled image --> 1779 <member optional="true"><type>VkSampleCountFlags</type> <name>sampledImageStencilSampleCounts</name></member> <!-- supported stencil sample counts for a sampled image --> 1780 <member optional="true"><type>VkSampleCountFlags</type> <name>storageImageSampleCounts</name></member> <!-- supported sample counts for a storage image --> 1781 <member><type>uint32_t</type> <name>maxSampleMaskWords</name></member> <!-- max number of sample mask words --> 1782 1783 <member><type>VkBool32</type> <name>timestampComputeAndGraphics</name></member> <!-- timestamps on graphics and compute queues --> 1784 <member><type>float</type> <name>timestampPeriod</name></member> <!-- number of nanoseconds it takes for timestamp query value to increment by 1 --> 1785 1786 <member><type>uint32_t</type> <name>maxClipDistances</name></member> <!-- max number of clip distances --> 1787 <member><type>uint32_t</type> <name>maxCullDistances</name></member> <!-- max number of cull distances --> 1788 <member><type>uint32_t</type> <name>maxCombinedClipAndCullDistances</name></member> <!-- max combined number of user clipping --> 1789 1790 <member><type>uint32_t</type> <name>discreteQueuePriorities</name></member> <!-- distinct queue priorities available --> 1791 1792 <member><type>float</type> <name>pointSizeRange</name>[2]</member> <!-- range (min,max) of supported point sizes --> 1793 <member><type>float</type> <name>lineWidthRange</name>[2]</member> <!-- range (min,max) of supported line widths --> 1794 <member><type>float</type> <name>pointSizeGranularity</name></member> <!-- granularity of supported point sizes --> 1795 <member><type>float</type> <name>lineWidthGranularity</name></member> <!-- granularity of supported line widths --> 1796 <member><type>VkBool32</type> <name>strictLines</name></member> <!-- line rasterization follows preferred rules --> 1797 <member><type>VkBool32</type> <name>standardSampleLocations</name></member> <!-- supports standard sample locations for all supported sample counts --> 1798 <member><type>VkDeviceSize</type> <name>optimalBufferCopyOffsetAlignment</name></member> <!-- optimal offset of buffer copies --> 1799 <member><type>VkDeviceSize</type> <name>optimalBufferCopyRowPitchAlignment</name></member><!-- optimal pitch of buffer copies --> 1800 <member><type>VkDeviceSize</type> <name>nonCoherentAtomSize</name></member> <!-- minimum size and alignment for non-coherent host-mapped device memory access --> 1801 </type> 1802 <type category="struct" name="VkSemaphoreCreateInfo"> 1803 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_SEMAPHORE_CREATE_INFO --> 1804 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 1805 <member optional="true"><type>VkSemaphoreCreateFlags</type> <name>flags</name></member> <!-- Semaphore creation flags --> 1806 </type> 1807 <type category="struct" name="VkQueryPoolCreateInfo"> 1808 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_QUERY_POOL_CREATE_INFO --> 1809 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 1810 <member optional="true"><type>VkQueryPoolCreateFlags</type> <name>flags</name></member> <!-- Reserved --> 1811 <member><type>VkQueryType</type> <name>queryType</name></member> 1812 <member><type>uint32_t</type> <name>queryCount</name></member> 1813 <member optional="true" noautovalidity="true"><type>VkQueryPipelineStatisticFlags</type> <name>pipelineStatistics</name></member> <!-- Optional --> 1814 <validity> 1815 <usage>If the <<features-features-pipelineStatisticsQuery,pipeline statistics queries>> feature is not enabled, pname:queryType mustnot: be ename:VK_QUERY_TYPE_PIPELINE_STATISTICS</usage> 1816 <usage>If pname:queryType is ename:VK_QUERY_TYPE_PIPELINE_STATISTICS, pname:pipelineStatistics must: be a valid combination of elink:VkQueryPipelineStatisticFlagBits values</usage> 1817 </validity> 1818 </type> 1819 <type category="struct" name="VkFramebufferCreateInfo"> 1820 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_FRAMEBUFFER_CREATE_INFO --> 1821 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 1822 <member optional="true"><type>VkFramebufferCreateFlags</type> <name>flags</name></member> <!-- Reserved --> 1823 <member><type>VkRenderPass</type> <name>renderPass</name></member> 1824 <member optional="true"><type>uint32_t</type> <name>attachmentCount</name></member> 1825 <member len="attachmentCount">const <type>VkImageView</type>* <name>pAttachments</name></member> 1826 <member><type>uint32_t</type> <name>width</name></member> 1827 <member><type>uint32_t</type> <name>height</name></member> 1828 <member><type>uint32_t</type> <name>layers</name></member> 1829 <validity> 1830 <usage>The value of pname:attachmentCount must: be equal to the attachment count specified in pname:renderPass</usage> 1831 <usage>Any given element of pname:pAttachments that is used as a color attachment or resolve attachment by pname:renderPass must: have been created with a pname:usage value including ename:VK_IMAGE_USAGE_COLOR_ATTACHMENT_BIT</usage> 1832 <usage>Any given element of pname:pAttachments that is used as a depth/stencil attachment by pname:renderPass must: have been created with a pname:usage value including ename:VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</usage> 1833 <usage>Any given element of pname:pAttachments that is used as an input attachment by pname:renderPass must: have been created with a pname:usage value including ename:VK_IMAGE_USAGE_INPUT_ATTACHMENT_BIT</usage> 1834 <usage>Any given element of pname:pAttachments must: have been created with an elink:VkFormat value that matches the elink:VkFormat specified by the corresponding sname:VkAttachmentDescription in pname:renderPass</usage> 1835 <usage>Any given element of pname:pAttachments must: have been created with a pname:samples value that matches the pname:samples value specified by the corresponding sname:VkAttachmentDescription in pname:renderPass</usage> 1836 <usage>Any given element of pname:pAttachments must: have dimensions at least as large as the corresponding framebuffer dimension</usage> 1837 <usage>Any given element of pname:pAttachments must: only specify a single mip-level</usage> 1838 <usage>Any given element of pname:pAttachments must: have been created with identity swizzle</usage> 1839 <usage>The value of pname:width must: be less than or equal to sname:VkPhysicalDeviceLimits::pname:maxFramebufferWidth</usage> 1840 <usage>The value of pname:height must: be less than or equal to sname:VkPhysicalDeviceLimits::pname:maxFramebufferHeight</usage> 1841 <usage>The value of pname:layers must: be less than or equal to sname:VkPhysicalDeviceLimits::pname:maxFramebufferLayers</usage> 1842 </validity> 1843 </type> 1844 <type category="struct" name="VkDrawIndirectCommand"> 1845 <member><type>uint32_t</type> <name>vertexCount</name></member> 1846 <member><type>uint32_t</type> <name>instanceCount</name></member> 1847 <member><type>uint32_t</type> <name>firstVertex</name></member> 1848 <member><type>uint32_t</type> <name>firstInstance</name></member> 1849 <validity> 1850 <usage>For a given vertex buffer binding, any attribute data fetched must: be entirely contained within the corresponding vertex buffer binding, as described in <<fxvertex-input>></usage> 1851 <usage>If the <<features-features-drawIndirectFirstInstance,drawIndirectFirstInstance>> feature is not enabled, pname:firstInstance must: be code:0</usage> 1852 </validity> 1853 </type> 1854 <type category="struct" name="VkDrawIndexedIndirectCommand"> 1855 <member><type>uint32_t</type> <name>indexCount</name></member> 1856 <member><type>uint32_t</type> <name>instanceCount</name></member> 1857 <member><type>uint32_t</type> <name>firstIndex</name></member> 1858 <member><type>int32_t</type> <name>vertexOffset</name></member> 1859 <member><type>uint32_t</type> <name>firstInstance</name></member> 1860 <validity> 1861 <usage>For a given vertex buffer binding, any attribute data fetched must: be entirely contained within the corresponding vertex buffer binding, as described in <<fxvertex-input>></usage> 1862 <usage>The total value of (pname:indexSize * (pname:firstIndex + pname:indexCount) + pname:offset) must: be less than or equal to the size of the currently bound index buffer, with indexSize being based on the type specified by pname:indexType, where the index buffer, pname:indexType, and pname:offset are specified via fname:vkCmdBindIndexBuffer</usage> 1863 <usage>If the <<features-features-drawIndirectFirstInstance,drawIndirectFirstInstance>> feature is not enabled, pname:firstInstance must: be code:0</usage> 1864 </validity> 1865 </type> 1866 <type category="struct" name="VkDispatchIndirectCommand"> 1867 <member><type>uint32_t</type> <name>x</name></member> 1868 <member><type>uint32_t</type> <name>y</name></member> 1869 <member><type>uint32_t</type> <name>z</name></member> 1870 <validity> 1871 <usage>pname:x must: be less than or equal to sname:VkPhysicalDeviceLimits::pname:maxComputeWorkGroupCount[0]</usage> 1872 <usage>pname:y must: be less than or equal to sname:VkPhysicalDeviceLimits::pname:maxComputeWorkGroupCount[1]</usage> 1873 <usage>pname:z must: be less than or equal to sname:VkPhysicalDeviceLimits::pname:maxComputeWorkGroupCount[2]</usage> 1874 </validity> 1875 </type> 1876 <type category="struct" name="VkSubmitInfo"> 1877 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Type of structure. Should be VK_STRUCTURE_TYPE_SUBMIT_INFO --> 1878 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 1879 <member optional="true"><type>uint32_t</type> <name>waitSemaphoreCount</name></member> 1880 <member len="waitSemaphoreCount">const <type>VkSemaphore</type>* <name>pWaitSemaphores</name></member> 1881 <member len="waitSemaphoreCount">const <type>VkPipelineStageFlags</type>* <name>pWaitDstStageMask</name></member> 1882 <member optional="true"><type>uint32_t</type> <name>commandBufferCount</name></member> 1883 <member len="commandBufferCount">const <type>VkCommandBuffer</type>* <name>pCommandBuffers</name></member> 1884 <member optional="true"><type>uint32_t</type> <name>signalSemaphoreCount</name></member> 1885 <member len="signalSemaphoreCount">const <type>VkSemaphore</type>* <name>pSignalSemaphores</name></member> 1886 <validity> 1887 <usage>Any given element of pname:pSignalSemaphores must: currently be unsignalled</usage> 1888 <usage>Any given element of pname:pCommandBuffers must: either have been recorded with the VK_COMMAND_BUFFER_USAGE_SIMULTANEOUS_USE_BIT, or not currently be executing on the device</usage> 1889 <usage>Any given element of pname:pCommandBuffers must: be in the executable state</usage> 1890 <usage>If any given element of pname:pCommandBuffers contains commands that execute secondary command buffers, those secondary command buffers must: have been recorded with the ename:VK_COMMAND_BUFFER_USAGE_SIMULTANEOUS_USE_BIT, or not currently be executing on the device</usage> 1891 <usage>If any given element of pname:pCommandBuffers was created with ename:VK_COMMAND_BUFFER_USAGE_ONE_TIME_SUBMIT_BIT, it mustnot: have been previously submitted without re-recording that command buffer</usage> 1892 <usage>Any given element of pname:pCommandBuffers mustnot: contain commands that execute a secondary command buffer, if that secondary command buffer has been recorded in another primary command buffer after it was recorded into this sname:VkCommandBuffer</usage> 1893 <usage>Any given element of pname:pCommandBuffers must: have been created on a sname:VkCommandPool that was created for the same queue family that the calling command's pname:queue belongs to</usage> 1894 <usage>Any given element of pname:pCommandBuffers mustnot: have been created with ename:VK_COMMAND_BUFFER_LEVEL_SECONDARY</usage> 1895 <usage>Any given element of sname:VkSemaphore in pname:pWaitSemaphores must: refer to a prior signal of that sname:VkSemaphore that won't be consumed by any other wait on that semaphore</usage> 1896 <usage>If the <<features-features-geometryShader,geometry shaders>> feature is not enabled, any given element of pname:pWaitDstStageMask mustnot: contain pname:VK_PIPELINE_STAGE_GEOMETRY_SHADER_BIT</usage> 1897 <usage>If the <<features-features-tessellationShader,tessellation shaders>> feature is not enabled, any given element of pname:pWaitDstStageMask mustnot: contain pname:VK_PIPELINE_STAGE_TESSELLATION_CONTROL_SHADER_BIT or pname:VK_PIPELINE_STAGE_TESSELLATION_EVALUATION_SHADER_BIT</usage> 1898 </validity> 1899 </type> 1900 <!-- WSI extensions --> 1901 <type category="struct" name="VkDisplayPropertiesKHR"> 1902 <member><type>VkDisplayKHR</type> <name>display</name></member> <!-- Handle of the display object --> 1903 <member len="null-terminated">const <type>char</type>* <name>displayName</name></member> <!-- Name of the display --> 1904 <member><type>VkExtent2D</type> <name>physicalDimensions</name></member> <!-- In millimeters? --> 1905 <member><type>VkExtent2D</type> <name>physicalResolution</name></member> <!-- Max resolution for CRT? --> 1906 <member optional="true"><type>VkSurfaceTransformFlagsKHR</type> <name>supportedTransforms</name></member> <!-- one or more bits from VkSurfaceTransformFlagsKHR --> 1907 <member><type>VkBool32</type> <name>planeReorderPossible</name></member> <!-- VK_TRUE if the overlay plane's z-order can be changed on this display. --> 1908 <member><type>VkBool32</type> <name>persistentContent</name></member> <!-- VK_TRUE if this is a "smart" display that supports self-refresh/internal buffering. --> 1909 </type> 1910 <type category="struct" name="VkDisplayPlanePropertiesKHR"> 1911 <member><type>VkDisplayKHR</type> <name>currentDisplay</name></member> <!-- Display the plane is currently associated with. Will be VK_NULL_HANDLE if the plane is not in use. --> 1912 <member><type>uint32_t</type> <name>currentStackIndex</name></member> <!-- Current z-order of the plane. --> 1913 </type> 1914 <type category="struct" name="VkDisplayModeParametersKHR"> 1915 <member><type>VkExtent2D</type> <name>visibleRegion</name></member> <!-- Visible scannout region. --> 1916 <member><type>uint32_t</type> <name>refreshRate</name></member> <!-- Number of times per second the display is updated. --> 1917 </type> 1918 <type category="struct" name="VkDisplayModePropertiesKHR"> 1919 <member><type>VkDisplayModeKHR</type> <name>displayMode</name></member> <!-- Handle of this display mode. --> 1920 <member><type>VkDisplayModeParametersKHR</type> <name>parameters</name></member> <!-- The parameters this mode uses. --> 1921 </type> 1922 <type category="struct" name="VkDisplayModeCreateInfoKHR"> 1923 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_DISPLAY_MODE_CREATE_INFO_KHR --> 1924 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 1925 <member optional="true"><type>VkDisplayModeCreateFlagsKHR</type> <name>flags</name></member> <!-- Reserved --> 1926 <member><type>VkDisplayModeParametersKHR</type> <name>parameters</name></member> <!-- The parameters this mode uses. --> 1927 <validity> 1928 <usage>The pname:width and pname:height members of the pname:visibleRegion member of pname:parameters must be greater than `0`</usage> 1929 <usage>The pname:refreshRate member of pname:parameters must be greater than `0`</usage> 1930 </validity> 1931 </type> 1932 <type category="struct" name="VkDisplayPlaneCapabilitiesKHR"> 1933 <member optional="true"><type>VkDisplayPlaneAlphaFlagsKHR</type> <name>supportedAlpha</name></member> <!-- Types of alpha blending supported, if any. --> 1934 <member><type>VkOffset2D</type> <name>minSrcPosition</name></member> <!-- Does the plane have any position and extent restrictions? --> 1935 <member><type>VkOffset2D</type> <name>maxSrcPosition</name></member> 1936 <member><type>VkExtent2D</type> <name>minSrcExtent</name></member> 1937 <member><type>VkExtent2D</type> <name>maxSrcExtent</name></member> 1938 <member><type>VkOffset2D</type> <name>minDstPosition</name></member> 1939 <member><type>VkOffset2D</type> <name>maxDstPosition</name></member> 1940 <member><type>VkExtent2D</type> <name>minDstExtent</name></member> 1941 <member><type>VkExtent2D</type> <name>maxDstExtent</name></member> 1942 </type> 1943 <type category="struct" name="VkDisplaySurfaceCreateInfoKHR"> 1944 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_DISPLAY_SURFACE_CREATE_INFO_KHR --> 1945 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 1946 <member optional="true"><type>VkDisplaySurfaceCreateFlagsKHR</type> <name>flags</name></member> <!-- Reserved --> 1947 <member><type>VkDisplayModeKHR</type> <name>displayMode</name></member> <!-- The mode to use when displaying this surface --> 1948 <member><type>uint32_t</type> <name>planeIndex</name></member> <!-- The plane on which this surface appears. Must be between 0 and the value returned by vkGetPhysicalDeviceDisplayPlanePropertiesKHR() in pPropertyCount. --> 1949 <member><type>uint32_t</type> <name>planeStackIndex</name></member> <!-- The z-order of the plane. --> 1950 <member><type>VkSurfaceTransformFlagBitsKHR</type> <name>transform</name></member> <!-- Transform to apply to the images as part of the scannout operation --> 1951 <member><type>float</type> <name>globalAlpha</name></member> <!-- Global alpha value. Must be between 0 and 1, inclusive. Ignored if alphaMode is not VK_DISPLAY_PLANE_ALPHA_GLOBAL_BIT_KHR --> 1952 <member><type>VkDisplayPlaneAlphaFlagBitsKHR</type> <name>alphaMode</name></member> <!-- What type of alpha blending to use. Must be a bit from vkGetDisplayPlanePropertiesKHR::supportedAlpha. --> 1953 <member><type>VkExtent2D</type> <name>imageExtent</name></member> <!-- size of the images to use with this surface --> 1954 <validity> 1955 <usage>pname:planeIndex must: be less than the number of display planes supported by the device as determined by calling fname:vkGetPhysicalDeviceDisplayPlanePropertiesKHR</usage> 1956 <usage>If the pname:planeReorderPossible member of the sname:VkDisplayPropertiesKHR structure returned by fname:vkGetPhysicalDeviceDisplayPropertiesKHR for the display corresponding to pname:displayMode is ename:VK_TRUE then pname:planeStackIndex must: be less than the number of display planes supported by the device as determined by calling fname:vkGetPhysicalDeviceDisplayPlanePropertiesKHR; otherwise pname:planeStackIndex must: equal the pname:currentStackIndex member of sname:VkDisplayPlanePropertiesKHR returned by fname:vkGetPhysicalDeviceDisplayPlanePropertiesKHR for the display plane corresponding to pname:displayMode</usage> 1957 <usage>If pname:alphaMode is ename:VK_DISPLAY_PLANE_ALPHA_GLOBAL_BIT_KHR then pname:globalAlpha must: be between `0` and `1`, inclusive</usage> 1958 <usage>pname:alphaMode must: be `0` or one of the bits present in the pname:supportedAlpha member of sname:VkDisplayPlaneCapabilitiesKHR returned by fname:vkGetDisplayPlaneCapabilitiesKHR for the display plane corresponding to pname:displayMode</usage> 1959 <usage>The pname:width and pname:height members of pname:imageExtent must be greater than `0`</usage> 1960 </validity> 1961 </type> 1962 <type category="struct" name="VkDisplayPresentInfoKHR"> 1963 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_DISPLAY_PRESENT_INFO_KHR --> 1964 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 1965 <member><type>VkRect2D</type> <name>srcRect</name></member> <!-- Rectangle within the presentable image to read pixel data from when presenting to the display. --> 1966 <member><type>VkRect2D</type> <name>dstRect</name></member> <!-- Rectangle within the current display mode's visible region to display srcRectangle in. --> 1967 <member><type>VkBool32</type> <name>persistent</name></member> <!-- For smart displays, use buffered mode. If the display properties member "persistentMode" is VK_FALSE, this member must always be VK_FALSE. --> 1968 <validity> 1969 <usage>pname:srcRect must: specify a rectangular region that is a subset of the image being presented</usage> 1970 <usage>pname:dstRect must: specify a rectangular region that is a subset of the pname:visibleRegion parameter of the display mode the swapchain being presented uses</usage> 1971 <usage>If the pname:persistentContent member of the sname:VkDisplayPropertiesKHR structure returned by fname:vkGetPhysicalDeviceDisplayPropertiesKHR for the display the present operation targets then pname:persistent must: be ename:VK_FALSE</usage> 1972 </validity> 1973 </type> 1974 <type category="struct" name="VkSurfaceCapabilitiesKHR"> 1975 <member><type>uint32_t</type> <name>minImageCount</name></member> <!-- Supported minimum number of images for the surface --> 1976 <member><type>uint32_t</type> <name>maxImageCount</name></member> <!-- Supported maximum number of images for the surface, 0 for unlimited --> 1977 <member><type>VkExtent2D</type> <name>currentExtent</name></member> <!-- Current image width and height for the surface, (0, 0) if undefined --> 1978 <member><type>VkExtent2D</type> <name>minImageExtent</name></member> <!-- Supported minimum image width and height for the surface --> 1979 <member><type>VkExtent2D</type> <name>maxImageExtent</name></member> <!-- Supported maximum image width and height for the surface --> 1980 <member><type>uint32_t</type> <name>maxImageArrayLayers</name></member> <!-- Supported maximum number of image layers for the surface --> 1981 <member optional="true"><type>VkSurfaceTransformFlagsKHR</type> <name>supportedTransforms</name></member> <!-- 1 or more bits representing the transforms supported --> 1982 <member><type>VkSurfaceTransformFlagBitsKHR</type> <name>currentTransform</name></member> <!-- The surface's current transform relative to the device's natural orientation --> 1983 <member optional="true"><type>VkCompositeAlphaFlagsKHR</type> <name>supportedCompositeAlpha</name></member> <!-- 1 or more bits representing the alpha compositing modes supported --> 1984 <member optional="true"><type>VkImageUsageFlags</type> <name>supportedUsageFlags</name></member> <!-- Supported image usage flags for the surface --> 1985 </type> 1986 <type category="struct" name="VkAndroidSurfaceCreateInfoKHR"> 1987 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_ANDROID_SURFACE_CREATE_INFO_KHR --> 1988 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 1989 <member optional="true"><type>VkAndroidSurfaceCreateFlagsKHR</type> <name>flags</name></member> <!-- Reserved --> 1990 <member><type>ANativeWindow</type>* <name>window</name></member> 1991 <validity> 1992 <usage>pname:window mustnot: be in a connected state</usage> 1993 </validity> 1994 </type> 1995 <type category="struct" name="VkMirSurfaceCreateInfoKHR"> 1996 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_MIR_SURFACE_CREATE_INFO_KHR --> 1997 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 1998 <member optional="true"><type>VkMirSurfaceCreateFlagsKHR</type> <name>flags</name></member> <!-- Reserved --> 1999 <member><type>MirConnection</type>* <name>connection</name></member> 2000 <member><type>MirSurface</type>* <name>mirSurface</name></member> 2001 </type> 2002 <type category="struct" name="VkWaylandSurfaceCreateInfoKHR"> 2003 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_WAYLAND_SURFACE_CREATE_INFO_KHR --> 2004 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 2005 <member optional="true"><type>VkWaylandSurfaceCreateFlagsKHR</type> <name>flags</name></member> <!-- Reserved --> 2006 <member>struct <type>wl_display</type>* <name>display</name></member> 2007 <member>struct <type>wl_surface</type>* <name>surface</name></member> 2008 </type> 2009 <type category="struct" name="VkWin32SurfaceCreateInfoKHR"> 2010 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_WIN32_SURFACE_CREATE_INFO_KHR --> 2011 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 2012 <member optional="true"><type>VkWin32SurfaceCreateFlagsKHR</type> <name>flags</name></member> <!-- Reserved --> 2013 <member><type>HINSTANCE</type> <name>hinstance</name></member> 2014 <member><type>HWND</type> <name>hwnd</name></member> 2015 </type> 2016 <type category="struct" name="VkXlibSurfaceCreateInfoKHR"> 2017 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_XLIB_SURFACE_CREATE_INFO_KHR --> 2018 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 2019 <member optional="true"><type>VkXlibSurfaceCreateFlagsKHR</type> <name>flags</name></member> <!-- Reserved --> 2020 <member><type>Display</type>* <name>dpy</name></member> 2021 <member><type>Window</type> <name>window</name></member> 2022 </type> 2023 <type category="struct" name="VkXcbSurfaceCreateInfoKHR"> 2024 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_XCB_SURFACE_CREATE_INFO_KHR --> 2025 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 2026 <member optional="true"><type>VkXcbSurfaceCreateFlagsKHR</type> <name>flags</name></member> <!-- Reserved --> 2027 <member><type>xcb_connection_t</type>* <name>connection</name></member> 2028 <member><type>xcb_window_t</type> <name>window</name></member> 2029 </type> 2030 <type category="struct" name="VkSurfaceFormatKHR"> 2031 <member><type>VkFormat</type> <name>format</name></member> <!-- Supported pair of rendering format --> 2032 <member><type>VkColorSpaceKHR</type> <name>colorSpace</name></member> <!-- and colorspace for the surface --> 2033 </type> 2034 <type category="struct" name="VkSwapchainCreateInfoKHR"> 2035 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_SWAPCHAIN_CREATE_INFO_KHR --> 2036 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 2037 <member optional="true"><type>VkSwapchainCreateFlagsKHR</type> <name>flags</name></member> <!-- Reserved --> 2038 <member><type>VkSurfaceKHR</type> <name>surface</name></member> <!-- The swapchain's target surface --> 2039 <member><type>uint32_t</type> <name>minImageCount</name></member> <!-- Minimum number of presentation images the application needs --> 2040 <member><type>VkFormat</type> <name>imageFormat</name></member> <!-- Format of the presentation images --> 2041 <member><type>VkColorSpaceKHR</type> <name>imageColorSpace</name></member> <!-- Colorspace of the presentation images --> 2042 <member><type>VkExtent2D</type> <name>imageExtent</name></member> <!-- Dimensions of the presentation images --> 2043 <member><type>uint32_t</type> <name>imageArrayLayers</name></member> <!-- Determines the number of views for multiview/stereo presentation --> 2044 <member><type>VkImageUsageFlags</type> <name>imageUsage</name></member> <!-- Bits indicating how the presentation images will be used --> 2045 <member><type>VkSharingMode</type> <name>imageSharingMode</name></member> <!-- Sharing mode used for the presentation images --> 2046 <member optional="true"><type>uint32_t</type> <name>queueFamilyIndexCount</name></member> <!-- Number of queue families having access to the images in case of concurrent sharing mode --> 2047 <member noautovalidity="true" len="queueFamilyIndexCount">const <type>uint32_t</type>* <name>pQueueFamilyIndices</name></member> <!-- Array of queue family indices having access to the images in case of concurrent sharing mode --> 2048 <member><type>VkSurfaceTransformFlagBitsKHR</type> <name>preTransform</name></member> <!-- The transform, relative to the device's natural orientation, applied to the image content prior to presentation --> 2049 <member><type>VkCompositeAlphaFlagBitsKHR</type> <name>compositeAlpha</name></member> <!-- The alpha blending mode used when compositing this surface with other surfaces in the window system --> 2050 <member><type>VkPresentModeKHR</type> <name>presentMode</name></member> <!-- Which presentation mode to use for presents on this swap chain --> 2051 <member><type>VkBool32</type> <name>clipped</name></member> <!-- Specifies whether presentable images may be affected by window clip regions --> 2052 <member optional="true"><type>VkSwapchainKHR</type> <name>oldSwapchain</name></member> <!-- Existing swap chain to replace, if any --> 2053 <validity> 2054 <usage>pname:surface must: be a surface that is supported by the device as determined using fname:vkGetPhysicalDeviceSurfaceSupportKHR</usage> 2055 <usage>pname:minImageCount must: be greater than or equal to the value returned in the pname:minImageCount member of the sname:VkSurfaceCapabilitiesKHR structure returned by fname:vkGetPhysicalDeviceSurfaceCapabilitiesKHR for the surface</usage> 2056 <usage>pname:minImageCount must: be less than or equal to the value returned in the pname:maxImageCount member of the sname:VkSurfaceCapabilitiesKHR structure returned by fname:vkGetPhysicalDeviceSurfaceCapabilitiesKHR for the surface if the returned value of pname:maxImageCount is not zero</usage> 2057 <usage>pname:imageFormat and pname:imageColorspace must: match the pname:format and pname:colorSpace members, respectively, of one of the sname:VkSurfaceFormatKHR structures returned by fname:vkGetPhysicalDeviceSurfaceFormatsKHR for the surface</usage> 2058 <usage>pname:imageExtent must: be between pname:minImageExtent and pname:maxImageExtent, inclusive, where pname:minImageExtent and pname:maxImageExtent are members of the sname:VkSurfaceCapabilitiesKHR structure returned by fname:vkGetPhysicalDeviceSurfaceCapabilitiesKHR for the surface</usage> 2059 <usage>pname:imageArrayLayers must: be greater than `0` and less than or equal to the pname:maxImageArrayLayers member of the sname:VkSurfaceCapabilitiesKHR structure returned by fname:vkGetPhysicalDeviceSurfaceCapabilitiesKHR for the surface</usage> 2060 <usage>pname:imageUsage must: be a subset of the supported usage flags present in the pname:supportedUsageFlags member of the sname:VkSurfaceCapabilitiesKHR structure returned by fname:vkGetPhysicalDeviceSurfaceCapabilitiesKHR for the surface</usage> 2061 <usage>If pname:imageSharingMode is ename:VK_SHARING_MODE_CONCURRENT, pname:pQueueFamilyIndices must: be a pointer to an array of pname:queueFamilyIndexCount basetype:uint32_t values</usage> 2062 <usage>If pname:imageSharingMode is ename:VK_SHARING_MODE_CONCURRENT, pname:queueFamilyIndexCount must: be greater than `1`</usage> 2063 <usage>pname:preTransform must: be one of the bits present in the pname:supportedTransforms member of the sname:VkSurfaceCapabilitiesKHR structure returned by fname:vkGetPhysicalDeviceSurfaceCapabilitiesKHR for the surface</usage> 2064 <usage>pname:compositeAlpha must: be one of the bits present in the pname:supportedCompositeAlpha member of the sname:VkSurfaceCapabilitiesKHR structure returned by fname:vkGetPhysicalDeviceSurfaceCapabilitiesKHR for the surface</usage> 2065 <usage>pname:presentMode must: be one of the ename:VkPresentModeKHR values returned by fname:vkGetPhysicalDeviceSurfacePresentModesKHR for the surface</usage> 2066 </validity> 2067 </type> 2068 <type category="struct" name="VkPresentInfoKHR"> 2069 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_PRESENT_INFO_KHR --> 2070 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 2071 <member><type>uint32_t</type> <name>waitSemaphoreCount</name></member> <!-- Number of semaphores to wait for before presenting --> 2072 <member optional="true" len="waitSemaphoreCount">const <type>VkSemaphore</type>* <name>pWaitSemaphores</name></member> <!-- Semaphores to wait for before presenting --> 2073 <member><type>uint32_t</type> <name>swapchainCount</name></member> <!-- Number of swap chains to present in this call --> 2074 <member len="swapchainCount">const <type>VkSwapchainKHR</type>* <name>pSwapchains</name></member> <!-- Swapchains to present an image from --> 2075 <member len="swapchainCount">const <type>uint32_t</type>* <name>pImageIndices</name></member> <!-- Indices of which swapchain images to present --> 2076 <member optional="true" len="swapchainCount"><type>VkResult</type>* <name>pResults</name></member> <!-- Optional (i.e. if non-NULL) VkResult for each swapchain --> 2077 <validity> 2078 <usage>Any given element of pname:pImageIndices must: be the index of a presentable image acquired from the swapchain specified by the corresponding element of the pname:pSwapchains array that is owned by the application</usage> 2079 <usage>Any given element of sname:VkSemaphore in pname:pWaitSemaphores must: refer to a prior signal of that sname:VkSemaphore that won't be consumed by any other wait on that semaphore</usage> 2080 </validity> 2081 </type> 2082 <type category="struct" name="VkDebugReportCallbackCreateInfoEXT"> 2083 <member><type>VkStructureType</type> <name>sType</name></member> <!-- Must be VK_STRUCTURE_TYPE_DEBUG_REPORT_CALLBACK_CREATE_INFO --> 2084 <member>const <type>void</type>* <name>pNext</name></member> <!-- Pointer to next structure --> 2085 <member><type>VkDebugReportFlagsEXT</type> <name>flags</name></member> <!-- Indicates which events call this callback--> 2086 <member><type>PFN_vkDebugReportCallbackEXT</type> <name>pfnCallback</name></member> <!-- Function pointer of a callback function--> 2087 <member optional="true"><type>void</type>* <name>pUserData</name></member> <!-- User data provided to callback function --> 2088 </type> 2089 </types> 2090 2091 <!-- SECTION: Vulkan enumerant (token) definitions. --> 2092 2093 <enums name="API Constants" comment="Misc. hardcoded constants - not an enumerated type"> 2094 <!-- This is part of the header boilerplate --> 2095 <enum value="256" name="VK_MAX_PHYSICAL_DEVICE_NAME_SIZE"/> 2096 <enum value="16" name="VK_UUID_SIZE"/> 2097 <enum value="256" name="VK_MAX_EXTENSION_NAME_SIZE"/> 2098 <enum value="256" name="VK_MAX_DESCRIPTION_SIZE"/> 2099 <enum value="32" name="VK_MAX_MEMORY_TYPES"/> 2100 <enum value="16" name="VK_MAX_MEMORY_HEAPS"/> <!-- The maximum number of unique memory heaps, each of which supporting 1 or more memory types. --> 2101 <enum value="1000.0f" name="VK_LOD_CLAMP_NONE"/> 2102 <enum value="(~0U)" name="VK_REMAINING_MIP_LEVELS"/> 2103 <enum value="(~0U)" name="VK_REMAINING_ARRAY_LAYERS"/> 2104 <enum value="(~0ULL)" name="VK_WHOLE_SIZE"/> 2105 <enum value="(~0U)" name="VK_ATTACHMENT_UNUSED"/> 2106 <enum value="1" name="VK_TRUE"/> 2107 <enum value="0" name="VK_FALSE"/> 2108 <enum value="(~0U)" name="VK_QUEUE_FAMILY_IGNORED"/> 2109 <enum value="(~0U)" name="VK_SUBPASS_EXTERNAL"/> 2110 </enums> 2111 2112 <!-- Unlike OpenGL, most tokens in Vulkan are actual typed enumerants in 2113 their own numeric namespaces. The "name" attribute is the C enum 2114 type name, and is pulled in from a <type> definition above 2115 (slightly clunky, but retains the type / enum distinction). "type" 2116 attributes of "enum" or "bitmask" indicate that these values should 2117 be generated inside an appropriate definition. --> 2118 2119 <enums name="VkImageLayout" type="enum" expand="VK_IMAGE_LAYOUT"> 2120 <enum value="0" name="VK_IMAGE_LAYOUT_UNDEFINED" comment="Implicit layout an image is when its contents are undefined due to various reasons (e.g. right after creation)"/> 2121 <enum value="1" name="VK_IMAGE_LAYOUT_GENERAL" comment="General layout when image can be used for any kind of access"/> 2122 <enum value="2" name="VK_IMAGE_LAYOUT_COLOR_ATTACHMENT_OPTIMAL" comment="Optimal layout when image is only used for color attachment read/write"/> 2123 <enum value="3" name="VK_IMAGE_LAYOUT_DEPTH_STENCIL_ATTACHMENT_OPTIMAL" comment="Optimal layout when image is only used for depth/stencil attachment read/write"/> 2124 <enum value="4" name="VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL" comment="Optimal layout when image is used for read only depth/stencil attachment and shader access"/> 2125 <enum value="5" name="VK_IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMAL" comment="Optimal layout when image is used for read only shader access"/> 2126 <enum value="6" name="VK_IMAGE_LAYOUT_TRANSFER_SRC_OPTIMAL" comment="Optimal layout when image is used only as source of transfer operations"/> 2127 <enum value="7" name="VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL" comment="Optimal layout when image is used only as destination of transfer operations"/> 2128 <enum value="8" name="VK_IMAGE_LAYOUT_PREINITIALIZED" comment="Initial layout used when the data is populated by the CPU"/> 2129 </enums> 2130 <enums name="VkAttachmentLoadOp" type="enum" expand="VK_ATTACHMENT_LOAD_OP"> 2131 <enum value="0" name="VK_ATTACHMENT_LOAD_OP_LOAD"/> 2132 <enum value="1" name="VK_ATTACHMENT_LOAD_OP_CLEAR"/> 2133 <enum value="2" name="VK_ATTACHMENT_LOAD_OP_DONT_CARE"/> 2134 </enums> 2135 <enums name="VkAttachmentStoreOp" type="enum" expand="VK_ATTACHMENT_STORE_OP"> 2136 <enum value="0" name="VK_ATTACHMENT_STORE_OP_STORE"/> 2137 <enum value="1" name="VK_ATTACHMENT_STORE_OP_DONT_CARE"/> 2138 </enums> 2139 <enums name="VkImageType" type="enum" expand="VK_IMAGE_TYPE"> 2140 <enum value="0" name="VK_IMAGE_TYPE_1D"/> 2141 <enum value="1" name="VK_IMAGE_TYPE_2D"/> 2142 <enum value="2" name="VK_IMAGE_TYPE_3D"/> 2143 </enums> 2144 <enums name="VkImageTiling" type="enum" expand="VK_IMAGE_TILING"> 2145 <enum value="0" name="VK_IMAGE_TILING_OPTIMAL"/> 2146 <enum value="1" name="VK_IMAGE_TILING_LINEAR"/> 2147 </enums> 2148 <enums name="VkImageViewType" type="enum" expand="VK_IMAGE_VIEW_TYPE"> 2149 <enum value="0" name="VK_IMAGE_VIEW_TYPE_1D"/> 2150 <enum value="1" name="VK_IMAGE_VIEW_TYPE_2D"/> 2151 <enum value="2" name="VK_IMAGE_VIEW_TYPE_3D"/> 2152 <enum value="3" name="VK_IMAGE_VIEW_TYPE_CUBE"/> 2153 <enum value="4" name="VK_IMAGE_VIEW_TYPE_1D_ARRAY"/> 2154 <enum value="5" name="VK_IMAGE_VIEW_TYPE_2D_ARRAY"/> 2155 <enum value="6" name="VK_IMAGE_VIEW_TYPE_CUBE_ARRAY"/> 2156 </enums> 2157 <enums name="VkCommandBufferLevel" type="enum" expand="VK_COMMAND_BUFFER_LEVEL"> 2158 <enum value="0" name="VK_COMMAND_BUFFER_LEVEL_PRIMARY"/> 2159 <enum value="1" name="VK_COMMAND_BUFFER_LEVEL_SECONDARY"/> 2160 </enums> 2161 <enums name="VkComponentSwizzle" type="enum" expand="VK_COMPONENT_SWIZZLE"> 2162 <enum value="0" name="VK_COMPONENT_SWIZZLE_IDENTITY"/> 2163 <enum value="1" name="VK_COMPONENT_SWIZZLE_ZERO"/> 2164 <enum value="2" name="VK_COMPONENT_SWIZZLE_ONE"/> 2165 <enum value="3" name="VK_COMPONENT_SWIZZLE_R"/> 2166 <enum value="4" name="VK_COMPONENT_SWIZZLE_G"/> 2167 <enum value="5" name="VK_COMPONENT_SWIZZLE_B"/> 2168 <enum value="6" name="VK_COMPONENT_SWIZZLE_A"/> 2169 </enums> 2170 <enums name="VkDescriptorType" type="enum" expand="VK_DESCRIPTOR_TYPE"> 2171 <enum value="0" name="VK_DESCRIPTOR_TYPE_SAMPLER"/> 2172 <enum value="1" name="VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER"/> 2173 <enum value="2" name="VK_DESCRIPTOR_TYPE_SAMPLED_IMAGE"/> 2174 <enum value="3" name="VK_DESCRIPTOR_TYPE_STORAGE_IMAGE"/> 2175 <enum value="4" name="VK_DESCRIPTOR_TYPE_UNIFORM_TEXEL_BUFFER"/> 2176 <enum value="5" name="VK_DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER"/> 2177 <enum value="6" name="VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER"/> 2178 <enum value="7" name="VK_DESCRIPTOR_TYPE_STORAGE_BUFFER"/> 2179 <enum value="8" name="VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER_DYNAMIC"/> 2180 <enum value="9" name="VK_DESCRIPTOR_TYPE_STORAGE_BUFFER_DYNAMIC"/> 2181 <enum value="10" name="VK_DESCRIPTOR_TYPE_INPUT_ATTACHMENT"/> 2182 </enums> 2183 <enums name="VkQueryType" type="enum" expand="VK_QUERY_TYPE"> 2184 <enum value="0" name="VK_QUERY_TYPE_OCCLUSION"/> 2185 <enum value="1" name="VK_QUERY_TYPE_PIPELINE_STATISTICS" comment="Optional"/> 2186 <enum value="2" name="VK_QUERY_TYPE_TIMESTAMP"/> 2187 </enums> 2188 <enums name="VkBorderColor" type="enum" expand="VK_BORDER_COLOR"> 2189 <enum value="0" name="VK_BORDER_COLOR_FLOAT_TRANSPARENT_BLACK"/> 2190 <enum value="1" name="VK_BORDER_COLOR_INT_TRANSPARENT_BLACK"/> 2191 <enum value="2" name="VK_BORDER_COLOR_FLOAT_OPAQUE_BLACK"/> 2192 <enum value="3" name="VK_BORDER_COLOR_INT_OPAQUE_BLACK"/> 2193 <enum value="4" name="VK_BORDER_COLOR_FLOAT_OPAQUE_WHITE"/> 2194 <enum value="5" name="VK_BORDER_COLOR_INT_OPAQUE_WHITE"/> 2195 </enums> 2196 <enums name="VkPipelineBindPoint" type="enum" expand="VK_PIPELINE_BIND_POINT"> 2197 <enum value="0" name="VK_PIPELINE_BIND_POINT_GRAPHICS"/> 2198 <enum value="1" name="VK_PIPELINE_BIND_POINT_COMPUTE"/> 2199 </enums> 2200 <enums name="VkPipelineCacheHeaderVersion" type="enum" expand="VK_PIPELINE_CACHE_HEADER_VERSION"> 2201 <enum value="1" name="VK_PIPELINE_CACHE_HEADER_VERSION_ONE"/> 2202 </enums> 2203 <enums name="VkPrimitiveTopology" type="enum" expand="VK_PRIMITIVE_TOPOLOGY"> 2204 <enum value="0" name="VK_PRIMITIVE_TOPOLOGY_POINT_LIST"/> 2205 <enum value="1" name="VK_PRIMITIVE_TOPOLOGY_LINE_LIST"/> 2206 <enum value="2" name="VK_PRIMITIVE_TOPOLOGY_LINE_STRIP"/> 2207 <enum value="3" name="VK_PRIMITIVE_TOPOLOGY_TRIANGLE_LIST"/> 2208 <enum value="4" name="VK_PRIMITIVE_TOPOLOGY_TRIANGLE_STRIP"/> 2209 <enum value="5" name="VK_PRIMITIVE_TOPOLOGY_TRIANGLE_FAN"/> 2210 <enum value="6" name="VK_PRIMITIVE_TOPOLOGY_LINE_LIST_WITH_ADJACENCY"/> 2211 <enum value="7" name="VK_PRIMITIVE_TOPOLOGY_LINE_STRIP_WITH_ADJACENCY"/> 2212 <enum value="8" name="VK_PRIMITIVE_TOPOLOGY_TRIANGLE_LIST_WITH_ADJACENCY"/> 2213 <enum value="9" name="VK_PRIMITIVE_TOPOLOGY_TRIANGLE_STRIP_WITH_ADJACENCY"/> 2214 <enum value="10" name="VK_PRIMITIVE_TOPOLOGY_PATCH_LIST"/> 2215 </enums> 2216 <enums name="VkSharingMode" type="enum" expand="VK_SHARING_MODE"> 2217 <enum value="0" name="VK_SHARING_MODE_EXCLUSIVE"/> 2218 <enum value="1" name="VK_SHARING_MODE_CONCURRENT"/> 2219 </enums> 2220 <enums name="VkIndexType" type="enum" expand="VK_INDEX_TYPE"> 2221 <enum value="0" name="VK_INDEX_TYPE_UINT16"/> 2222 <enum value="1" name="VK_INDEX_TYPE_UINT32"/> 2223 </enums> 2224 <enums name="VkFilter" type="enum" expand="VK_FILTER"> 2225 <enum value="0" name="VK_FILTER_NEAREST"/> 2226 <enum value="1" name="VK_FILTER_LINEAR"/> 2227 </enums> 2228 <enums name="VkSamplerMipmapMode" type="enum" expand="VK_SAMPLER_MIPMAP_MODE"> 2229 <enum value="0" name="VK_SAMPLER_MIPMAP_MODE_NEAREST" comment="Choose nearest mip level"/> 2230 <enum value="1" name="VK_SAMPLER_MIPMAP_MODE_LINEAR" comment="Linear filter between mip levels"/> 2231 </enums> 2232 <enums name="VkSamplerAddressMode" type="enum" expand="VK_SAMPLER_ADDRESS_MODE"> 2233 <enum value="0" name="VK_SAMPLER_ADDRESS_MODE_REPEAT"/> 2234 <enum value="1" name="VK_SAMPLER_ADDRESS_MODE_MIRRORED_REPEAT"/> 2235 <enum value="2" name="VK_SAMPLER_ADDRESS_MODE_CLAMP_TO_EDGE"/> 2236 <enum value="3" name="VK_SAMPLER_ADDRESS_MODE_CLAMP_TO_BORDER"/> 2237 <enum value="4" name="VK_SAMPLER_ADDRESS_MODE_MIRROR_CLAMP_TO_EDGE"/> 2238 </enums> 2239 <enums name="VkCompareOp" type="enum" expand="VK_COMPARE_OP"> 2240 <enum value="0" name="VK_COMPARE_OP_NEVER"/> 2241 <enum value="1" name="VK_COMPARE_OP_LESS"/> 2242 <enum value="2" name="VK_COMPARE_OP_EQUAL"/> 2243 <enum value="3" name="VK_COMPARE_OP_LESS_OR_EQUAL"/> 2244 <enum value="4" name="VK_COMPARE_OP_GREATER"/> 2245 <enum value="5" name="VK_COMPARE_OP_NOT_EQUAL"/> 2246 <enum value="6" name="VK_COMPARE_OP_GREATER_OR_EQUAL"/> 2247 <enum value="7" name="VK_COMPARE_OP_ALWAYS"/> 2248 </enums> 2249 <enums name="VkPolygonMode" type="enum" expand="VK_POLYGON_MODE"> 2250 <enum value="0" name="VK_POLYGON_MODE_FILL"/> 2251 <enum value="1" name="VK_POLYGON_MODE_LINE"/> 2252 <enum value="2" name="VK_POLYGON_MODE_POINT"/> 2253 </enums> 2254 <enums name="VkCullModeFlagBits" type="bitmask"> 2255 <enum value="0" name="VK_CULL_MODE_NONE"/> 2256 <enum bitpos="0" name="VK_CULL_MODE_FRONT_BIT"/> 2257 <enum bitpos="1" name="VK_CULL_MODE_BACK_BIT"/> 2258 <enum value="0x3" name="VK_CULL_MODE_FRONT_AND_BACK"/> 2259 </enums> 2260 <enums name="VkFrontFace" type="enum" expand="VK_FRONT_FACE"> 2261 <enum value="0" name="VK_FRONT_FACE_COUNTER_CLOCKWISE"/> 2262 <enum value="1" name="VK_FRONT_FACE_CLOCKWISE"/> 2263 </enums> 2264 <enums name="VkBlendFactor" type="enum" expand="VK_BLEND_FACTOR"> 2265 <enum value="0" name="VK_BLEND_FACTOR_ZERO"/> 2266 <enum value="1" name="VK_BLEND_FACTOR_ONE"/> 2267 <enum value="2" name="VK_BLEND_FACTOR_SRC_COLOR"/> 2268 <enum value="3" name="VK_BLEND_FACTOR_ONE_MINUS_SRC_COLOR"/> 2269 <enum value="4" name="VK_BLEND_FACTOR_DST_COLOR"/> 2270 <enum value="5" name="VK_BLEND_FACTOR_ONE_MINUS_DST_COLOR"/> 2271 <enum value="6" name="VK_BLEND_FACTOR_SRC_ALPHA"/> 2272 <enum value="7" name="VK_BLEND_FACTOR_ONE_MINUS_SRC_ALPHA"/> 2273 <enum value="8" name="VK_BLEND_FACTOR_DST_ALPHA"/> 2274 <enum value="9" name="VK_BLEND_FACTOR_ONE_MINUS_DST_ALPHA"/> 2275 <enum value="10" name="VK_BLEND_FACTOR_CONSTANT_COLOR"/> 2276 <enum value="11" name="VK_BLEND_FACTOR_ONE_MINUS_CONSTANT_COLOR"/> 2277 <enum value="12" name="VK_BLEND_FACTOR_CONSTANT_ALPHA"/> 2278 <enum value="13" name="VK_BLEND_FACTOR_ONE_MINUS_CONSTANT_ALPHA"/> 2279 <enum value="14" name="VK_BLEND_FACTOR_SRC_ALPHA_SATURATE"/> 2280 <enum value="15" name="VK_BLEND_FACTOR_SRC1_COLOR"/> 2281 <enum value="16" name="VK_BLEND_FACTOR_ONE_MINUS_SRC1_COLOR"/> 2282 <enum value="17" name="VK_BLEND_FACTOR_SRC1_ALPHA"/> 2283 <enum value="18" name="VK_BLEND_FACTOR_ONE_MINUS_SRC1_ALPHA"/> 2284 </enums> 2285 <enums name="VkBlendOp" type="enum" expand="VK_BLEND_OP"> 2286 <enum value="0" name="VK_BLEND_OP_ADD"/> 2287 <enum value="1" name="VK_BLEND_OP_SUBTRACT"/> 2288 <enum value="2" name="VK_BLEND_OP_REVERSE_SUBTRACT"/> 2289 <enum value="3" name="VK_BLEND_OP_MIN"/> 2290 <enum value="4" name="VK_BLEND_OP_MAX"/> 2291 </enums> 2292 <enums name="VkStencilOp" type="enum" expand="VK_STENCIL_OP"> 2293 <enum value="0" name="VK_STENCIL_OP_KEEP"/> 2294 <enum value="1" name="VK_STENCIL_OP_ZERO"/> 2295 <enum value="2" name="VK_STENCIL_OP_REPLACE"/> 2296 <enum value="3" name="VK_STENCIL_OP_INCREMENT_AND_CLAMP"/> 2297 <enum value="4" name="VK_STENCIL_OP_DECREMENT_AND_CLAMP"/> 2298 <enum value="5" name="VK_STENCIL_OP_INVERT"/> 2299 <enum value="6" name="VK_STENCIL_OP_INCREMENT_AND_WRAP"/> 2300 <enum value="7" name="VK_STENCIL_OP_DECREMENT_AND_WRAP"/> 2301 </enums> 2302 <enums name="VkLogicOp" type="enum" expand="VK_LOGIC_OP"> 2303 <enum value="0" name="VK_LOGIC_OP_CLEAR"/> 2304 <enum value="1" name="VK_LOGIC_OP_AND"/> 2305 <enum value="2" name="VK_LOGIC_OP_AND_REVERSE"/> 2306 <enum value="3" name="VK_LOGIC_OP_COPY"/> 2307 <enum value="4" name="VK_LOGIC_OP_AND_INVERTED"/> 2308 <enum value="5" name="VK_LOGIC_OP_NO_OP"/> 2309 <enum value="6" name="VK_LOGIC_OP_XOR"/> 2310 <enum value="7" name="VK_LOGIC_OP_OR"/> 2311 <enum value="8" name="VK_LOGIC_OP_NOR"/> 2312 <enum value="9" name="VK_LOGIC_OP_EQUIVALENT"/> 2313 <enum value="10" name="VK_LOGIC_OP_INVERT"/> 2314 <enum value="11" name="VK_LOGIC_OP_OR_REVERSE"/> 2315 <enum value="12" name="VK_LOGIC_OP_COPY_INVERTED"/> 2316 <enum value="13" name="VK_LOGIC_OP_OR_INVERTED"/> 2317 <enum value="14" name="VK_LOGIC_OP_NAND"/> 2318 <enum value="15" name="VK_LOGIC_OP_SET"/> 2319 </enums> 2320 <enums name="VkInternalAllocationType" type="enum" expand="VK_INTERNAL_ALLOCATION_TYPE"> 2321 <enum value="0" name="VK_INTERNAL_ALLOCATION_TYPE_EXECUTABLE"/> 2322 </enums> 2323 <enums name="VkSystemAllocationScope" type="enum" expand="VK_SYSTEM_ALLOCATION_SCOPE"> 2324 <enum value="0" name="VK_SYSTEM_ALLOCATION_SCOPE_COMMAND"/> 2325 <enum value="1" name="VK_SYSTEM_ALLOCATION_SCOPE_OBJECT"/> 2326 <enum value="2" name="VK_SYSTEM_ALLOCATION_SCOPE_CACHE"/> 2327 <enum value="3" name="VK_SYSTEM_ALLOCATION_SCOPE_DEVICE"/> 2328 <enum value="4" name="VK_SYSTEM_ALLOCATION_SCOPE_INSTANCE"/> 2329 </enums> 2330 <enums name="VkPhysicalDeviceType" type="enum" expand="VK_PHYSICAL_DEVICE_TYPE"> 2331 <enum value="0" name="VK_PHYSICAL_DEVICE_TYPE_OTHER"/> 2332 <enum value="1" name="VK_PHYSICAL_DEVICE_TYPE_INTEGRATED_GPU"/> 2333 <enum value="2" name="VK_PHYSICAL_DEVICE_TYPE_DISCRETE_GPU"/> 2334 <enum value="3" name="VK_PHYSICAL_DEVICE_TYPE_VIRTUAL_GPU"/> 2335 <enum value="4" name="VK_PHYSICAL_DEVICE_TYPE_CPU"/> 2336 </enums> 2337 <enums name="VkVertexInputRate" type="enum" expand="VK_VERTEX_INPUT_RATE"> 2338 <enum value="0" name="VK_VERTEX_INPUT_RATE_VERTEX"/> 2339 <enum value="1" name="VK_VERTEX_INPUT_RATE_INSTANCE"/> 2340 </enums> 2341 <enums name="VkFormat" type="enum" expand="VK_FORMAT" comment="Vulkan format definitions"> 2342 <enum value="0" name="VK_FORMAT_UNDEFINED"/> 2343 <enum value="1" name="VK_FORMAT_R4G4_UNORM_PACK8"/> 2344 <enum value="2" name="VK_FORMAT_R4G4B4A4_UNORM_PACK16"/> 2345 <enum value="3" name="VK_FORMAT_B4G4R4A4_UNORM_PACK16"/> 2346 <enum value="4" name="VK_FORMAT_R5G6B5_UNORM_PACK16"/> 2347 <enum value="5" name="VK_FORMAT_B5G6R5_UNORM_PACK16"/> 2348 <enum value="6" name="VK_FORMAT_R5G5B5A1_UNORM_PACK16"/> 2349 <enum value="7" name="VK_FORMAT_B5G5R5A1_UNORM_PACK16"/> 2350 <enum value="8" name="VK_FORMAT_A1R5G5B5_UNORM_PACK16"/> 2351 <enum value="9" name="VK_FORMAT_R8_UNORM"/> 2352 <enum value="10" name="VK_FORMAT_R8_SNORM"/> 2353 <enum value="11" name="VK_FORMAT_R8_USCALED"/> 2354 <enum value="12" name="VK_FORMAT_R8_SSCALED"/> 2355 <enum value="13" name="VK_FORMAT_R8_UINT"/> 2356 <enum value="14" name="VK_FORMAT_R8_SINT"/> 2357 <enum value="15" name="VK_FORMAT_R8_SRGB"/> 2358 <enum value="16" name="VK_FORMAT_R8G8_UNORM"/> 2359 <enum value="17" name="VK_FORMAT_R8G8_SNORM"/> 2360 <enum value="18" name="VK_FORMAT_R8G8_USCALED"/> 2361 <enum value="19" name="VK_FORMAT_R8G8_SSCALED"/> 2362 <enum value="20" name="VK_FORMAT_R8G8_UINT"/> 2363 <enum value="21" name="VK_FORMAT_R8G8_SINT"/> 2364 <enum value="22" name="VK_FORMAT_R8G8_SRGB"/> 2365 <enum value="23" name="VK_FORMAT_R8G8B8_UNORM"/> 2366 <enum value="24" name="VK_FORMAT_R8G8B8_SNORM"/> 2367 <enum value="25" name="VK_FORMAT_R8G8B8_USCALED"/> 2368 <enum value="26" name="VK_FORMAT_R8G8B8_SSCALED"/> 2369 <enum value="27" name="VK_FORMAT_R8G8B8_UINT"/> 2370 <enum value="28" name="VK_FORMAT_R8G8B8_SINT"/> 2371 <enum value="29" name="VK_FORMAT_R8G8B8_SRGB"/> 2372 <enum value="30" name="VK_FORMAT_B8G8R8_UNORM"/> 2373 <enum value="31" name="VK_FORMAT_B8G8R8_SNORM"/> 2374 <enum value="32" name="VK_FORMAT_B8G8R8_USCALED"/> 2375 <enum value="33" name="VK_FORMAT_B8G8R8_SSCALED"/> 2376 <enum value="34" name="VK_FORMAT_B8G8R8_UINT"/> 2377 <enum value="35" name="VK_FORMAT_B8G8R8_SINT"/> 2378 <enum value="36" name="VK_FORMAT_B8G8R8_SRGB"/> 2379 <enum value="37" name="VK_FORMAT_R8G8B8A8_UNORM"/> 2380 <enum value="38" name="VK_FORMAT_R8G8B8A8_SNORM"/> 2381 <enum value="39" name="VK_FORMAT_R8G8B8A8_USCALED"/> 2382 <enum value="40" name="VK_FORMAT_R8G8B8A8_SSCALED"/> 2383 <enum value="41" name="VK_FORMAT_R8G8B8A8_UINT"/> 2384 <enum value="42" name="VK_FORMAT_R8G8B8A8_SINT"/> 2385 <enum value="43" name="VK_FORMAT_R8G8B8A8_SRGB"/> 2386 <enum value="44" name="VK_FORMAT_B8G8R8A8_UNORM"/> 2387 <enum value="45" name="VK_FORMAT_B8G8R8A8_SNORM"/> 2388 <enum value="46" name="VK_FORMAT_B8G8R8A8_USCALED"/> 2389 <enum value="47" name="VK_FORMAT_B8G8R8A8_SSCALED"/> 2390 <enum value="48" name="VK_FORMAT_B8G8R8A8_UINT"/> 2391 <enum value="49" name="VK_FORMAT_B8G8R8A8_SINT"/> 2392 <enum value="50" name="VK_FORMAT_B8G8R8A8_SRGB"/> 2393 <enum value="51" name="VK_FORMAT_A8B8G8R8_UNORM_PACK32"/> 2394 <enum value="52" name="VK_FORMAT_A8B8G8R8_SNORM_PACK32"/> 2395 <enum value="53" name="VK_FORMAT_A8B8G8R8_USCALED_PACK32"/> 2396 <enum value="54" name="VK_FORMAT_A8B8G8R8_SSCALED_PACK32"/> 2397 <enum value="55" name="VK_FORMAT_A8B8G8R8_UINT_PACK32"/> 2398 <enum value="56" name="VK_FORMAT_A8B8G8R8_SINT_PACK32"/> 2399 <enum value="57" name="VK_FORMAT_A8B8G8R8_SRGB_PACK32"/> 2400 <enum value="58" name="VK_FORMAT_A2R10G10B10_UNORM_PACK32"/> 2401 <enum value="59" name="VK_FORMAT_A2R10G10B10_SNORM_PACK32"/> 2402 <enum value="60" name="VK_FORMAT_A2R10G10B10_USCALED_PACK32"/> 2403 <enum value="61" name="VK_FORMAT_A2R10G10B10_SSCALED_PACK32"/> 2404 <enum value="62" name="VK_FORMAT_A2R10G10B10_UINT_PACK32"/> 2405 <enum value="63" name="VK_FORMAT_A2R10G10B10_SINT_PACK32"/> 2406 <enum value="64" name="VK_FORMAT_A2B10G10R10_UNORM_PACK32"/> 2407 <enum value="65" name="VK_FORMAT_A2B10G10R10_SNORM_PACK32"/> 2408 <enum value="66" name="VK_FORMAT_A2B10G10R10_USCALED_PACK32"/> 2409 <enum value="67" name="VK_FORMAT_A2B10G10R10_SSCALED_PACK32"/> 2410 <enum value="68" name="VK_FORMAT_A2B10G10R10_UINT_PACK32"/> 2411 <enum value="69" name="VK_FORMAT_A2B10G10R10_SINT_PACK32"/> 2412 <enum value="70" name="VK_FORMAT_R16_UNORM"/> 2413 <enum value="71" name="VK_FORMAT_R16_SNORM"/> 2414 <enum value="72" name="VK_FORMAT_R16_USCALED"/> 2415 <enum value="73" name="VK_FORMAT_R16_SSCALED"/> 2416 <enum value="74" name="VK_FORMAT_R16_UINT"/> 2417 <enum value="75" name="VK_FORMAT_R16_SINT"/> 2418 <enum value="76" name="VK_FORMAT_R16_SFLOAT"/> 2419 <enum value="77" name="VK_FORMAT_R16G16_UNORM"/> 2420 <enum value="78" name="VK_FORMAT_R16G16_SNORM"/> 2421 <enum value="79" name="VK_FORMAT_R16G16_USCALED"/> 2422 <enum value="80" name="VK_FORMAT_R16G16_SSCALED"/> 2423 <enum value="81" name="VK_FORMAT_R16G16_UINT"/> 2424 <enum value="82" name="VK_FORMAT_R16G16_SINT"/> 2425 <enum value="83" name="VK_FORMAT_R16G16_SFLOAT"/> 2426 <enum value="84" name="VK_FORMAT_R16G16B16_UNORM"/> 2427 <enum value="85" name="VK_FORMAT_R16G16B16_SNORM"/> 2428 <enum value="86" name="VK_FORMAT_R16G16B16_USCALED"/> 2429 <enum value="87" name="VK_FORMAT_R16G16B16_SSCALED"/> 2430 <enum value="88" name="VK_FORMAT_R16G16B16_UINT"/> 2431 <enum value="89" name="VK_FORMAT_R16G16B16_SINT"/> 2432 <enum value="90" name="VK_FORMAT_R16G16B16_SFLOAT"/> 2433 <enum value="91" name="VK_FORMAT_R16G16B16A16_UNORM"/> 2434 <enum value="92" name="VK_FORMAT_R16G16B16A16_SNORM"/> 2435 <enum value="93" name="VK_FORMAT_R16G16B16A16_USCALED"/> 2436 <enum value="94" name="VK_FORMAT_R16G16B16A16_SSCALED"/> 2437 <enum value="95" name="VK_FORMAT_R16G16B16A16_UINT"/> 2438 <enum value="96" name="VK_FORMAT_R16G16B16A16_SINT"/> 2439 <enum value="97" name="VK_FORMAT_R16G16B16A16_SFLOAT"/> 2440 <enum value="98" name="VK_FORMAT_R32_UINT"/> 2441 <enum value="99" name="VK_FORMAT_R32_SINT"/> 2442 <enum value="100" name="VK_FORMAT_R32_SFLOAT"/> 2443 <enum value="101" name="VK_FORMAT_R32G32_UINT"/> 2444 <enum value="102" name="VK_FORMAT_R32G32_SINT"/> 2445 <enum value="103" name="VK_FORMAT_R32G32_SFLOAT"/> 2446 <enum value="104" name="VK_FORMAT_R32G32B32_UINT"/> 2447 <enum value="105" name="VK_FORMAT_R32G32B32_SINT"/> 2448 <enum value="106" name="VK_FORMAT_R32G32B32_SFLOAT"/> 2449 <enum value="107" name="VK_FORMAT_R32G32B32A32_UINT"/> 2450 <enum value="108" name="VK_FORMAT_R32G32B32A32_SINT"/> 2451 <enum value="109" name="VK_FORMAT_R32G32B32A32_SFLOAT"/> 2452 <enum value="110" name="VK_FORMAT_R64_UINT"/> 2453 <enum value="111" name="VK_FORMAT_R64_SINT"/> 2454 <enum value="112" name="VK_FORMAT_R64_SFLOAT"/> 2455 <enum value="113" name="VK_FORMAT_R64G64_UINT"/> 2456 <enum value="114" name="VK_FORMAT_R64G64_SINT"/> 2457 <enum value="115" name="VK_FORMAT_R64G64_SFLOAT"/> 2458 <enum value="116" name="VK_FORMAT_R64G64B64_UINT"/> 2459 <enum value="117" name="VK_FORMAT_R64G64B64_SINT"/> 2460 <enum value="118" name="VK_FORMAT_R64G64B64_SFLOAT"/> 2461 <enum value="119" name="VK_FORMAT_R64G64B64A64_UINT"/> 2462 <enum value="120" name="VK_FORMAT_R64G64B64A64_SINT"/> 2463 <enum value="121" name="VK_FORMAT_R64G64B64A64_SFLOAT"/> 2464 <enum value="122" name="VK_FORMAT_B10G11R11_UFLOAT_PACK32"/> 2465 <enum value="123" name="VK_FORMAT_E5B9G9R9_UFLOAT_PACK32"/> 2466 <enum value="124" name="VK_FORMAT_D16_UNORM"/> 2467 <enum value="125" name="VK_FORMAT_X8_D24_UNORM_PACK32"/> 2468 <enum value="126" name="VK_FORMAT_D32_SFLOAT"/> 2469 <enum value="127" name="VK_FORMAT_S8_UINT"/> 2470 <enum value="128" name="VK_FORMAT_D16_UNORM_S8_UINT"/> 2471 <enum value="129" name="VK_FORMAT_D24_UNORM_S8_UINT"/> 2472 <enum value="130" name="VK_FORMAT_D32_SFLOAT_S8_UINT"/> 2473 <enum value="131" name="VK_FORMAT_BC1_RGB_UNORM_BLOCK"/> 2474 <enum value="132" name="VK_FORMAT_BC1_RGB_SRGB_BLOCK"/> 2475 <enum value="133" name="VK_FORMAT_BC1_RGBA_UNORM_BLOCK"/> 2476 <enum value="134" name="VK_FORMAT_BC1_RGBA_SRGB_BLOCK"/> 2477 <enum value="135" name="VK_FORMAT_BC2_UNORM_BLOCK"/> 2478 <enum value="136" name="VK_FORMAT_BC2_SRGB_BLOCK"/> 2479 <enum value="137" name="VK_FORMAT_BC3_UNORM_BLOCK"/> 2480 <enum value="138" name="VK_FORMAT_BC3_SRGB_BLOCK"/> 2481 <enum value="139" name="VK_FORMAT_BC4_UNORM_BLOCK"/> 2482 <enum value="140" name="VK_FORMAT_BC4_SNORM_BLOCK"/> 2483 <enum value="141" name="VK_FORMAT_BC5_UNORM_BLOCK"/> 2484 <enum value="142" name="VK_FORMAT_BC5_SNORM_BLOCK"/> 2485 <enum value="143" name="VK_FORMAT_BC6H_UFLOAT_BLOCK"/> 2486 <enum value="144" name="VK_FORMAT_BC6H_SFLOAT_BLOCK"/> 2487 <enum value="145" name="VK_FORMAT_BC7_UNORM_BLOCK"/> 2488 <enum value="146" name="VK_FORMAT_BC7_SRGB_BLOCK"/> 2489 <enum value="147" name="VK_FORMAT_ETC2_R8G8B8_UNORM_BLOCK"/> 2490 <enum value="148" name="VK_FORMAT_ETC2_R8G8B8_SRGB_BLOCK"/> 2491 <enum value="149" name="VK_FORMAT_ETC2_R8G8B8A1_UNORM_BLOCK"/> 2492 <enum value="150" name="VK_FORMAT_ETC2_R8G8B8A1_SRGB_BLOCK"/> 2493 <enum value="151" name="VK_FORMAT_ETC2_R8G8B8A8_UNORM_BLOCK"/> 2494 <enum value="152" name="VK_FORMAT_ETC2_R8G8B8A8_SRGB_BLOCK"/> 2495 <enum value="153" name="VK_FORMAT_EAC_R11_UNORM_BLOCK"/> 2496 <enum value="154" name="VK_FORMAT_EAC_R11_SNORM_BLOCK"/> 2497 <enum value="155" name="VK_FORMAT_EAC_R11G11_UNORM_BLOCK"/> 2498 <enum value="156" name="VK_FORMAT_EAC_R11G11_SNORM_BLOCK"/> 2499 <enum value="157" name="VK_FORMAT_ASTC_4x4_UNORM_BLOCK"/> 2500 <enum value="158" name="VK_FORMAT_ASTC_4x4_SRGB_BLOCK"/> 2501 <enum value="159" name="VK_FORMAT_ASTC_5x4_UNORM_BLOCK"/> 2502 <enum value="160" name="VK_FORMAT_ASTC_5x4_SRGB_BLOCK"/> 2503 <enum value="161" name="VK_FORMAT_ASTC_5x5_UNORM_BLOCK"/> 2504 <enum value="162" name="VK_FORMAT_ASTC_5x5_SRGB_BLOCK"/> 2505 <enum value="163" name="VK_FORMAT_ASTC_6x5_UNORM_BLOCK"/> 2506 <enum value="164" name="VK_FORMAT_ASTC_6x5_SRGB_BLOCK"/> 2507 <enum value="165" name="VK_FORMAT_ASTC_6x6_UNORM_BLOCK"/> 2508 <enum value="166" name="VK_FORMAT_ASTC_6x6_SRGB_BLOCK"/> 2509 <enum value="167" name="VK_FORMAT_ASTC_8x5_UNORM_BLOCK"/> 2510 <enum value="168" name="VK_FORMAT_ASTC_8x5_SRGB_BLOCK"/> 2511 <enum value="169" name="VK_FORMAT_ASTC_8x6_UNORM_BLOCK"/> 2512 <enum value="170" name="VK_FORMAT_ASTC_8x6_SRGB_BLOCK"/> 2513 <enum value="171" name="VK_FORMAT_ASTC_8x8_UNORM_BLOCK"/> 2514 <enum value="172" name="VK_FORMAT_ASTC_8x8_SRGB_BLOCK"/> 2515 <enum value="173" name="VK_FORMAT_ASTC_10x5_UNORM_BLOCK"/> 2516 <enum value="174" name="VK_FORMAT_ASTC_10x5_SRGB_BLOCK"/> 2517 <enum value="175" name="VK_FORMAT_ASTC_10x6_UNORM_BLOCK"/> 2518 <enum value="176" name="VK_FORMAT_ASTC_10x6_SRGB_BLOCK"/> 2519 <enum value="177" name="VK_FORMAT_ASTC_10x8_UNORM_BLOCK"/> 2520 <enum value="178" name="VK_FORMAT_ASTC_10x8_SRGB_BLOCK"/> 2521 <enum value="179" name="VK_FORMAT_ASTC_10x10_UNORM_BLOCK"/> 2522 <enum value="180" name="VK_FORMAT_ASTC_10x10_SRGB_BLOCK"/> 2523 <enum value="181" name="VK_FORMAT_ASTC_12x10_UNORM_BLOCK"/> 2524 <enum value="182" name="VK_FORMAT_ASTC_12x10_SRGB_BLOCK"/> 2525 <enum value="183" name="VK_FORMAT_ASTC_12x12_UNORM_BLOCK"/> 2526 <enum value="184" name="VK_FORMAT_ASTC_12x12_SRGB_BLOCK"/> 2527 </enums> 2528 <enums name="VkStructureType" type="enum" expand="VK_STRUCTURE_TYPE" comment="Structure type enumerant"> 2529 <enum value="0" name="VK_STRUCTURE_TYPE_APPLICATION_INFO"/> 2530 <enum value="1" name="VK_STRUCTURE_TYPE_INSTANCE_CREATE_INFO"/> 2531 <enum value="2" name="VK_STRUCTURE_TYPE_DEVICE_QUEUE_CREATE_INFO"/> 2532 <enum value="3" name="VK_STRUCTURE_TYPE_DEVICE_CREATE_INFO"/> 2533 <enum value="4" name="VK_STRUCTURE_TYPE_SUBMIT_INFO"/> 2534 <enum value="5" name="VK_STRUCTURE_TYPE_MEMORY_ALLOCATE_INFO"/> 2535 <enum value="6" name="VK_STRUCTURE_TYPE_MAPPED_MEMORY_RANGE"/> 2536 <enum value="7" name="VK_STRUCTURE_TYPE_BIND_SPARSE_INFO"/> 2537 <enum value="8" name="VK_STRUCTURE_TYPE_FENCE_CREATE_INFO"/> 2538 <enum value="9" name="VK_STRUCTURE_TYPE_SEMAPHORE_CREATE_INFO"/> 2539 <enum value="10" name="VK_STRUCTURE_TYPE_EVENT_CREATE_INFO"/> 2540 <enum value="11" name="VK_STRUCTURE_TYPE_QUERY_POOL_CREATE_INFO"/> 2541 <enum value="12" name="VK_STRUCTURE_TYPE_BUFFER_CREATE_INFO"/> 2542 <enum value="13" name="VK_STRUCTURE_TYPE_BUFFER_VIEW_CREATE_INFO"/> 2543 <enum value="14" name="VK_STRUCTURE_TYPE_IMAGE_CREATE_INFO"/> 2544 <enum value="15" name="VK_STRUCTURE_TYPE_IMAGE_VIEW_CREATE_INFO"/> 2545 <enum value="16" name="VK_STRUCTURE_TYPE_SHADER_MODULE_CREATE_INFO"/> 2546 <enum value="17" name="VK_STRUCTURE_TYPE_PIPELINE_CACHE_CREATE_INFO"/> 2547 <enum value="18" name="VK_STRUCTURE_TYPE_PIPELINE_SHADER_STAGE_CREATE_INFO"/> 2548 <enum value="19" name="VK_STRUCTURE_TYPE_PIPELINE_VERTEX_INPUT_STATE_CREATE_INFO"/> 2549 <enum value="20" name="VK_STRUCTURE_TYPE_PIPELINE_INPUT_ASSEMBLY_STATE_CREATE_INFO"/> 2550 <enum value="21" name="VK_STRUCTURE_TYPE_PIPELINE_TESSELLATION_STATE_CREATE_INFO"/> 2551 <enum value="22" name="VK_STRUCTURE_TYPE_PIPELINE_VIEWPORT_STATE_CREATE_INFO"/> 2552 <enum value="23" name="VK_STRUCTURE_TYPE_PIPELINE_RASTERIZATION_STATE_CREATE_INFO"/> 2553 <enum value="24" name="VK_STRUCTURE_TYPE_PIPELINE_MULTISAMPLE_STATE_CREATE_INFO"/> 2554 <enum value="25" name="VK_STRUCTURE_TYPE_PIPELINE_DEPTH_STENCIL_STATE_CREATE_INFO"/> 2555 <enum value="26" name="VK_STRUCTURE_TYPE_PIPELINE_COLOR_BLEND_STATE_CREATE_INFO"/> 2556 <enum value="27" name="VK_STRUCTURE_TYPE_PIPELINE_DYNAMIC_STATE_CREATE_INFO"/> 2557 <enum value="28" name="VK_STRUCTURE_TYPE_GRAPHICS_PIPELINE_CREATE_INFO"/> 2558 <enum value="29" name="VK_STRUCTURE_TYPE_COMPUTE_PIPELINE_CREATE_INFO"/> 2559 <enum value="30" name="VK_STRUCTURE_TYPE_PIPELINE_LAYOUT_CREATE_INFO"/> 2560 <enum value="31" name="VK_STRUCTURE_TYPE_SAMPLER_CREATE_INFO"/> 2561 <enum value="32" name="VK_STRUCTURE_TYPE_DESCRIPTOR_SET_LAYOUT_CREATE_INFO"/> 2562 <enum value="33" name="VK_STRUCTURE_TYPE_DESCRIPTOR_POOL_CREATE_INFO"/> 2563 <enum value="34" name="VK_STRUCTURE_TYPE_DESCRIPTOR_SET_ALLOCATE_INFO"/> 2564 <enum value="35" name="VK_STRUCTURE_TYPE_WRITE_DESCRIPTOR_SET"/> 2565 <enum value="36" name="VK_STRUCTURE_TYPE_COPY_DESCRIPTOR_SET"/> 2566 <enum value="37" name="VK_STRUCTURE_TYPE_FRAMEBUFFER_CREATE_INFO"/> 2567 <enum value="38" name="VK_STRUCTURE_TYPE_RENDER_PASS_CREATE_INFO"/> 2568 <enum value="39" name="VK_STRUCTURE_TYPE_COMMAND_POOL_CREATE_INFO"/> 2569 <enum value="40" name="VK_STRUCTURE_TYPE_COMMAND_BUFFER_ALLOCATE_INFO"/> 2570 <enum value="41" name="VK_STRUCTURE_TYPE_COMMAND_BUFFER_INHERITANCE_INFO"/> 2571 <enum value="42" name="VK_STRUCTURE_TYPE_COMMAND_BUFFER_BEGIN_INFO"/> 2572 <enum value="43" name="VK_STRUCTURE_TYPE_RENDER_PASS_BEGIN_INFO"/> 2573 <enum value="44" name="VK_STRUCTURE_TYPE_BUFFER_MEMORY_BARRIER"/> 2574 <enum value="45" name="VK_STRUCTURE_TYPE_IMAGE_MEMORY_BARRIER"/> 2575 <enum value="46" name="VK_STRUCTURE_TYPE_MEMORY_BARRIER"/> 2576 <enum value="47" name="VK_STRUCTURE_TYPE_LOADER_INSTANCE_CREATE_INFO"/> <!-- Reserved for internal use by the loader, layers, and ICDs --> 2577 <enum value="48" name="VK_STRUCTURE_TYPE_LOADER_DEVICE_CREATE_INFO"/> <!-- Reserved for internal use by the loader, layers, and ICDs --> 2578 </enums> 2579 <enums name="VkSubpassContents" type="enum" expand="VK_SUBPASS_CONTENTS"> 2580 <enum value="0" name="VK_SUBPASS_CONTENTS_INLINE"/> 2581 <enum value="1" name="VK_SUBPASS_CONTENTS_SECONDARY_COMMAND_BUFFERS"/> 2582 </enums> 2583 <enums name="VkResult" type="enum" expand="VK_RESULT" comment="Error and return codes"> 2584 <!-- Return codes for successful operation execution (positive values) --> 2585 <enum value="0" name="VK_SUCCESS" comment="Command completed successfully"/> 2586 <enum value="1" name="VK_NOT_READY" comment="A fence or query has not yet completed"/> 2587 <enum value="2" name="VK_TIMEOUT" comment="A wait operation has not completed in the specified time"/> 2588 <enum value="3" name="VK_EVENT_SET" comment="An event is signaled"/> 2589 <enum value="4" name="VK_EVENT_RESET" comment="An event is unsignalled"/> 2590 <enum value="5" name="VK_INCOMPLETE" comment="A return array was too small for the resul"/> 2591 <!-- Error codes (negative values) --> 2592 <enum value="-1" name="VK_ERROR_OUT_OF_HOST_MEMORY" comment="A host memory allocation has failed"/> 2593 <enum value="-2" name="VK_ERROR_OUT_OF_DEVICE_MEMORY" comment="A device memory allocation has failed"/> 2594 <enum value="-3" name="VK_ERROR_INITIALIZATION_FAILED" comment="The logical device has been lost. See <<devsandqueues-lost-device>>"/> 2595 <enum value="-4" name="VK_ERROR_DEVICE_LOST" comment="Initialization of a object has failed"/> 2596 <enum value="-5" name="VK_ERROR_MEMORY_MAP_FAILED" comment="Mapping of a memory object has failed"/> 2597 <enum value="-6" name="VK_ERROR_LAYER_NOT_PRESENT" comment="Layer specified does not exist"/> 2598 <enum value="-7" name="VK_ERROR_EXTENSION_NOT_PRESENT" comment="Extension specified does not exist"/> 2599 <enum value="-8" name="VK_ERROR_FEATURE_NOT_PRESENT" comment="Requested feature is not available on this device"/> 2600 <enum value="-9" name="VK_ERROR_INCOMPATIBLE_DRIVER" comment="Unable to find a Vulkan driver"/> 2601 <enum value="-10" name="VK_ERROR_TOO_MANY_OBJECTS" comment="Too many objects of the type have already been created"/> 2602 <enum value="-11" name="VK_ERROR_FORMAT_NOT_SUPPORTED" comment="Requested format is not supported on this device"/> 2603 <unused start="-12"/> 2604 </enums> 2605 <enums name="VkDynamicState" type="enum" expand="VK_DYNAMIC_STATE"> 2606 <enum value="0" name="VK_DYNAMIC_STATE_VIEWPORT"/> 2607 <enum value="1" name="VK_DYNAMIC_STATE_SCISSOR"/> 2608 <enum value="2" name="VK_DYNAMIC_STATE_LINE_WIDTH"/> 2609 <enum value="3" name="VK_DYNAMIC_STATE_DEPTH_BIAS"/> 2610 <enum value="4" name="VK_DYNAMIC_STATE_BLEND_CONSTANTS"/> 2611 <enum value="5" name="VK_DYNAMIC_STATE_DEPTH_BOUNDS"/> 2612 <enum value="6" name="VK_DYNAMIC_STATE_STENCIL_COMPARE_MASK"/> 2613 <enum value="7" name="VK_DYNAMIC_STATE_STENCIL_WRITE_MASK"/> 2614 <enum value="8" name="VK_DYNAMIC_STATE_STENCIL_REFERENCE"/> 2615 </enums> 2616 2617 <!-- Flags --> 2618 <enums name="VkQueueFlagBits" type="bitmask"> 2619 <enum bitpos="0" name="VK_QUEUE_GRAPHICS_BIT" comment="Queue supports graphics operations"/> 2620 <enum bitpos="1" name="VK_QUEUE_COMPUTE_BIT" comment="Queue supports compute operations"/> 2621 <enum bitpos="2" name="VK_QUEUE_TRANSFER_BIT" comment="Queue supports transfer operations"/> 2622 <enum bitpos="3" name="VK_QUEUE_SPARSE_BINDING_BIT" comment="Queue supports sparse resource memory management operations"/> 2623 </enums> 2624 <enums name="VkMemoryPropertyFlagBits" type="bitmask"> 2625 <enum bitpos="0" name="VK_MEMORY_PROPERTY_DEVICE_LOCAL_BIT" comment="If otherwise stated, then allocate memory on device"/> 2626 <enum bitpos="1" name="VK_MEMORY_PROPERTY_HOST_VISIBLE_BIT" comment="Memory is mappable by host"/> 2627 <enum bitpos="2" name="VK_MEMORY_PROPERTY_HOST_COHERENT_BIT" comment="Memory will have i/o coherency. If not set, application may need to use vkFlushMappedMemoryRanges and vkInvalidateMappedMemoryRanges to flush/invalidate host cache"/> 2628 <enum bitpos="3" name="VK_MEMORY_PROPERTY_HOST_CACHED_BIT" comment="Memory will be cached by the host"/> 2629 <enum bitpos="4" name="VK_MEMORY_PROPERTY_LAZILY_ALLOCATED_BIT" comment="Memory may be allocated by the driver when it is required"/> 2630 </enums> 2631 <enums name="VkMemoryHeapFlagBits" type="bitmask"> 2632 <enum bitpos="0" name="VK_MEMORY_HEAP_DEVICE_LOCAL_BIT" comment="If set, heap represents device memory"/> 2633 </enums> 2634 <enums name="VkAccessFlagBits" type="bitmask"> 2635 <enum bitpos="0" name="VK_ACCESS_INDIRECT_COMMAND_READ_BIT" comment="Controls coherency of indirect command reads"/> 2636 <enum bitpos="1" name="VK_ACCESS_INDEX_READ_BIT" comment="Controls coherency of index reads"/> 2637 <enum bitpos="2" name="VK_ACCESS_VERTEX_ATTRIBUTE_READ_BIT" comment="Controls coherency of vertex attribute reads"/> 2638 <enum bitpos="3" name="VK_ACCESS_UNIFORM_READ_BIT" comment="Controls coherency of uniform buffer reads"/> 2639 <enum bitpos="4" name="VK_ACCESS_INPUT_ATTACHMENT_READ_BIT" comment="Controls coherency of input attachment reads"/> 2640 <enum bitpos="5" name="VK_ACCESS_SHADER_READ_BIT" comment="Controls coherency of shader reads"/> 2641 <enum bitpos="6" name="VK_ACCESS_SHADER_WRITE_BIT" comment="Controls coherency of shader writes"/> 2642 <enum bitpos="7" name="VK_ACCESS_COLOR_ATTACHMENT_READ_BIT" comment="Controls coherency of color attachment reads"/> 2643 <enum bitpos="8" name="VK_ACCESS_COLOR_ATTACHMENT_WRITE_BIT" comment="Controls coherency of color attachment writes"/> 2644 <enum bitpos="9" name="VK_ACCESS_DEPTH_STENCIL_ATTACHMENT_READ_BIT" comment="Controls coherency of depth/stencil attachment reads"/> 2645 <enum bitpos="10" name="VK_ACCESS_DEPTH_STENCIL_ATTACHMENT_WRITE_BIT" comment="Controls coherency of depth/stencil attachment writes"/> 2646 <enum bitpos="11" name="VK_ACCESS_TRANSFER_READ_BIT" comment="Controls coherency of transfer reads"/> 2647 <enum bitpos="12" name="VK_ACCESS_TRANSFER_WRITE_BIT" comment="Controls coherency of transfer writes"/> 2648 <enum bitpos="13" name="VK_ACCESS_HOST_READ_BIT" comment="Controls coherency of host reads"/> 2649 <enum bitpos="14" name="VK_ACCESS_HOST_WRITE_BIT" comment="Controls coherency of host writes"/> 2650 <enum bitpos="15" name="VK_ACCESS_MEMORY_READ_BIT" comment="Controls coherency of memory reads"/> 2651 <enum bitpos="16" name="VK_ACCESS_MEMORY_WRITE_BIT" comment="Controls coherency of memory writes"/> 2652 </enums> 2653 <enums name="VkBufferUsageFlagBits" type="bitmask"> 2654 <enum bitpos="0" name="VK_BUFFER_USAGE_TRANSFER_SRC_BIT" comment="Can be used as a source of transfer operations"/> 2655 <enum bitpos="1" name="VK_BUFFER_USAGE_TRANSFER_DST_BIT" comment="Can be used as a destination of transfer operations"/> 2656 <enum bitpos="2" name="VK_BUFFER_USAGE_UNIFORM_TEXEL_BUFFER_BIT" comment="Can be used as TBO"/> 2657 <enum bitpos="3" name="VK_BUFFER_USAGE_STORAGE_TEXEL_BUFFER_BIT" comment="Can be used as IBO"/> 2658 <enum bitpos="4" name="VK_BUFFER_USAGE_UNIFORM_BUFFER_BIT" comment="Can be used as UBO"/> 2659 <enum bitpos="5" name="VK_BUFFER_USAGE_STORAGE_BUFFER_BIT" comment="Can be used as SSBO"/> 2660 <enum bitpos="6" name="VK_BUFFER_USAGE_INDEX_BUFFER_BIT" comment="Can be used as source of fixed-function index fetch (index buffer)"/> 2661 <enum bitpos="7" name="VK_BUFFER_USAGE_VERTEX_BUFFER_BIT" comment="Can be used as source of fixed-function vertex fetch (VBO)"/> 2662 <enum bitpos="8" name="VK_BUFFER_USAGE_INDIRECT_BUFFER_BIT" comment="Can be the source of indirect parameters (e.g. indirect buffer, parameter buffer)"/> 2663 </enums> 2664 <enums name="VkBufferCreateFlagBits" type="bitmask"> 2665 <enum bitpos="0" name="VK_BUFFER_CREATE_SPARSE_BINDING_BIT" comment="Buffer should support sparse backing"/> 2666 <enum bitpos="1" name="VK_BUFFER_CREATE_SPARSE_RESIDENCY_BIT" comment="Buffer should support sparse backing with partial residency"/> 2667 <enum bitpos="2" name="VK_BUFFER_CREATE_SPARSE_ALIASED_BIT" comment="Buffer should support constent data access to physical memory blocks mapped into multiple locations of sparse buffers"/> 2668 </enums> 2669 <enums name="VkShaderStageFlagBits" type="bitmask"> 2670 <enum bitpos="0" name="VK_SHADER_STAGE_VERTEX_BIT"/> 2671 <enum bitpos="1" name="VK_SHADER_STAGE_TESSELLATION_CONTROL_BIT"/> 2672 <enum bitpos="2" name="VK_SHADER_STAGE_TESSELLATION_EVALUATION_BIT"/> 2673 <enum bitpos="3" name="VK_SHADER_STAGE_GEOMETRY_BIT"/> 2674 <enum bitpos="4" name="VK_SHADER_STAGE_FRAGMENT_BIT"/> 2675 <enum bitpos="5" name="VK_SHADER_STAGE_COMPUTE_BIT"/> 2676 <enum value="0x1F" name="VK_SHADER_STAGE_ALL_GRAPHICS"/> 2677 <enum value="0x7FFFFFFF" name="VK_SHADER_STAGE_ALL"/> 2678 </enums> 2679 <enums name="VkImageUsageFlagBits" type="bitmask"> 2680 <enum bitpos="0" name="VK_IMAGE_USAGE_TRANSFER_SRC_BIT" comment="Can be used as a source of transfer operations"/> 2681 <enum bitpos="1" name="VK_IMAGE_USAGE_TRANSFER_DST_BIT" comment="Can be used as a destination of transfer operations"/> 2682 <enum bitpos="2" name="VK_IMAGE_USAGE_SAMPLED_BIT" comment="Can be sampled from (SAMPLED_IMAGE and COMBINED_IMAGE_SAMPLER descriptor types)"/> 2683 <enum bitpos="3" name="VK_IMAGE_USAGE_STORAGE_BIT" comment="Can be used as storage image (STORAGE_IMAGE descriptor type)"/> 2684 <enum bitpos="4" name="VK_IMAGE_USAGE_COLOR_ATTACHMENT_BIT" comment="Can be used as framebuffer color attachment"/> 2685 <enum bitpos="5" name="VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT" comment="Can be used as framebuffer depth/stencil attachment"/> 2686 <enum bitpos="6" name="VK_IMAGE_USAGE_TRANSIENT_ATTACHMENT_BIT" comment="Image data not needed outside of rendering"/> 2687 <enum bitpos="7" name="VK_IMAGE_USAGE_INPUT_ATTACHMENT_BIT" comment="Can be used as framebuffer input attachment"/> 2688 </enums> 2689 <enums name="VkImageCreateFlagBits" type="bitmask"> 2690 <enum bitpos="0" name="VK_IMAGE_CREATE_SPARSE_BINDING_BIT" comment="Image should support sparse backing"/> 2691 <enum bitpos="1" name="VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT" comment="Image should support sparse backing with partial residency"/> 2692 <enum bitpos="2" name="VK_IMAGE_CREATE_SPARSE_ALIASED_BIT" comment="Image should support constent data access to physical memory blocks mapped into multiple locations of sparse images"/> 2693 <enum bitpos="3" name="VK_IMAGE_CREATE_MUTABLE_FORMAT_BIT" comment="Allows image views to have different format than the base image"/> 2694 <enum bitpos="4" name="VK_IMAGE_CREATE_CUBE_COMPATIBLE_BIT" comment="Allows creating image views with cube type from the created image"/> 2695 </enums> 2696 <enums name="VkPipelineCreateFlagBits" type="bitmask"> 2697 <enum bitpos="0" name="VK_PIPELINE_CREATE_DISABLE_OPTIMIZATION_BIT"/> 2698 <enum bitpos="1" name="VK_PIPELINE_CREATE_ALLOW_DERIVATIVES_BIT"/> 2699 <enum bitpos="2" name="VK_PIPELINE_CREATE_DERIVATIVE_BIT"/> 2700 </enums> 2701 <enums name="VkColorComponentFlagBits" type="bitmask"> 2702 <enum bitpos="0" name="VK_COLOR_COMPONENT_R_BIT"/> 2703 <enum bitpos="1" name="VK_COLOR_COMPONENT_G_BIT"/> 2704 <enum bitpos="2" name="VK_COLOR_COMPONENT_B_BIT"/> 2705 <enum bitpos="3" name="VK_COLOR_COMPONENT_A_BIT"/> 2706 </enums> 2707 <enums name="VkFenceCreateFlagBits" type="bitmask"> 2708 <enum bitpos="0" name="VK_FENCE_CREATE_SIGNALED_BIT"/> 2709 </enums> 2710 <enums name="VkFormatFeatureFlagBits" type="bitmask"> 2711 <enum bitpos="0" name="VK_FORMAT_FEATURE_SAMPLED_IMAGE_BIT" comment="Format can be used for sampled images (SAMPLED_IMAGE and COMBINED_IMAGE_SAMPLER descriptor types)"/> 2712 <enum bitpos="1" name="VK_FORMAT_FEATURE_STORAGE_IMAGE_BIT" comment="Format can be used for storage images (STORAGE_IMAGE descriptor type)"/> 2713 <enum bitpos="2" name="VK_FORMAT_FEATURE_STORAGE_IMAGE_ATOMIC_BIT" comment="Format supports atomic operations in case it's used for storage images"/> 2714 <enum bitpos="3" name="VK_FORMAT_FEATURE_UNIFORM_TEXEL_BUFFER_BIT" comment="Format can be used for uniform texel buffers (TBOs)"/> 2715 <enum bitpos="4" name="VK_FORMAT_FEATURE_STORAGE_TEXEL_BUFFER_BIT" comment="Format can be used for storage texel buffers (IBOs)"/> 2716 <enum bitpos="5" name="VK_FORMAT_FEATURE_STORAGE_TEXEL_BUFFER_ATOMIC_BIT" comment="Format supports atomic operations in case it's used for storage texel buffers"/> 2717 <enum bitpos="6" name="VK_FORMAT_FEATURE_VERTEX_BUFFER_BIT" comment="Format can be used for vertex buffers (VBOs)"/> 2718 <enum bitpos="7" name="VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BIT" comment="Format can be used for color attachment images"/> 2719 <enum bitpos="8" name="VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BLEND_BIT" comment="Format supports blending in case it's used for color attachment images"/> 2720 <enum bitpos="9" name="VK_FORMAT_FEATURE_DEPTH_STENCIL_ATTACHMENT_BIT" comment="Format can be used for depth/stencil attachment images"/> 2721 <enum bitpos="10" name="VK_FORMAT_FEATURE_BLIT_SRC_BIT" comment="Format can be used as the source image of blits with vkCmdBlitImage"/> 2722 <enum bitpos="11" name="VK_FORMAT_FEATURE_BLIT_DST_BIT" comment="Format can be used as the destination image of blits with vkCmdBlitImage"/> 2723 </enums> 2724 <enums name="VkQueryControlFlagBits" type="bitmask"> 2725 <enum bitpos="0" name="VK_QUERY_CONTROL_PRECISE_BIT" comment="Require precise results to be collected by the query"/> 2726 </enums> 2727 <enums name="VkQueryResultFlagBits" type="bitmask"> 2728 <enum bitpos="0" name="VK_QUERY_RESULT_64_BIT" comment="Results of the queries are written to the destination buffer as 64-bit values"/> 2729 <enum bitpos="1" name="VK_QUERY_RESULT_WAIT_BIT" comment="Results of the queries are waited on before proceeding with the result copy"/> 2730 <enum bitpos="2" name="VK_QUERY_RESULT_WITH_AVAILABILITY_BIT" comment="Besides the results of the query, the availability of the results is also written"/> 2731 <enum bitpos="3" name="VK_QUERY_RESULT_PARTIAL_BIT" comment="Copy the partial results of the query even if the final results aren't available"/> 2732 </enums> 2733 <enums name="VkCommandBufferUsageFlagBits" type="bitmask"> 2734 <enum bitpos="0" name="VK_COMMAND_BUFFER_USAGE_ONE_TIME_SUBMIT_BIT"/> 2735 <enum bitpos="1" name="VK_COMMAND_BUFFER_USAGE_RENDER_PASS_CONTINUE_BIT"/> 2736 <enum bitpos="2" name="VK_COMMAND_BUFFER_USAGE_SIMULTANEOUS_USE_BIT" comment="Command buffer may be submitted/executed more than once simultaneously"/> 2737 </enums> 2738 <enums name="VkQueryPipelineStatisticFlagBits" type="bitmask"> 2739 <enum bitpos="0" name="VK_QUERY_PIPELINE_STATISTIC_INPUT_ASSEMBLY_VERTICES_BIT" comment="Optional"/> 2740 <enum bitpos="1" name="VK_QUERY_PIPELINE_STATISTIC_INPUT_ASSEMBLY_PRIMITIVES_BIT" comment="Optional"/> 2741 <enum bitpos="2" name="VK_QUERY_PIPELINE_STATISTIC_VERTEX_SHADER_INVOCATIONS_BIT" comment="Optional"/> 2742 <enum bitpos="3" name="VK_QUERY_PIPELINE_STATISTIC_GEOMETRY_SHADER_INVOCATIONS_BIT" comment="Optional"/> 2743 <enum bitpos="4" name="VK_QUERY_PIPELINE_STATISTIC_GEOMETRY_SHADER_PRIMITIVES_BIT" comment="Optional"/> 2744 <enum bitpos="5" name="VK_QUERY_PIPELINE_STATISTIC_CLIPPING_INVOCATIONS_BIT" comment="Optional"/> 2745 <enum bitpos="6" name="VK_QUERY_PIPELINE_STATISTIC_CLIPPING_PRIMITIVES_BIT" comment="Optional"/> 2746 <enum bitpos="7" name="VK_QUERY_PIPELINE_STATISTIC_FRAGMENT_SHADER_INVOCATIONS_BIT" comment="Optional"/> 2747 <enum bitpos="8" name="VK_QUERY_PIPELINE_STATISTIC_TESSELLATION_CONTROL_SHADER_PATCHES_BIT" comment="Optional"/> 2748 <enum bitpos="9" name="VK_QUERY_PIPELINE_STATISTIC_TESSELLATION_EVALUATION_SHADER_INVOCATIONS_BIT" comment="Optional"/> 2749 <enum bitpos="10" name="VK_QUERY_PIPELINE_STATISTIC_COMPUTE_SHADER_INVOCATIONS_BIT" comment="Optional"/> 2750 </enums> 2751 <enums name="VkImageAspectFlagBits" type="bitmask"> 2752 <enum bitpos="0" name="VK_IMAGE_ASPECT_COLOR_BIT"/> 2753 <enum bitpos="1" name="VK_IMAGE_ASPECT_DEPTH_BIT"/> 2754 <enum bitpos="2" name="VK_IMAGE_ASPECT_STENCIL_BIT"/> 2755 <enum bitpos="3" name="VK_IMAGE_ASPECT_METADATA_BIT"/> 2756 </enums> 2757 <enums name="VkSparseImageFormatFlagBits" type="bitmask"> 2758 <enum bitpos="0" name="VK_SPARSE_IMAGE_FORMAT_SINGLE_MIPTAIL_BIT" comment="Image uses a single miptail region for all array layers"/> 2759 <enum bitpos="1" name="VK_SPARSE_IMAGE_FORMAT_ALIGNED_MIP_SIZE_BIT" comment="Image requires mip levels to be an exact multiple of the sparse image block size for non-miptail levels."/> 2760 <enum bitpos="2" name="VK_SPARSE_IMAGE_FORMAT_NONSTANDARD_BLOCK_SIZE_BIT" comment="Image uses a non-standard sparse block size"/> 2761 </enums> 2762 <enums name="VkSparseMemoryBindFlagBits" type="bitmask"> 2763 <enum bitpos="0" name="VK_SPARSE_MEMORY_BIND_METADATA_BIT" comment="Operation binds resource metadata to memory"/> 2764 </enums> 2765 <enums name="VkPipelineStageFlagBits" type="bitmask"> 2766 <enum bitpos="0" name="VK_PIPELINE_STAGE_TOP_OF_PIPE_BIT" comment="Before subsequent commands are processed"/> 2767 <enum bitpos="1" name="VK_PIPELINE_STAGE_DRAW_INDIRECT_BIT" comment="Draw/DispatchIndirect command fetch"/> 2768 <enum bitpos="2" name="VK_PIPELINE_STAGE_VERTEX_INPUT_BIT" comment="Vertex/index fetch"/> 2769 <enum bitpos="3" name="VK_PIPELINE_STAGE_VERTEX_SHADER_BIT" comment="Vertex shading"/> 2770 <enum bitpos="4" name="VK_PIPELINE_STAGE_TESSELLATION_CONTROL_SHADER_BIT" comment="Tessellation control shading"/> 2771 <enum bitpos="5" name="VK_PIPELINE_STAGE_TESSELLATION_EVALUATION_SHADER_BIT" comment="Tessellation evaluation shading"/> 2772 <enum bitpos="6" name="VK_PIPELINE_STAGE_GEOMETRY_SHADER_BIT" comment="Geometry shading"/> 2773 <enum bitpos="7" name="VK_PIPELINE_STAGE_FRAGMENT_SHADER_BIT" comment="Fragment shading"/> 2774 <enum bitpos="8" name="VK_PIPELINE_STAGE_EARLY_FRAGMENT_TESTS_BIT" comment="Early fragment (depth and stencil) tests"/> 2775 <enum bitpos="9" name="VK_PIPELINE_STAGE_LATE_FRAGMENT_TESTS_BIT" comment="Late fragment (depth and stencil) tests"/> 2776 <enum bitpos="10" name="VK_PIPELINE_STAGE_COLOR_ATTACHMENT_OUTPUT_BIT" comment="Color attachment writes"/> 2777 <enum bitpos="11" name="VK_PIPELINE_STAGE_COMPUTE_SHADER_BIT" comment="Compute shading"/> 2778 <enum bitpos="12" name="VK_PIPELINE_STAGE_TRANSFER_BIT" comment="Transfer/copy operations"/> 2779 <enum bitpos="13" name="VK_PIPELINE_STAGE_BOTTOM_OF_PIPE_BIT" comment="After previous commands have completed"/> 2780 <enum bitpos="14" name="VK_PIPELINE_STAGE_HOST_BIT" comment="Indicates host (CPU) is a source/sink of the dependency"/> 2781 <enum bitpos="15" name="VK_PIPELINE_STAGE_ALL_GRAPHICS_BIT" comment="All stages of the graphics pipeline"/> 2782 <enum bitpos="16" name="VK_PIPELINE_STAGE_ALL_COMMANDS_BIT" comment="All stages supported on the queue"/> 2783 </enums> 2784 <enums name="VkCommandPoolCreateFlagBits" type="bitmask"> 2785 <enum bitpos="0" name="VK_COMMAND_POOL_CREATE_TRANSIENT_BIT" comment="Command buffers have a short lifetime"/> 2786 <enum bitpos="1" name="VK_COMMAND_POOL_CREATE_RESET_COMMAND_BUFFER_BIT" comment="Command buffers may release their memory individually"/> 2787 </enums> 2788 <enums name="VkCommandPoolResetFlagBits" type="bitmask"> 2789 <enum bitpos="0" name="VK_COMMAND_POOL_RESET_RELEASE_RESOURCES_BIT" comment="Release resources owned by the pool"/> 2790 </enums> 2791 <enums name="VkCommandBufferResetFlagBits" type="bitmask"> 2792 <enum bitpos="0" name="VK_COMMAND_BUFFER_RESET_RELEASE_RESOURCES_BIT" comment="Release resources owned by the buffer"/> 2793 </enums> 2794 <enums name="VkSampleCountFlagBits" type="bitmask"> 2795 <enum bitpos="0" name="VK_SAMPLE_COUNT_1_BIT" comment="Sample count 1 supported"/> 2796 <enum bitpos="1" name="VK_SAMPLE_COUNT_2_BIT" comment="Sample count 2 supported"/> 2797 <enum bitpos="2" name="VK_SAMPLE_COUNT_4_BIT" comment="Sample count 4 supported"/> 2798 <enum bitpos="3" name="VK_SAMPLE_COUNT_8_BIT" comment="Sample count 8 supported"/> 2799 <enum bitpos="4" name="VK_SAMPLE_COUNT_16_BIT" comment="Sample count 16 supported"/> 2800 <enum bitpos="5" name="VK_SAMPLE_COUNT_32_BIT" comment="Sample count 32 supported"/> 2801 <enum bitpos="6" name="VK_SAMPLE_COUNT_64_BIT" comment="Sample count 64 supported"/> 2802 </enums> 2803 <enums name="VkAttachmentDescriptionFlagBits" type="bitmask"> 2804 <enum bitpos="0" name="VK_ATTACHMENT_DESCRIPTION_MAY_ALIAS_BIT" comment="The attachment may alias physical memory of another attachment in the same render pass"/> 2805 </enums> 2806 <enums name="VkStencilFaceFlagBits" type="bitmask"> 2807 <enum bitpos="0" name="VK_STENCIL_FACE_FRONT_BIT" comment="Front face"/> 2808 <enum bitpos="1" name="VK_STENCIL_FACE_BACK_BIT" comment="Back face"/> 2809 <enum value="0x3" name="VK_STENCIL_FRONT_AND_BACK" comment="Front and back faces"/> 2810 </enums> 2811 <enums name="VkDescriptorPoolCreateFlagBits" type="bitmask"> 2812 <enum bitpos="0" name="VK_DESCRIPTOR_POOL_CREATE_FREE_DESCRIPTOR_SET_BIT" comment="Descriptor sets may be freed individually"/> 2813 </enums> 2814 <enums name="VkDependencyFlagBits" type="bitmask"> 2815 <enum bitpos="0" name="VK_DEPENDENCY_BY_REGION_BIT" comment="Dependency is per pixel region "/> 2816 </enums> 2817 <!-- WSI extensions --> 2818 <enums name="VkPresentModeKHR" type="enum" expand="VK_PRESENT_MODE"> 2819 <enum value="0" name="VK_PRESENT_MODE_IMMEDIATE_KHR"/> 2820 <enum value="1" name="VK_PRESENT_MODE_MAILBOX_KHR"/> 2821 <enum value="2" name="VK_PRESENT_MODE_FIFO_KHR"/> 2822 <enum value="3" name="VK_PRESENT_MODE_FIFO_RELAXED_KHR"/> 2823 </enums> 2824 <enums name="VkColorSpaceKHR" type="enum" expand="VK_COLORSPACE"> 2825 <enum value="0" name="VK_COLORSPACE_SRGB_NONLINEAR_KHR"/> 2826 </enums> 2827 <enums name="VkDisplayPlaneAlphaFlagBitsKHR" type="bitmask"> 2828 <enum bitpos="0" name="VK_DISPLAY_PLANE_ALPHA_OPAQUE_BIT_KHR"/> 2829 <enum bitpos="1" name="VK_DISPLAY_PLANE_ALPHA_GLOBAL_BIT_KHR"/> 2830 <enum bitpos="2" name="VK_DISPLAY_PLANE_ALPHA_PER_PIXEL_BIT_KHR"/> 2831 <enum bitpos="3" name="VK_DISPLAY_PLANE_ALPHA_PER_PIXEL_PREMULTIPLIED_BIT_KHR"/> 2832 </enums> 2833 <enums name="VkCompositeAlphaFlagBitsKHR" type="bitmask"> 2834 <enum bitpos="0" name="VK_COMPOSITE_ALPHA_OPAQUE_BIT_KHR"/> 2835 <enum bitpos="1" name="VK_COMPOSITE_ALPHA_PRE_MULTIPLIED_BIT_KHR"/> 2836 <enum bitpos="2" name="VK_COMPOSITE_ALPHA_POST_MULTIPLIED_BIT_KHR"/> 2837 <enum bitpos="3" name="VK_COMPOSITE_ALPHA_INHERIT_BIT_KHR"/> 2838 </enums> 2839 <enums name="VkSurfaceTransformFlagBitsKHR" type="bitmask"> 2840 <enum bitpos="0" name="VK_SURFACE_TRANSFORM_IDENTITY_BIT_KHR"/> 2841 <enum bitpos="1" name="VK_SURFACE_TRANSFORM_ROTATE_90_BIT_KHR"/> 2842 <enum bitpos="2" name="VK_SURFACE_TRANSFORM_ROTATE_180_BIT_KHR"/> 2843 <enum bitpos="3" name="VK_SURFACE_TRANSFORM_ROTATE_270_BIT_KHR"/> 2844 <enum bitpos="4" name="VK_SURFACE_TRANSFORM_HORIZONTAL_MIRROR_BIT_KHR"/> 2845 <enum bitpos="5" name="VK_SURFACE_TRANSFORM_HORIZONTAL_MIRROR_ROTATE_90_BIT_KHR"/> 2846 <enum bitpos="6" name="VK_SURFACE_TRANSFORM_HORIZONTAL_MIRROR_ROTATE_180_BIT_KHR"/> 2847 <enum bitpos="7" name="VK_SURFACE_TRANSFORM_HORIZONTAL_MIRROR_ROTATE_270_BIT_KHR"/> 2848 <enum bitpos="8" name="VK_SURFACE_TRANSFORM_INHERIT_BIT_KHR"/> 2849 </enums> 2850 <enums namespace="VK" name="VkDebugReportFlagBitsEXT" type="bitmask"> 2851 <enum bitpos="0" name="VK_DEBUG_REPORT_INFO_BIT_EXT"/> 2852 <enum bitpos="1" name="VK_DEBUG_REPORT_WARN_BIT_EXT"/> 2853 <enum bitpos="2" name="VK_DEBUG_REPORT_PERF_WARN_BIT_EXT"/> 2854 <enum bitpos="3" name="VK_DEBUG_REPORT_ERROR_BIT_EXT"/> 2855 <enum bitpos="4" name="VK_DEBUG_REPORT_DEBUG_BIT_EXT"/> 2856 </enums> 2857 <enums namespace="VK" name="VkDebugReportObjectTypeEXT" type="enum"> 2858 <enum value="0" name="VK_DEBUG_REPORT_OBJECT_TYPE_UNKNOWN_EXT"/> 2859 <enum value="1" name="VK_DEBUG_REPORT_OBJECT_TYPE_INSTANCE_EXT"/> 2860 <enum value="2" name="VK_DEBUG_REPORT_OBJECT_TYPE_PHYSICAL_DEVICE_EXT"/> 2861 <enum value="3" name="VK_DEBUG_REPORT_OBJECT_TYPE_DEVICE_EXT"/> 2862 <enum value="4" name="VK_DEBUG_REPORT_OBJECT_TYPE_QUEUE_EXT"/> 2863 <enum value="5" name="VK_DEBUG_REPORT_OBJECT_TYPE_SEMAPHORE_EXT"/> 2864 <enum value="6" name="VK_DEBUG_REPORT_OBJECT_TYPE_COMMAND_BUFFER_EXT"/> 2865 <enum value="7" name="VK_DEBUG_REPORT_OBJECT_TYPE_FENCE_EXT"/> 2866 <enum value="8" name="VK_DEBUG_REPORT_OBJECT_TYPE_DEVICE_MEMORY_EXT"/> 2867 <enum value="9" name="VK_DEBUG_REPORT_OBJECT_TYPE_BUFFER_EXT"/> 2868 <enum value="10" name="VK_DEBUG_REPORT_OBJECT_TYPE_IMAGE_EXT"/> 2869 <enum value="11" name="VK_DEBUG_REPORT_OBJECT_TYPE_EVENT_EXT"/> 2870 <enum value="12" name="VK_DEBUG_REPORT_OBJECT_TYPE_QUERY_POOL_EXT"/> 2871 <enum value="13" name="VK_DEBUG_REPORT_OBJECT_TYPE_BUFFER_VIEW_EXT"/> 2872 <enum value="14" name="VK_DEBUG_REPORT_OBJECT_TYPE_IMAGE_VIEW_EXT"/> 2873 <enum value="15" name="VK_DEBUG_REPORT_OBJECT_TYPE_SHADER_MODULE_EXT"/> 2874 <enum value="16" name="VK_DEBUG_REPORT_OBJECT_TYPE_PIPELINE_CACHE_EXT"/> 2875 <enum value="17" name="VK_DEBUG_REPORT_OBJECT_TYPE_PIPELINE_LAYOUT_EXT"/> 2876 <enum value="18" name="VK_DEBUG_REPORT_OBJECT_TYPE_RENDER_PASS_EXT"/> 2877 <enum value="19" name="VK_DEBUG_REPORT_OBJECT_TYPE_PIPELINE_EXT"/> 2878 <enum value="20" name="VK_DEBUG_REPORT_OBJECT_TYPE_DESCRIPTOR_SET_LAYOUT_EXT"/> 2879 <enum value="21" name="VK_DEBUG_REPORT_OBJECT_TYPE_SAMPLER_EXT"/> 2880 <enum value="22" name="VK_DEBUG_REPORT_OBJECT_TYPE_DESCRIPTOR_POOL_EXT"/> 2881 <enum value="23" name="VK_DEBUG_REPORT_OBJECT_TYPE_DESCRIPTOR_SET_EXT"/> 2882 <enum value="24" name="VK_DEBUG_REPORT_OBJECT_TYPE_FRAMEBUFFER_EXT"/> 2883 <enum value="25" name="VK_DEBUG_REPORT_OBJECT_TYPE_COMMAND_POOL_EXT"/> 2884 <enum value="26" name="VK_DEBUG_REPORT_OBJECT_TYPE_SURFACE_KHR_EXT"/> 2885 <enum value="27" name="VK_DEBUG_REPORT_OBJECT_TYPE_SWAPCHAIN_KHR_EXT"/> 2886 <enum value="28" name="VK_DEBUG_REPORT_OBJECT_TYPE_DEBUG_REPORT_EXT"/> 2887 </enums> 2888 <enums namespace="VK" name="VkDebugReportErrorEXT" type="enum"> 2889 <enum value="0" name="VK_DEBUG_REPORT_ERROR_NONE_EXT"/> <!-- Used for INFO & other non-error messages --> 2890 <enum value="1" name="VK_DEBUG_REPORT_ERROR_CALLBACK_REF_EXT"/> <!-- Callbacks were not destroyed prior to calling DestroyInstance --> 2891 </enums> 2892 2893 <!-- SECTION: Vulkan command definitions --> 2894 <commands> 2895 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY,VK_ERROR_INITIALIZATION_FAILED,VK_ERROR_LAYER_NOT_PRESENT,VK_ERROR_EXTENSION_NOT_PRESENT,VK_ERROR_INCOMPATIBLE_DRIVER"> 2896 <proto><type>VkResult</type> <name>vkCreateInstance</name></proto> 2897 <param>const <type>VkInstanceCreateInfo</type>* <name>pCreateInfo</name></param> 2898 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 2899 <param><type>VkInstance</type>* <name>pInstance</name></param> 2900 </command> 2901 <command> 2902 <proto><type>void</type> <name>vkDestroyInstance</name></proto> 2903 <param optional="true" externsync="true"><type>VkInstance</type> <name>instance</name></param> 2904 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 2905 <validity> 2906 <usage>All child objects created using pname:instance must: have been destroyed prior to destroying pname:instance</usage> 2907 <usage>If sname:VkAllocationCallbacks were provided when pname:instance was created, a compatible set of callbacks must: be provided here</usage> 2908 <usage>If no sname:VkAllocationCallbacks were provided when pname:instance was created, pname:pAllocator must: be `NULL`</usage> 2909 </validity> 2910 </command> 2911 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY,VK_ERROR_INITIALIZATION_FAILED"> 2912 <proto><type>VkResult</type> <name>vkEnumeratePhysicalDevices</name></proto> 2913 <param><type>VkInstance</type> <name>instance</name></param> 2914 <param optional="false,true"><type>uint32_t</type>* <name>pPhysicalDeviceCount</name></param> 2915 <param optional="true" len="pPhysicalDeviceCount"><type>VkPhysicalDevice</type>* <name>pPhysicalDevices</name></param> 2916 </command> 2917 <command> 2918 <proto><type>PFN_vkVoidFunction</type> <name>vkGetDeviceProcAddr</name></proto> 2919 <param><type>VkDevice</type> <name>device</name></param> 2920 <param len="null-terminated">const <type>char</type>* <name>pName</name></param> 2921 <validity> 2922 <usage>pname:pName must: be the name of a supported command that has a first parameter of type sname:VkDevice, sname:VkQueue or sname:VkCommandBuffer, either in the core API or an enabled extension</usage> 2923 </validity> 2924 </command> 2925 <command> 2926 <proto><type>PFN_vkVoidFunction</type> <name>vkGetInstanceProcAddr</name></proto> 2927 <param optional="true"><type>VkInstance</type> <name>instance</name></param> 2928 <param len="null-terminated">const <type>char</type>* <name>pName</name></param> 2929 <validity> 2930 <usage>If pname:instance is `NULL`, pname:pName must: be one of: fname:vkEnumerateInstanceExtensionProperties, fname:vkEnumerateInstanceLayerProperties or fname:vkCreateInstance</usage> 2931 <usage>If pname:instance is not `NULL`, pname:pName must: be the name of a core command or a command from an enabled extension, other than: fname:vkEnumerateInstanceExtensionProperties, fname:vkEnumerateInstanceLayerProperties or fname:vkCreateInstance</usage> 2932 </validity> 2933 </command> 2934 <command> 2935 <proto><type>void</type> <name>vkGetPhysicalDeviceProperties</name></proto> 2936 <param><type>VkPhysicalDevice</type> <name>physicalDevice</name></param> 2937 <param><type>VkPhysicalDeviceProperties</type>* <name>pProperties</name></param> 2938 </command> 2939 <command> 2940 <proto><type>void</type> <name>vkGetPhysicalDeviceQueueFamilyProperties</name></proto> 2941 <param><type>VkPhysicalDevice</type> <name>physicalDevice</name></param> 2942 <param optional="false,true"><type>uint32_t</type>* <name>pQueueFamilyPropertyCount</name></param> 2943 <param optional="true" len="pQueueFamilyPropertyCount"><type>VkQueueFamilyProperties</type>* <name>pQueueFamilyProperties</name></param> 2944 </command> 2945 <command> 2946 <proto><type>void</type> <name>vkGetPhysicalDeviceMemoryProperties</name></proto> 2947 <param><type>VkPhysicalDevice</type> <name>physicalDevice</name></param> 2948 <param><type>VkPhysicalDeviceMemoryProperties</type>* <name>pMemoryProperties</name></param> 2949 </command> 2950 <command> 2951 <proto><type>void</type> <name>vkGetPhysicalDeviceFeatures</name></proto> 2952 <param><type>VkPhysicalDevice</type> <name>physicalDevice</name></param> 2953 <param><type>VkPhysicalDeviceFeatures</type>* <name>pFeatures</name></param> 2954 </command> 2955 <command> 2956 <proto><type>void</type> <name>vkGetPhysicalDeviceFormatProperties</name></proto> 2957 <param><type>VkPhysicalDevice</type> <name>physicalDevice</name></param> 2958 <param><type>VkFormat</type> <name>format</name></param> 2959 <param><type>VkFormatProperties</type>* <name>pFormatProperties</name></param> 2960 </command> 2961 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY,VK_ERROR_FORMAT_NOT_SUPPORTED"> 2962 <proto><type>VkResult</type> <name>vkGetPhysicalDeviceImageFormatProperties</name></proto> 2963 <param><type>VkPhysicalDevice</type> <name>physicalDevice</name></param> 2964 <param><type>VkFormat</type> <name>format</name></param> 2965 <param><type>VkImageType</type> <name>type</name></param> 2966 <param><type>VkImageTiling</type> <name>tiling</name></param> 2967 <param><type>VkImageUsageFlags</type> <name>usage</name></param> 2968 <param optional="true"><type>VkImageCreateFlags</type> <name>flags</name></param> 2969 <param><type>VkImageFormatProperties</type>* <name>pImageFormatProperties</name></param> 2970 </command> 2971 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY,VK_ERROR_INITIALIZATION_FAILED,VK_ERROR_LAYER_NOT_PRESENT,VK_ERROR_EXTENSION_NOT_PRESENT,VK_ERROR_FEATURE_NOT_PRESENT,VK_ERROR_TOO_MANY_OBJECTS,VK_ERROR_DEVICE_LOST"> 2972 <proto><type>VkResult</type> <name>vkCreateDevice</name></proto> 2973 <param><type>VkPhysicalDevice</type> <name>physicalDevice</name></param> 2974 <param>const <type>VkDeviceCreateInfo</type>* <name>pCreateInfo</name></param> 2975 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 2976 <param><type>VkDevice</type>* <name>pDevice</name></param> 2977 </command> 2978 <command> 2979 <proto><type>void</type> <name>vkDestroyDevice</name></proto> 2980 <param optional="true" externsync="true"><type>VkDevice</type> <name>device</name></param> 2981 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 2982 <validity> 2983 <usage>All child objects created on pname:device must: have been destroyed prior to destroying pname:device</usage> 2984 <usage>If sname:VkAllocationCallbacks were provided when pname:device was created, a compatible set of callbacks must: be provided here</usage> 2985 <usage>If no sname:VkAllocationCallbacks were provided when pname:device was created, pname:pAllocator must: be `NULL`</usage> 2986 </validity> 2987 </command> 2988 <command successcodes="VK_SUCCESS,VK_INCOMPLETE" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 2989 <proto><type>VkResult</type> <name>vkEnumerateInstanceLayerProperties</name></proto> 2990 <param optional="false,true"><type>uint32_t</type>* <name>pPropertyCount</name></param> 2991 <param optional="true" len="pPropertyCount"><type>VkLayerProperties</type>* <name>pProperties</name></param> 2992 </command> 2993 <command successcodes="VK_SUCCESS,VK_INCOMPLETE" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 2994 <proto><type>VkResult</type> <name>vkEnumerateInstanceExtensionProperties</name></proto> 2995 <param optional="true" len="null-terminated">const <type>char</type>* <name>pLayerName</name></param> 2996 <param optional="false,true"><type>uint32_t</type>* <name>pPropertyCount</name></param> 2997 <param optional="true" len="pPropertyCount"><type>VkExtensionProperties</type>* <name>pProperties</name></param> 2998 <validity> 2999 <usage>If pname:pLayerName is not `NULL`, it must: be the name of a layer available on the system</usage> 3000 </validity> 3001 </command> 3002 <command successcodes="VK_SUCCESS,VK_INCOMPLETE" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 3003 <proto><type>VkResult</type> <name>vkEnumerateDeviceLayerProperties</name></proto> 3004 <param optional="false,true"><type>VkPhysicalDevice</type> <name>physicalDevice</name></param> 3005 <param><type>uint32_t</type>* <name>pPropertyCount</name></param> 3006 <param optional="true" len="pPropertyCount"><type>VkLayerProperties</type>* <name>pProperties</name></param> 3007 </command> 3008 <command successcodes="VK_SUCCESS,VK_INCOMPLETE" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 3009 <proto><type>VkResult</type> <name>vkEnumerateDeviceExtensionProperties</name></proto> 3010 <param><type>VkPhysicalDevice</type> <name>physicalDevice</name></param> 3011 <param optional="true" len="null-terminated">const <type>char</type>* <name>pLayerName</name></param> 3012 <param optional="false,true"><type>uint32_t</type>* <name>pPropertyCount</name></param> 3013 <param optional="true" len="pPropertyCount"><type>VkExtensionProperties</type>* <name>pProperties</name></param> 3014 <validity> 3015 <usage>If pname:pLayerName is not `NULL`, it must: be the name of a layer available on the system</usage> 3016 </validity> 3017 </command> 3018 <command> 3019 <proto><type>void</type> <name>vkGetDeviceQueue</name></proto> 3020 <param><type>VkDevice</type> <name>device</name></param> 3021 <param><type>uint32_t</type> <name>queueFamilyIndex</name></param> 3022 <param><type>uint32_t</type> <name>queueIndex</name></param> 3023 <param><type>VkQueue</type>* <name>pQueue</name></param> 3024 <validity> 3025 <usage>pname:queueFamilyIndex must: be one of the queue family indexes specified when pname:device was created, via the sname:VkDeviceQueueCreateInfo structure</usage> 3026 <usage>pname:queueIndex must: be less than the number of queues created for the specified queue family index when pname:device was created, via the pname:queueCount member of the sname:VkDeviceQueueCreateInfo structure</usage> 3027 </validity> 3028 </command> 3029 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY,VK_ERROR_DEVICE_LOST"> 3030 <proto><type>VkResult</type> <name>vkQueueSubmit</name></proto> 3031 <param externsync="true"><type>VkQueue</type> <name>queue</name></param> 3032 <param optional="true"><type>uint32_t</type> <name>submitCount</name></param> 3033 <param len="submitCount" externsync="pSubmits[].pWaitSemaphores[],pSubmits[].pSignalSemaphores[]">const <type>VkSubmitInfo</type>* <name>pSubmits</name></param> 3034 <param optional="true" externsync="true"><type>VkFence</type> <name>fence</name></param> 3035 <validity> 3036 <usage>pname:fence must: be unsignalled</usage> 3037 <usage>pname:fence mustnot: be associated with any other queue command that has not yet completed execution on that queue</usage> 3038 </validity> 3039 </command> 3040 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY,VK_ERROR_DEVICE_LOST"> 3041 <proto><type>VkResult</type> <name>vkQueueWaitIdle</name></proto> 3042 <param><type>VkQueue</type> <name>queue</name></param> 3043 </command> 3044 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY,VK_ERROR_DEVICE_LOST"> 3045 <proto><type>VkResult</type> <name>vkDeviceWaitIdle</name></proto> 3046 <param><type>VkDevice</type> <name>device</name></param> 3047 <implicitexternsyncparams> 3048 <param>all sname:VkQueue objects created from pname:device</param> 3049 </implicitexternsyncparams> 3050 </command> 3051 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY,VK_ERROR_TOO_MANY_OBJECTS"> 3052 <proto><type>VkResult</type> <name>vkAllocateMemory</name></proto> 3053 <param><type>VkDevice</type> <name>device</name></param> 3054 <param>const <type>VkMemoryAllocateInfo</type>* <name>pAllocateInfo</name></param> 3055 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 3056 <param><type>VkDeviceMemory</type>* <name>pMemory</name></param> 3057 <validity> 3058 <usage>The number of currently valid memory objects, allocated from pname:device, must: be less than sname:VkPhysicalDeviceLimits::pname:maxMemoryAllocationCount</usage> 3059 </validity> 3060 </command> 3061 <command> 3062 <proto><type>void</type> <name>vkFreeMemory</name></proto> 3063 <param><type>VkDevice</type> <name>device</name></param> 3064 <param optional="true" externsync="true"><type>VkDeviceMemory</type> <name>memory</name></param> 3065 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 3066 <validity> 3067 <usage>All submitted commands that refer to pname:memory (via images or buffers) must: have completed execution</usage> 3068 </validity> 3069 </command> 3070 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY,VK_ERROR_MEMORY_MAP_FAILED"> 3071 <proto><type>VkResult</type> <name>vkMapMemory</name></proto> 3072 <param><type>VkDevice</type> <name>device</name></param> 3073 <param externsync="true"><type>VkDeviceMemory</type> <name>memory</name></param> 3074 <param><type>VkDeviceSize</type> <name>offset</name></param> 3075 <param><type>VkDeviceSize</type> <name>size</name></param> 3076 <param optional="true"><type>VkMemoryMapFlags</type> <name>flags</name></param> 3077 <param><type>void</type>** <name>ppData</name></param> 3078 <validity> 3079 <usage>pname:memory mustnot: currently be mapped</usage> 3080 <usage>pname:offset must: be less than the size of pname:memory</usage> 3081 <usage>If pname:size is not equal to ename:VK_WHOLE_SIZE, the sum of pname:offset and pname:size must: be less than or equal to the pname:size of the pname:memory</usage> 3082 <usage>pname:memory must: have been created with a memory type that reports ename:VK_MEMORY_PROPERTY_HOST_VISIBLE_BIT</usage> 3083 </validity> 3084 </command> 3085 <command> 3086 <proto><type>void</type> <name>vkUnmapMemory</name></proto> 3087 <param><type>VkDevice</type> <name>device</name></param> 3088 <param externsync="true"><type>VkDeviceMemory</type> <name>memory</name></param> 3089 <validity> 3090 <usage>pname:memory must: currently be mapped</usage> 3091 </validity> 3092 </command> 3093 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 3094 <proto><type>VkResult</type> <name>vkFlushMappedMemoryRanges</name></proto> 3095 <param><type>VkDevice</type> <name>device</name></param> 3096 <param><type>uint32_t</type> <name>memoryRangeCount</name></param> 3097 <param len="memoryRangeCount">const <type>VkMappedMemoryRange</type>* <name>pMemoryRanges</name></param> 3098 <validity> 3099 <usage>The memory ranges specified by pname:pMemoryRanges must: all currently be mapped</usage> 3100 </validity> 3101 </command> 3102 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 3103 <proto><type>VkResult</type> <name>vkInvalidateMappedMemoryRanges</name></proto> 3104 <param><type>VkDevice</type> <name>device</name></param> 3105 <param><type>uint32_t</type> <name>memoryRangeCount</name></param> 3106 <param len="memoryRangeCount">const <type>VkMappedMemoryRange</type>* <name>pMemoryRanges</name></param> 3107 <validity> 3108 <usage>The memory ranges specified by pname:pMemoryRanges must: all currently be mapped</usage> 3109 </validity> 3110 </command> 3111 <command> 3112 <proto><type>void</type> <name>vkGetDeviceMemoryCommitment</name></proto> 3113 <param><type>VkDevice</type> <name>device</name></param> 3114 <param><type>VkDeviceMemory</type> <name>memory</name></param> 3115 <param><type>VkDeviceSize</type>* <name>pCommittedMemoryInBytes</name></param> 3116 <validity> 3117 <usage>pname:memory must: have been created with a memory type that reports ename:VK_MEMORY_PROPERTY_LAZILY_ALLOCATED_BIT</usage> 3118 </validity> 3119 </command> 3120 <command> 3121 <proto><type>void</type> <name>vkGetBufferMemoryRequirements</name></proto> 3122 <param><type>VkDevice</type> <name>device</name></param> 3123 <param><type>VkBuffer</type> <name>buffer</name></param> 3124 <param><type>VkMemoryRequirements</type>* <name>pMemoryRequirements</name></param> 3125 </command> 3126 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 3127 <proto><type>VkResult</type> <name>vkBindBufferMemory</name></proto> 3128 <param><type>VkDevice</type> <name>device</name></param> 3129 <param externsync="true"><type>VkBuffer</type> <name>buffer</name></param> 3130 <param><type>VkDeviceMemory</type> <name>memory</name></param> 3131 <param><type>VkDeviceSize</type> <name>memoryOffset</name></param> 3132 <validity> 3133 <usage>pname:buffer mustnot: already be backed by a memory object</usage> 3134 <usage>pname:buffer mustnot: have been created with any sparse memory binding flags</usage> 3135 <usage>pname:memoryOffset must: be less than the size of pname:memory</usage> 3136 <usage>If pname:buffer was created with the ename:VK_BUFFER_USAGE_UNIFORM_TEXEL_BUFFER_BIT or ename:VK_BUFFER_USAGE_STORAGE_TEXEL_BUFFER_BIT, pname:memoryOffset must: be a multiple of the value of sname:VkPhysicalDeviceLimits::pname:minTexelBufferOffsetAlignment</usage> 3137 <usage>If pname:buffer was created with the ename:VK_BUFFER_USAGE_UNIFORM_BUFFER_BIT, pname:memoryOffset must: be a multiple of the value of sname:VkPhysicalDeviceLimits::pname:minUniformBufferOffsetAlignment</usage> 3138 <usage>If pname:buffer was created with the ename:VK_BUFFER_USAGE_STORAGE_BUFFER_BIT, pname:memoryOffset must: be a multiple of the value of sname:VkPhysicalDeviceLimits::pname:minStorageBufferOffsetAlignment</usage> 3139 <usage>pname:memory must: have been allocated using one of the memory types allowed in the pname:memoryTypeBits member of the sname:VkMemoryRequirements structure returned from a call to fname:vkGetBufferMemoryRequirements with pname:buffer</usage> 3140 <usage>The sum of pname:memoryOffset and the size of pname:buffer must: be less than or equal to the size of pname:memory</usage> 3141 <usage>pname:memoryOffset must: be an integer multiple of the pname:alignment member of the sname:VkMemoryRequirements structure returned from a call to fname:vkGetBufferMemoryRequirements with pname:buffer</usage> 3142 </validity> 3143 </command> 3144 <command> 3145 <proto><type>void</type> <name>vkGetImageMemoryRequirements</name></proto> 3146 <param><type>VkDevice</type> <name>device</name></param> 3147 <param><type>VkImage</type> <name>image</name></param> 3148 <param><type>VkMemoryRequirements</type>* <name>pMemoryRequirements</name></param> 3149 </command> 3150 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 3151 <proto><type>VkResult</type> <name>vkBindImageMemory</name></proto> 3152 <param><type>VkDevice</type> <name>device</name></param> 3153 <param externsync="true"><type>VkImage</type> <name>image</name></param> 3154 <param><type>VkDeviceMemory</type> <name>memory</name></param> 3155 <param><type>VkDeviceSize</type> <name>memoryOffset</name></param> 3156 <validity> 3157 <usage>pname:image mustnot: already be backed by a memory object</usage> 3158 <usage>pname:image mustnot: have been created with any sparse memory binding flags</usage> 3159 <usage>pname:memoryOffset must: be less than the size of pname:memory</usage> 3160 <usage>pname:memory must: have been allocated using one of the memory types allowed in the pname:memoryTypeBits member of the sname:VkMemoryRequirements structure returned from a call to fname:vkGetImageMemoryRequirements with pname:image</usage> 3161 <usage>pname:memoryOffset must: be an integer multiple of the pname:alignment member of the sname:VkMemoryRequirements structure returned from a call to fname:vkGetImageMemoryRequirements with pname:image</usage> 3162 <usage>pname:memory must: have storage from pname:memoryOffset onwards equal to or greater than the pname:size member of the sname:VkMemoryRequirements structure returned from a call to fname:vkGetImageMemoryRequirements with pname:image</usage> 3163 </validity> 3164 </command> 3165 <command> 3166 <proto><type>void</type> <name>vkGetImageSparseMemoryRequirements</name></proto> 3167 <param><type>VkDevice</type> <name>device</name></param> 3168 <param><type>VkImage</type> <name>image</name></param> 3169 <param><type>uint32_t</type>* <name>pSparseMemoryRequirementCount</name></param> 3170 <param optional="true" len="pSparseMemoryRequirementCount"><type>VkSparseImageMemoryRequirements</type>* <name>pSparseMemoryRequirements</name></param> 3171 <validity> 3172 <usage>pname:image must: have been created with the ename:VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT flag</usage> 3173 </validity> 3174 </command> 3175 <command> 3176 <proto><type>void</type> <name>vkGetPhysicalDeviceSparseImageFormatProperties</name></proto> 3177 <param><type>VkPhysicalDevice</type> <name>physicalDevice</name></param> 3178 <param><type>VkFormat</type> <name>format</name></param> 3179 <param><type>VkImageType</type> <name>type</name></param> 3180 <param><type>VkSampleCountFlagBits</type> <name>samples</name></param> 3181 <param><type>VkImageUsageFlags</type> <name>usage</name></param> 3182 <param><type>VkImageTiling</type> <name>tiling</name></param> 3183 <param optional="false,true"><type>uint32_t</type>* <name>pPropertyCount</name></param> 3184 <param optional="true" len="pPropertyCount"><type>VkSparseImageFormatProperties</type>* <name>pProperties</name></param> 3185 <validity> 3186 <usage>If pname:format is an integer format, samples must: be one of the bit flag values specified in the value of sname:VkPhysicalDeviceLimits::pname:sampledImageIntegerSampleCounts</usage> 3187 <usage>If pname:format is a non-integer color format, samples must: be one of the bit flag values specified in the value of sname:VkPhysicalDeviceLimits::pname:sampledImageColorSampleCounts</usage> 3188 <usage>If pname:format is a depth format, samples must: be one of the bit flag values specified in the value of sname:VkPhysicalDeviceLimits::pname:sampledImageDepthSampleCounts</usage> 3189 <usage>If pname:format is a stencil format, samples must: be one of the bit flag values specified in the value of sname:VkPhysicalDeviceLimits::pname:sampledImageStencilSampleCounts</usage> 3190 <usage>If pname:usage includes ename:VK_IMAGE_USAGE_STORAGE_BIT, samples must: be one of the bit flag values specified in the value of sname:VkPhysicalDeviceLimits::pname:storageImageSampleCounts</usage> 3191 </validity> 3192 </command> 3193 <command queues="sparse_binding" successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 3194 <proto><type>VkResult</type> <name>vkQueueBindSparse</name></proto> 3195 <param externsync="true"><type>VkQueue</type> <name>queue</name></param> 3196 <param optional="true"><type>uint32_t</type> <name>bindInfoCount</name></param> 3197 <param len="bindInfoCount" externsync="pBindInfo[].pWaitSemaphores[],pBindInfo[].pSignalSemaphores[],pBindInfo[].pBufferBinds[].buffer,pBindInfo[].pImageOpaqueBinds[].image,pBindInfo[].pImageBinds[].image">const <type>VkBindSparseInfo</type>* <name>pBindInfo</name></param> 3198 <param optional="true" externsync="true"><type>VkFence</type> <name>fence</name></param> 3199 <validity> 3200 <usage>pname:fence must: be unsignalled</usage> 3201 <usage>pname:fence mustnot: be associated with any other queue command that has not yet completed execution on that queue</usage> 3202 </validity> 3203 </command> 3204 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 3205 <proto><type>VkResult</type> <name>vkCreateFence</name></proto> 3206 <param><type>VkDevice</type> <name>device</name></param> 3207 <param>const <type>VkFenceCreateInfo</type>* <name>pCreateInfo</name></param> 3208 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 3209 <param><type>VkFence</type>* <name>pFence</name></param> 3210 </command> 3211 <command> 3212 <proto><type>void</type> <name>vkDestroyFence</name></proto> 3213 <param><type>VkDevice</type> <name>device</name></param> 3214 <param optional="true" externsync="true"><type>VkFence</type> <name>fence</name></param> 3215 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 3216 <validity> 3217 <usage>pname:fence mustnot: be associated with any queue command that has not yet completed execution on that queue</usage> 3218 <usage>If sname:VkAllocationCallbacks were provided when pname:fence was created, a compatible set of callbacks must: be provided here</usage> 3219 <usage>If no sname:VkAllocationCallbacks were provided when pname:fence was created, pname:pAllocator must: be `NULL`</usage> 3220 </validity> 3221 </command> 3222 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 3223 <proto><type>VkResult</type> <name>vkResetFences</name></proto> 3224 <param><type>VkDevice</type> <name>device</name></param> 3225 <param><type>uint32_t</type> <name>fenceCount</name></param> 3226 <param len="fenceCount" externsync="true">const <type>VkFence</type>* <name>pFences</name></param> 3227 <validity> 3228 <usage>Any given element of pname:pFences mustnot: currently be associated with any queue command that has not yet completed execution on that queue</usage> 3229 </validity> 3230 </command> 3231 <command successcodes="VK_SUCCESS,VK_NOT_READY" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY,VK_ERROR_DEVICE_LOST"> 3232 <proto><type>VkResult</type> <name>vkGetFenceStatus</name></proto> 3233 <param><type>VkDevice</type> <name>device</name></param> 3234 <param><type>VkFence</type> <name>fence</name></param> 3235 </command> 3236 <command successcodes="VK_SUCCESS,VK_TIMEOUT" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY,VK_ERROR_DEVICE_LOST"> 3237 <proto><type>VkResult</type> <name>vkWaitForFences</name></proto> 3238 <param><type>VkDevice</type> <name>device</name></param> 3239 <param><type>uint32_t</type> <name>fenceCount</name></param> 3240 <param len="fenceCount">const <type>VkFence</type>* <name>pFences</name></param> 3241 <param><type>VkBool32</type> <name>waitAll</name></param> 3242 <param><type>uint64_t</type> <name>timeout</name></param> 3243 </command> 3244 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 3245 <proto><type>VkResult</type> <name>vkCreateSemaphore</name></proto> 3246 <param><type>VkDevice</type> <name>device</name></param> 3247 <param>const <type>VkSemaphoreCreateInfo</type>* <name>pCreateInfo</name></param> 3248 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 3249 <param><type>VkSemaphore</type>* <name>pSemaphore</name></param> 3250 </command> 3251 <command> 3252 <proto><type>void</type> <name>vkDestroySemaphore</name></proto> 3253 <param><type>VkDevice</type> <name>device</name></param> 3254 <param optional="true" externsync="true"><type>VkSemaphore</type> <name>semaphore</name></param> 3255 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 3256 <validity> 3257 <usage>pname:semaphore mustnot: be associated with any queue command that has not yet completed execution on that queue</usage> 3258 <usage>If sname:VkAllocationCallbacks were provided when pname:semaphore was created, a compatible set of callbacks must: be provided here</usage> 3259 <usage>If no sname:VkAllocationCallbacks were provided when pname:semaphore was created, pname:pAllocator must: be `NULL`</usage> 3260 </validity> 3261 </command> 3262 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 3263 <proto><type>VkResult</type> <name>vkCreateEvent</name></proto> 3264 <param><type>VkDevice</type> <name>device</name></param> 3265 <param>const <type>VkEventCreateInfo</type>* <name>pCreateInfo</name></param> 3266 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 3267 <param><type>VkEvent</type>* <name>pEvent</name></param> 3268 </command> 3269 <command> 3270 <proto><type>void</type> <name>vkDestroyEvent</name></proto> 3271 <param><type>VkDevice</type> <name>device</name></param> 3272 <param optional="true" externsync="true"><type>VkEvent</type> <name>event</name></param> 3273 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 3274 <validity> 3275 <usage>All submitted commands that refer to pname:event must: have completed execution</usage> 3276 <usage>If sname:VkAllocationCallbacks were provided when pname:event was created, a compatible set of callbacks must: be provided here</usage> 3277 <usage>If no sname:VkAllocationCallbacks were provided when pname:event was created, pname:pAllocator must: be `NULL`</usage> 3278 </validity> 3279 </command> 3280 <command successcodes="VK_SUCCESS,VK_EVENT_SET,VK_EVENT_RESET" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY,VK_ERROR_DEVICE_LOST"> 3281 <proto><type>VkResult</type> <name>vkGetEventStatus</name></proto> 3282 <param><type>VkDevice</type> <name>device</name></param> 3283 <param><type>VkEvent</type> <name>event</name></param> 3284 </command> 3285 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 3286 <proto><type>VkResult</type> <name>vkSetEvent</name></proto> 3287 <param><type>VkDevice</type> <name>device</name></param> 3288 <param externsync="true"><type>VkEvent</type> <name>event</name></param> 3289 </command> 3290 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 3291 <proto><type>VkResult</type> <name>vkResetEvent</name></proto> 3292 <param><type>VkDevice</type> <name>device</name></param> 3293 <param externsync="true"><type>VkEvent</type> <name>event</name></param> 3294 </command> 3295 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 3296 <proto><type>VkResult</type> <name>vkCreateQueryPool</name></proto> 3297 <param><type>VkDevice</type> <name>device</name></param> 3298 <param>const <type>VkQueryPoolCreateInfo</type>* <name>pCreateInfo</name></param> 3299 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 3300 <param><type>VkQueryPool</type>* <name>pQueryPool</name></param> 3301 </command> 3302 <command> 3303 <proto><type>void</type> <name>vkDestroyQueryPool</name></proto> 3304 <param><type>VkDevice</type> <name>device</name></param> 3305 <param optional="true" externsync="true"><type>VkQueryPool</type> <name>queryPool</name></param> 3306 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 3307 <validity> 3308 <usage>All submitted commands that refer to pname:queryPool must: have completed execution</usage> 3309 <usage>If sname:VkAllocationCallbacks were provided when pname:queryPool was created, a compatible set of callbacks must: be provided here</usage> 3310 <usage>If no sname:VkAllocationCallbacks were provided when pname:queryPool was created, pname:pAllocator must: be `NULL`</usage> 3311 </validity> 3312 </command> 3313 <command successcodes="VK_SUCCESS,VK_NOT_READY" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY,VK_ERROR_DEVICE_LOST"> 3314 <proto><type>VkResult</type> <name>vkGetQueryPoolResults</name></proto> 3315 <param><type>VkDevice</type> <name>device</name></param> 3316 <param><type>VkQueryPool</type> <name>queryPool</name></param> 3317 <param><type>uint32_t</type> <name>firstQuery</name></param> 3318 <param><type>uint32_t</type> <name>queryCount</name></param> 3319 <param><type>size_t</type> <name>dataSize</name></param> 3320 <param len="dataSize"><type>void</type>* <name>pData</name></param> 3321 <param><type>VkDeviceSize</type> <name>stride</name></param> 3322 <param optional="true"><type>VkQueryResultFlags</type> <name>flags</name></param> 3323 <validity> 3324 <usage>pname:firstQuery must: be less than the number of queries in pname:queryPool</usage> 3325 <usage>If ename:VK_QUERY_RESULT_64_BIT is not set in pname:flags then pname:pData and pname:stride must be multiples of `4`</usage> 3326 <usage>If ename:VK_QUERY_RESULT_64_BIT is set in pname:flags then pname:pData and pname:stride must be multiples of `8`</usage> 3327 <usage>The sum of pname:firstQuery and pname:queryCount must: be less than or equal to the number of queries in pname:queryPool</usage> 3328 <usage>pname:dataSize must: be large enough to contain the result of each query, as described <<queries-operation-memorylayout,here>></usage> 3329 <usage>If the pname:queryType used to create pname:queryPool was ename:VK_QUERY_TYPE_TIMESTAMP, pname:flags mustnot: contain ename:VK_QUERY_RESULT_PARTIAL_BIT</usage> 3330 </validity> 3331 </command> 3332 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 3333 <proto><type>VkResult</type> <name>vkCreateBuffer</name></proto> 3334 <param><type>VkDevice</type> <name>device</name></param> 3335 <param>const <type>VkBufferCreateInfo</type>* <name>pCreateInfo</name></param> 3336 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 3337 <param><type>VkBuffer</type>* <name>pBuffer</name></param> 3338 <validity> 3339 <usage>If the pname:flags member of pname:pCreateInfo includes ename:VK_BUFFER_CREATE_SPARSE_BINDING_BIT or ename:VK_BUFFER_CREATE_SPARSE_RESIDENCY_BIT, creating this sname:VkBuffer mustnot: cause the total required sparse memory for all currently valid sparse resources on the device to exceed sname:VkPhysicalDeviceLimits::pname:sparseAddressSpaceSize</usage> 3340 </validity> 3341 </command> 3342 <command> 3343 <proto><type>void</type> <name>vkDestroyBuffer</name></proto> 3344 <param><type>VkDevice</type> <name>device</name></param> 3345 <param optional="true" externsync="true"><type>VkBuffer</type> <name>buffer</name></param> 3346 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 3347 <validity> 3348 <usage>All submitted commands that refer to pname:buffer, either directly or via a sname:VkBufferView, must: have completed execution</usage> 3349 <usage>If sname:VkAllocationCallbacks were provided when pname:buffer was created, a compatible set of callbacks must: be provided here</usage> 3350 <usage>If no sname:VkAllocationCallbacks were provided when pname:buffer was created, pname:pAllocator must: be `NULL`</usage> 3351 </validity> 3352 </command> 3353 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 3354 <proto><type>VkResult</type> <name>vkCreateBufferView</name></proto> 3355 <param><type>VkDevice</type> <name>device</name></param> 3356 <param>const <type>VkBufferViewCreateInfo</type>* <name>pCreateInfo</name></param> 3357 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 3358 <param><type>VkBufferView</type>* <name>pView</name></param> 3359 </command> 3360 <command> 3361 <proto><type>void</type> <name>vkDestroyBufferView</name></proto> 3362 <param><type>VkDevice</type> <name>device</name></param> 3363 <param optional="true" externsync="true"><type>VkBufferView</type> <name>bufferView</name></param> 3364 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 3365 <validity> 3366 <usage>All submitted commands that refer to pname:bufferView must: have completed execution</usage> 3367 <usage>If sname:VkAllocationCallbacks were provided when pname:bufferView was created, a compatible set of callbacks must: be provided here</usage> 3368 <usage>If no sname:VkAllocationCallbacks were provided when pname:bufferView was created, pname:pAllocator must: be `NULL`</usage> 3369 </validity> 3370 </command> 3371 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 3372 <proto><type>VkResult</type> <name>vkCreateImage</name></proto> 3373 <param><type>VkDevice</type> <name>device</name></param> 3374 <param>const <type>VkImageCreateInfo</type>* <name>pCreateInfo</name></param> 3375 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 3376 <param><type>VkImage</type>* <name>pImage</name></param> 3377 <validity> 3378 <usage>If the pname:flags member of pname:pCreateInfo includes ename:VK_IMAGE_CREATE_SPARSE_BINDING_BIT or ename:VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT, creating this sname:VkImage mustnot: cause the total required sparse memory for all currently valid sparse resources on the device to exceed sname:VkPhysicalDeviceLimits::pname:sparseAddressSpaceSize</usage> 3379 </validity> 3380 </command> 3381 <command> 3382 <proto><type>void</type> <name>vkDestroyImage</name></proto> 3383 <param><type>VkDevice</type> <name>device</name></param> 3384 <param optional="true" externsync="true"><type>VkImage</type> <name>image</name></param> 3385 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 3386 <validity> 3387 <usage>All submitted commands that refer to pname:image, either directly or via a sname:VkImageView, must: have completed execution</usage> 3388 <usage>If sname:VkAllocationCallbacks were provided when pname:image was created, a compatible set of callbacks must: be provided here</usage> 3389 <usage>If no sname:VkAllocationCallbacks were provided when pname:image was created, pname:pAllocator must: be `NULL`</usage> 3390 </validity> 3391 </command> 3392 <command> 3393 <proto><type>void</type> <name>vkGetImageSubresourceLayout</name></proto> 3394 <param><type>VkDevice</type> <name>device</name></param> 3395 <param><type>VkImage</type> <name>image</name></param> 3396 <param>const <type>VkImageSubresource</type>* <name>pSubresource</name></param> 3397 <param><type>VkSubresourceLayout</type>* <name>pLayout</name></param> 3398 <validity> 3399 <usage>pname:image must: have been created with pname:tiling equal to ename:VK_IMAGE_TILING_LINEAR</usage> 3400 <usage>The pname:aspectMask member of pname:pSubresource must: only have a single bit set</usage> 3401 </validity> 3402 </command> 3403 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 3404 <proto><type>VkResult</type> <name>vkCreateImageView</name></proto> 3405 <param><type>VkDevice</type> <name>device</name></param> 3406 <param>const <type>VkImageViewCreateInfo</type>* <name>pCreateInfo</name></param> 3407 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 3408 <param><type>VkImageView</type>* <name>pView</name></param> 3409 </command> 3410 <command> 3411 <proto><type>void</type> <name>vkDestroyImageView</name></proto> 3412 <param><type>VkDevice</type> <name>device</name></param> 3413 <param optional="true" externsync="true"><type>VkImageView</type> <name>imageView</name></param> 3414 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 3415 <validity> 3416 <usage>All submitted commands that refer to pname:imageView must: have completed execution</usage> 3417 <usage>If sname:VkAllocationCallbacks were provided when pname:imageView was created, a compatible set of callbacks must: be provided here</usage> 3418 <usage>If no sname:VkAllocationCallbacks were provided when pname:imageView was created, pname:pAllocator must: be `NULL`</usage> 3419 </validity> 3420 </command> 3421 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 3422 <proto><type>VkResult</type> <name>vkCreateShaderModule</name></proto> 3423 <param><type>VkDevice</type> <name>device</name></param> 3424 <param>const <type>VkShaderModuleCreateInfo</type>* <name>pCreateInfo</name></param> 3425 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 3426 <param><type>VkShaderModule</type>* <name>pShaderModule</name></param> 3427 </command> 3428 <command> 3429 <proto><type>void</type> <name>vkDestroyShaderModule</name></proto> 3430 <param><type>VkDevice</type> <name>device</name></param> 3431 <param optional="true" externsync="true"><type>VkShaderModule</type> <name>shaderModule</name></param> 3432 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 3433 <validity> 3434 <usage>If sname:VkAllocationCallbacks were provided when pname:shaderModule was created, a compatible set of callbacks must: be provided here</usage> 3435 <usage>If no sname:VkAllocationCallbacks were provided when pname:shaderModule was created, pname:pAllocator must: be `NULL`</usage> 3436 </validity> 3437 </command> 3438 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 3439 <proto><type>VkResult</type> <name>vkCreatePipelineCache</name></proto> 3440 <param><type>VkDevice</type> <name>device</name></param> 3441 <param>const <type>VkPipelineCacheCreateInfo</type>* <name>pCreateInfo</name></param> 3442 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 3443 <param><type>VkPipelineCache</type>* <name>pPipelineCache</name></param> 3444 </command> 3445 <command> 3446 <proto><type>void</type> <name>vkDestroyPipelineCache</name></proto> 3447 <param><type>VkDevice</type> <name>device</name></param> 3448 <param optional="true" externsync="true"><type>VkPipelineCache</type> <name>pipelineCache</name></param> 3449 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 3450 <validity> 3451 <usage>If sname:VkAllocationCallbacks were provided when pname:pipelineCache was created, a compatible set of callbacks must: be provided here</usage> 3452 <usage>If no sname:VkAllocationCallbacks were provided when pname:pipelineCache was created, pname:pAllocator must: be `NULL`</usage> 3453 </validity> 3454 </command> 3455 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 3456 <proto><type>VkResult</type> <name>vkGetPipelineCacheData</name></proto> 3457 <param><type>VkDevice</type> <name>device</name></param> 3458 <param><type>VkPipelineCache</type> <name>pipelineCache</name></param> 3459 <param optional="false,true"><type>size_t</type>* <name>pDataSize</name></param> 3460 <param optional="true" len="pDataSize"><type>void</type>* <name>pData</name></param> 3461 </command> 3462 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 3463 <proto><type>VkResult</type> <name>vkMergePipelineCaches</name></proto> 3464 <param><type>VkDevice</type> <name>device</name></param> 3465 <param externsync="true"><type>VkPipelineCache</type> <name>dstCache</name></param> 3466 <param><type>uint32_t</type> <name>srcCacheCount</name></param> 3467 <param len="srcCacheCount">const <type>VkPipelineCache</type>* <name>pSrcCaches</name></param> 3468 <validity> 3469 <usage>pname:dstCache mustnot: appear in the list of source caches</usage> 3470 </validity> 3471 </command> 3472 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 3473 <proto><type>VkResult</type> <name>vkCreateGraphicsPipelines</name></proto> 3474 <param><type>VkDevice</type> <name>device</name></param> 3475 <param optional="true"><type>VkPipelineCache</type> <name>pipelineCache</name></param> 3476 <param><type>uint32_t</type> <name>createInfoCount</name></param> 3477 <param len="createInfoCount">const <type>VkGraphicsPipelineCreateInfo</type>* <name>pCreateInfos</name></param> 3478 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 3479 <param len="createInfoCount"><type>VkPipeline</type>* <name>pPipelines</name></param> 3480 <validity> 3481 <usage>If the value of the pname:flags member of any given element of pname:pCreateInfos contains the ename:VK_PIPELINE_CREATE_DERIVATIVE_BIT flag, and the pname:basePipelineIndex member of that same element is not `-1`, the value of pname:basePipelineIndex must: be less than the index into pname:pCreateInfos that corresponds to that element</usage> 3482 </validity> 3483 </command> 3484 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 3485 <proto><type>VkResult</type> <name>vkCreateComputePipelines</name></proto> 3486 <param><type>VkDevice</type> <name>device</name></param> 3487 <param optional="true"><type>VkPipelineCache</type> <name>pipelineCache</name></param> 3488 <param><type>uint32_t</type> <name>createInfoCount</name></param> 3489 <param len="createInfoCount">const <type>VkComputePipelineCreateInfo</type>* <name>pCreateInfos</name></param> 3490 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 3491 <param len="createInfoCount"><type>VkPipeline</type>* <name>pPipelines</name></param> 3492 <validity> 3493 <usage>If the value of the pname:flags member of any given element of pname:pCreateInfos contains the ename:VK_PIPELINE_CREATE_DERIVATIVE_BIT flag, and the pname:basePipelineIndex member of that same element is not `-1`, the value of pname:basePipelineIndex must: be less than the index into pname:pCreateInfos that corresponds to that element</usage> 3494 </validity> 3495 </command> 3496 <command> 3497 <proto><type>void</type> <name>vkDestroyPipeline</name></proto> 3498 <param><type>VkDevice</type> <name>device</name></param> 3499 <param optional="true" externsync="true"><type>VkPipeline</type> <name>pipeline</name></param> 3500 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 3501 <validity> 3502 <usage>All submitted commands that refer to pname:pipeline must: have completed execution</usage> 3503 <usage>If sname:VkAllocationCallbacks were provided when pname:pipeline was created, a compatible set of callbacks must: be provided here</usage> 3504 <usage>If no sname:VkAllocationCallbacks were provided when pname:pipeline was created, pname:pAllocator must: be `NULL`</usage> 3505 </validity> 3506 </command> 3507 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 3508 <proto><type>VkResult</type> <name>vkCreatePipelineLayout</name></proto> 3509 <param><type>VkDevice</type> <name>device</name></param> 3510 <param>const <type>VkPipelineLayoutCreateInfo</type>* <name>pCreateInfo</name></param> 3511 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 3512 <param><type>VkPipelineLayout</type>* <name>pPipelineLayout</name></param> 3513 </command> 3514 <command> 3515 <proto><type>void</type> <name>vkDestroyPipelineLayout</name></proto> 3516 <param><type>VkDevice</type> <name>device</name></param> 3517 <param optional="true" externsync="true"><type>VkPipelineLayout</type> <name>pipelineLayout</name></param> 3518 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 3519 <validity> 3520 <usage>If sname:VkAllocationCallbacks were provided when pname:pipelineLayout was created, a compatible set of callbacks must: be provided here</usage> 3521 <usage>If no sname:VkAllocationCallbacks were provided when pname:pipelineLayout was created, pname:pAllocator must: be `NULL`</usage> 3522 </validity> 3523 </command> 3524 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY,VK_ERROR_TOO_MANY_OBJECTS"> 3525 <proto><type>VkResult</type> <name>vkCreateSampler</name></proto> 3526 <param><type>VkDevice</type> <name>device</name></param> 3527 <param>const <type>VkSamplerCreateInfo</type>* <name>pCreateInfo</name></param> 3528 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 3529 <param><type>VkSampler</type>* <name>pSampler</name></param> 3530 </command> 3531 <command> 3532 <proto><type>void</type> <name>vkDestroySampler</name></proto> 3533 <param><type>VkDevice</type> <name>device</name></param> 3534 <param optional="true" externsync="true"><type>VkSampler</type> <name>sampler</name></param> 3535 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 3536 <validity> 3537 <usage>All submitted commands that refer to pname:sampler must: have completed execution</usage> 3538 <usage>If sname:VkAllocationCallbacks were provided when pname:sampler was created, a compatible set of callbacks must: be provided here</usage> 3539 <usage>If no sname:VkAllocationCallbacks were provided when pname:sampler was created, pname:pAllocator must: be `NULL`</usage> 3540 </validity> 3541 </command> 3542 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 3543 <proto><type>VkResult</type> <name>vkCreateDescriptorSetLayout</name></proto> 3544 <param><type>VkDevice</type> <name>device</name></param> 3545 <param>const <type>VkDescriptorSetLayoutCreateInfo</type>* <name>pCreateInfo</name></param> 3546 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 3547 <param><type>VkDescriptorSetLayout</type>* <name>pSetLayout</name></param> 3548 </command> 3549 <command> 3550 <proto><type>void</type> <name>vkDestroyDescriptorSetLayout</name></proto> 3551 <param><type>VkDevice</type> <name>device</name></param> 3552 <param optional="true" externsync="true"><type>VkDescriptorSetLayout</type> <name>descriptorSetLayout</name></param> 3553 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 3554 <validity> 3555 <usage>If sname:VkAllocationCallbacks were provided when pname:descriptorSetLayout was created, a compatible set of callbacks must: be provided here</usage> 3556 <usage>If no sname:VkAllocationCallbacks were provided when pname:descriptorSetLayout was created, pname:pAllocator must: be `NULL`</usage> 3557 </validity> 3558 </command> 3559 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 3560 <proto><type>VkResult</type> <name>vkCreateDescriptorPool</name></proto> 3561 <param><type>VkDevice</type> <name>device</name></param> 3562 <param>const <type>VkDescriptorPoolCreateInfo</type>* <name>pCreateInfo</name></param> 3563 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 3564 <param><type>VkDescriptorPool</type>* <name>pDescriptorPool</name></param> 3565 </command> 3566 <command> 3567 <proto><type>void</type> <name>vkDestroyDescriptorPool</name></proto> 3568 <param><type>VkDevice</type> <name>device</name></param> 3569 <param optional="true" externsync="true"><type>VkDescriptorPool</type> <name>descriptorPool</name></param> 3570 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 3571 <validity> 3572 <usage>All submitted commands that refer to pname:descriptorPool (via any allocated descriptor sets) must: have completed execution</usage> 3573 <usage>If sname:VkAllocationCallbacks were provided when pname:descriptorPool was created, a compatible set of callbacks must: be provided here</usage> 3574 <usage>If no sname:VkAllocationCallbacks were provided when pname:descriptorPool was created, pname:pAllocator must: be `NULL`</usage> 3575 </validity> 3576 </command> 3577 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 3578 <proto><type>VkResult</type> <name>vkResetDescriptorPool</name></proto> 3579 <param><type>VkDevice</type> <name>device</name></param> 3580 <param externsync="true"><type>VkDescriptorPool</type> <name>descriptorPool</name></param> 3581 <param optional="true"><type>VkDescriptorPoolResetFlags</type> <name>flags</name></param> 3582 <implicitexternsyncparams> 3583 <param>any sname:VkDescriptorSet objects allocated from pname:descriptorPool</param> 3584 </implicitexternsyncparams> 3585 <validity> 3586 <usage>All uses of pname:descriptorPool (via any allocated descriptor sets) must: have completed execution</usage> 3587 </validity> 3588 </command> 3589 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 3590 <proto><type>VkResult</type> <name>vkAllocateDescriptorSets</name></proto> 3591 <param><type>VkDevice</type> <name>device</name></param> 3592 <param externsync="pAllocateInfo->descriptorPool">const <type>VkDescriptorSetAllocateInfo</type>* <name>pAllocateInfo</name></param> 3593 <param len="pAllocateInfo->descriptorSetCount"><type>VkDescriptorSet</type>* <name>pDescriptorSets</name></param> 3594 </command> 3595 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 3596 <proto><type>VkResult</type> <name>vkFreeDescriptorSets</name></proto> 3597 <param><type>VkDevice</type> <name>device</name></param> 3598 <param externsync="true"><type>VkDescriptorPool</type> <name>descriptorPool</name></param> 3599 <param><type>uint32_t</type> <name>descriptorSetCount</name></param> 3600 <param noautovalidity="true" externsync="true" len="descriptorSetCount">const <type>VkDescriptorSet</type>* <name>pDescriptorSets</name></param> 3601 <validity> 3602 <usage>All submitted commands that refer to any element of pname:pDesciptorSets must: have completed execution</usage> 3603 <usage>pname:pDescriptorSets must: be a pointer to an array of pname:descriptorSetCount sname:VkDescriptorSet handles, each element of which must: either be a valid handle or sname:VK_NULL_HANDLE</usage> 3604 <usage>pname:descriptorPool must: have been created with the ename:VK_DESCRIPTOR_POOL_CREATE_FREE_DESCRIPTOR_SET_BIT flag</usage> 3605 </validity> 3606 </command> 3607 <command> 3608 <proto><type>void</type> <name>vkUpdateDescriptorSets</name></proto> 3609 <param><type>VkDevice</type> <name>device</name></param> 3610 <param optional="true"><type>uint32_t</type> <name>descriptorWriteCount</name></param> 3611 <param len="descriptorWriteCount" externsync="pDescriptorWrites[].dstSet">const <type>VkWriteDescriptorSet</type>* <name>pDescriptorWrites</name></param> 3612 <param optional="true"><type>uint32_t</type> <name>descriptorCopyCount</name></param> 3613 <param len="descriptorCopyCount" externsync="pDescriptorCopies[].dstSet">const <type>VkCopyDescriptorSet</type>* <name>pDescriptorCopies</name></param> 3614 </command> 3615 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 3616 <proto><type>VkResult</type> <name>vkCreateFramebuffer</name></proto> 3617 <param><type>VkDevice</type> <name>device</name></param> 3618 <param>const <type>VkFramebufferCreateInfo</type>* <name>pCreateInfo</name></param> 3619 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 3620 <param><type>VkFramebuffer</type>* <name>pFramebuffer</name></param> 3621 </command> 3622 <command> 3623 <proto><type>void</type> <name>vkDestroyFramebuffer</name></proto> 3624 <param><type>VkDevice</type> <name>device</name></param> 3625 <param optional="true" externsync="true"><type>VkFramebuffer</type> <name>framebuffer</name></param> 3626 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 3627 <validity> 3628 <usage>All submitted commands that refer to pname:framebuffer must: have completed execution</usage> 3629 <usage>If sname:VkAllocationCallbacks were provided when pname:framebuffer was created, a compatible set of callbacks must: be provided here</usage> 3630 <usage>If no sname:VkAllocationCallbacks were provided when pname:framebuffer was created, pname:pAllocator must: be `NULL`</usage> 3631 </validity> 3632 </command> 3633 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 3634 <proto><type>VkResult</type> <name>vkCreateRenderPass</name></proto> 3635 <param><type>VkDevice</type> <name>device</name></param> 3636 <param>const <type>VkRenderPassCreateInfo</type>* <name>pCreateInfo</name></param> 3637 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 3638 <param><type>VkRenderPass</type>* <name>pRenderPass</name></param> 3639 </command> 3640 <command> 3641 <proto><type>void</type> <name>vkDestroyRenderPass</name></proto> 3642 <param><type>VkDevice</type> <name>device</name></param> 3643 <param optional="true" externsync="true"><type>VkRenderPass</type> <name>renderPass</name></param> 3644 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 3645 <validity> 3646 <usage>All submitted commands that refer to pname:renderPass must: have completed execution</usage> 3647 <usage>If sname:VkAllocationCallbacks were provided when pname:renderPass was created, a compatible set of callbacks must: be provided here</usage> 3648 <usage>If no sname:VkAllocationCallbacks were provided when pname:renderPass was created, pname:pAllocator must: be `NULL`</usage> 3649 </validity> 3650 </command> 3651 <command> 3652 <proto><type>void</type> <name>vkGetRenderAreaGranularity</name></proto> 3653 <param><type>VkDevice</type> <name>device</name></param> 3654 <param><type>VkRenderPass</type> <name>renderPass</name></param> 3655 <param><type>VkExtent2D</type>* <name>pGranularity</name></param> 3656 </command> 3657 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 3658 <proto><type>VkResult</type> <name>vkCreateCommandPool</name></proto> 3659 <param><type>VkDevice</type> <name>device</name></param> 3660 <param>const <type>VkCommandPoolCreateInfo</type>* <name>pCreateInfo</name></param> 3661 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 3662 <param><type>VkCommandPool</type>* <name>pCommandPool</name></param> 3663 </command> 3664 <command> 3665 <proto><type>void</type> <name>vkDestroyCommandPool</name></proto> 3666 <param><type>VkDevice</type> <name>device</name></param> 3667 <param optional="true" externsync="true"><type>VkCommandPool</type> <name>commandPool</name></param> 3668 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 3669 <validity> 3670 <usage>All sname:VkCommandBuffer objects allocated from pname:commandPool mustnot: be pending execution</usage> 3671 <usage>If sname:VkAllocationCallbacks were provided when pname:commandPool was created, a compatible set of callbacks must: be provided here</usage> 3672 <usage>If no sname:VkAllocationCallbacks were provided when pname:commandPool was created, pname:pAllocator must: be `NULL`</usage> 3673 </validity> 3674 </command> 3675 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 3676 <proto><type>VkResult</type> <name>vkResetCommandPool</name></proto> 3677 <param><type>VkDevice</type> <name>device</name></param> 3678 <param externsync="true"><type>VkCommandPool</type> <name>commandPool</name></param> 3679 <param optional="true"><type>VkCommandPoolResetFlags</type> <name>flags</name></param> 3680 <validity> 3681 <usage>All sname:VkCommandBuffer objects allocated from pname:commandPool mustnot: currently be pending execution</usage> 3682 </validity> 3683 </command> 3684 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 3685 <proto><type>VkResult</type> <name>vkAllocateCommandBuffers</name></proto> 3686 <param><type>VkDevice</type> <name>device</name></param> 3687 <param externsync="pAllocateInfo->commandPool">const <type>VkCommandBufferAllocateInfo</type>* <name>pAllocateInfo</name></param> 3688 <param len="pAllocateInfo->commandBufferCount"><type>VkCommandBuffer</type>* <name>pCommandBuffers</name></param> 3689 </command> 3690 <command> 3691 <proto><type>void</type> <name>vkFreeCommandBuffers</name></proto> 3692 <param><type>VkDevice</type> <name>device</name></param> 3693 <param externsync="true"><type>VkCommandPool</type> <name>commandPool</name></param> 3694 <param><type>uint32_t</type> <name>commandBufferCount</name></param> 3695 <param noautovalidity="true" externsync="true" len="commandBufferCount">const <type>VkCommandBuffer</type>* <name>pCommandBuffers</name></param> 3696 <validity> 3697 <usage>All elements of pname:pCommandBuffers mustnot: be pending execution</usage> 3698 <usage>pname:pCommandBuffers must: be a pointer to an array of pname:commandBufferCount sname:VkCommandBuffer handles, each element of which must: either be a valid handle or sname:VK_NULL_HANDLE</usage> 3699 </validity> 3700 </command> 3701 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 3702 <proto><type>VkResult</type> <name>vkBeginCommandBuffer</name></proto> 3703 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 3704 <param>const <type>VkCommandBufferBeginInfo</type>* <name>pBeginInfo</name></param> 3705 <validity> 3706 <usage>pname:commandBuffer mustnot: be in the recording state</usage> 3707 <usage>If pname:commandBuffer was allocated from a sname:VkCommandPool which did not have the ename:VK_COMMAND_POOL_CREATE_RESET_COMMAND_BUFFER_BIT flag set, pname:commandBuffer must: be in the initial state.</usage> 3708 <usage>If pname:commandBuffer is a secondary command buffer, the pname:pInheritanceInfo member of pname:pBeginInfo must: be a valid sname:VkCommandBufferInheritanceInfo structure</usage> 3709 <usage>If pname:commandBuffer is a secondary command buffer and either the pname:occlusionQueryEnable member of the pname:pInheritanceInfo member of pname:pBeginInfo is ename:VK_FALSE, or the precise occlusion queries feature is not enabled, the pname:queryFlags member of the pname:pInheritanceInfo member pname:pBeginInfo mustnot: contain ename:VK_QUERY_CONTROL_PRECISE_BIT</usage> 3710 3711 </validity> 3712 </command> 3713 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 3714 <proto><type>VkResult</type> <name>vkEndCommandBuffer</name></proto> 3715 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 3716 <validity> 3717 <usage>pname:commandBuffer must: be in the recording state</usage> 3718 <usage>fname:vkEndCommandBuffer mustnot: be called inside a render pass instance</usage> 3719 <usage>All queries made <<queries-operation-active,active>> during the recording of pname:commandBuffer must: have been made inactive</usage> 3720 </validity> 3721 </command> 3722 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 3723 <proto><type>VkResult</type> <name>vkResetCommandBuffer</name></proto> 3724 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 3725 <param optional="true"><type>VkCommandBufferResetFlags</type> <name>flags</name></param> 3726 <validity> 3727 <usage>pname:commandBuffer mustnot: currently be pending execution</usage> 3728 <usage>pname:commandBuffer must: have been allocated from a pool that was created with the ename:VK_COMMAND_POOL_CREATE_RESET_COMMAND_BUFFER_BIT</usage> 3729 </validity> 3730 </command> 3731 <command queues="graphics,compute" renderpass="both" cmdbufferlevel="primary,secondary"> 3732 <proto><type>void</type> <name>vkCmdBindPipeline</name></proto> 3733 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 3734 <param><type>VkPipelineBindPoint</type> <name>pipelineBindPoint</name></param> 3735 <param><type>VkPipeline</type> <name>pipeline</name></param> 3736 <validity> 3737 <usage>If the value of pname:pipelineBindPoint is ename:VK_PIPELINE_BIND_POINT_COMPUTE, the sname:VkCommandPool that pname:commandBuffer was allocated from must: support compute operations</usage> 3738 <usage>If the value of pname:pipelineBindPoint is ename:VK_PIPELINE_BIND_POINT_GRAPHICS, the sname:VkCommandPool that pname:commandBuffer was allocated from must: support graphics operations</usage> 3739 <usage>If the value of pname:pipelineBindPoint is ename:VK_PIPELINE_BIND_POINT_COMPUTE, pname:pipeline must: be a compute pipeline</usage> 3740 <usage>If the value of pname:pipelineBindPoint is ename:VK_PIPELINE_BIND_POINT_GRAPHICS, pname:pipeline must: be a graphics pipeline</usage> 3741 <usage>If the <<features-features-variableMultisampleRate,variable multisample rate>> feature is not supported, pname:pipeline is a graphics pipeline, the current subpass has no attachments, and this is not the first call to this function with a graphics pipeline after transitioning to the current subpass, then the sample count specified by this pipeline must: match that set in the previous pipeline</usage> 3742 </validity> 3743 </command> 3744 <command queues="graphics" renderpass="both" cmdbufferlevel="primary,secondary"> 3745 <proto><type>void</type> <name>vkCmdSetViewport</name></proto> 3746 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 3747 <param><type>uint32_t</type> <name>firstViewport</name></param> 3748 <param><type>uint32_t</type> <name>viewportCount</name></param> 3749 <param len="viewportCount">const <type>VkViewport</type>* <name>pViewports</name></param> 3750 <validity> 3751 <usage>pname:firstViewport must: be less than sname:VkPhysicalDeviceLimits::pname:maxViewports</usage> 3752 <usage>The sum of pname:firstViewport and pname:viewportCount must: be between `1` and sname:VkPhysicalDeviceLimits::pname:maxViewports, inclusive</usage> 3753 </validity> 3754 </command> 3755 <command queues="graphics" renderpass="both" cmdbufferlevel="primary,secondary"> 3756 <proto><type>void</type> <name>vkCmdSetScissor</name></proto> 3757 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 3758 <param><type>uint32_t</type> <name>firstScissor</name></param> 3759 <param><type>uint32_t</type> <name>scissorCount</name></param> 3760 <param len="scissorCount">const <type>VkRect2D</type>* <name>pScissors</name></param> 3761 <validity> 3762 <usage>pname:firstScissor must: be less than sname:VkPhysicalDeviceLimits::pname:maxViewports</usage> 3763 <usage>The sum of pname:firstScissor and pname:scissorCount must: be between `1` and sname:VkPhysicalDeviceLimits::pname:maxViewports, inclusive</usage> 3764 <usage>The pname:x and pname:y members of pname:offset must: be greater than or equal to `0`</usage> 3765 <usage>Evaluation of (pname:offset.x + pname:extent.width) mustnot: cause a signed integer addition overflow</usage> 3766 <usage>Evaluation of (pname:offset.y + pname:extent.height) mustnot: cause a signed integer addition overflow</usage> 3767 </validity> 3768 </command> 3769 <command queues="graphics" renderpass="both" cmdbufferlevel="primary,secondary"> 3770 <proto><type>void</type> <name>vkCmdSetLineWidth</name></proto> 3771 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 3772 <param><type>float</type> <name>lineWidth</name></param> 3773 <validity> 3774 <usage>If the <<features-features-wideLines,wide lines>> feature is not enabled, the value of pname:lineWidth must: be `1.0`</usage> 3775 </validity> 3776 </command> 3777 <command queues="graphics" renderpass="both" cmdbufferlevel="primary,secondary"> 3778 <proto><type>void</type> <name>vkCmdSetDepthBias</name></proto> 3779 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 3780 <param><type>float</type> <name>depthBiasConstantFactor</name></param> 3781 <param><type>float</type> <name>depthBiasClamp</name></param> 3782 <param><type>float</type> <name>depthBiasSlopeFactor</name></param> 3783 <validity> 3784 <usage>If the <<features-features-depthBiasClamp,depth bias clamping>> feature is not enabled, the value of pname:depthBiasClamp must: be code:0.0</usage> 3785 </validity> 3786 </command> 3787 <command queues="graphics" renderpass="both" cmdbufferlevel="primary,secondary"> 3788 <proto><type>void</type> <name>vkCmdSetBlendConstants</name></proto> 3789 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 3790 <param>const <type>float</type> <name>blendConstants</name>[4]</param> 3791 </command> 3792 <command queues="graphics" renderpass="both" cmdbufferlevel="primary,secondary"> 3793 <proto><type>void</type> <name>vkCmdSetDepthBounds</name></proto> 3794 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 3795 <param><type>float</type> <name>minDepthBounds</name></param> 3796 <param><type>float</type> <name>maxDepthBounds</name></param> 3797 <validity> 3798 <usage>The value of pname:minDepthBounds must: be between `0.0` and `1.0`, inclusive</usage> 3799 <usage>The value of pname:maxDepthBounds must: be between `0.0` and `1.0`, inclusive</usage> 3800 </validity> 3801 </command> 3802 <command queues="graphics" renderpass="both" cmdbufferlevel="primary,secondary"> 3803 <proto><type>void</type> <name>vkCmdSetStencilCompareMask</name></proto> 3804 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 3805 <param><type>VkStencilFaceFlags</type> <name>faceMask</name></param> 3806 <param><type>uint32_t</type> <name>compareMask</name></param> 3807 </command> 3808 <command queues="graphics" renderpass="both" cmdbufferlevel="primary,secondary"> 3809 <proto><type>void</type> <name>vkCmdSetStencilWriteMask</name></proto> 3810 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 3811 <param><type>VkStencilFaceFlags</type> <name>faceMask</name></param> 3812 <param><type>uint32_t</type> <name>writeMask</name></param> 3813 </command> 3814 <command queues="graphics" renderpass="both" cmdbufferlevel="primary,secondary"> 3815 <proto><type>void</type> <name>vkCmdSetStencilReference</name></proto> 3816 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 3817 <param><type>VkStencilFaceFlags</type> <name>faceMask</name></param> 3818 <param><type>uint32_t</type> <name>reference</name></param> 3819 </command> 3820 <command queues="graphics,compute" renderpass="both" cmdbufferlevel="primary,secondary"> 3821 <proto><type>void</type> <name>vkCmdBindDescriptorSets</name></proto> 3822 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 3823 <param><type>VkPipelineBindPoint</type> <name>pipelineBindPoint</name></param> 3824 <param><type>VkPipelineLayout</type> <name>layout</name></param> 3825 <param><type>uint32_t</type> <name>firstSet</name></param> 3826 <param><type>uint32_t</type> <name>descriptorSetCount</name></param> 3827 <param len="descriptorSetCount">const <type>VkDescriptorSet</type>* <name>pDescriptorSets</name></param> 3828 <param optional="true"><type>uint32_t</type> <name>dynamicOffsetCount</name></param> 3829 <param len="dynamicOffsetCount">const <type>uint32_t</type>* <name>pDynamicOffsets</name></param> 3830 <validity> 3831 <usage>Any given element of pname:pDescriptorSets must: have been created with a sname:VkDescriptorSetLayout that matches the sname:VkDescriptorSetLayout at set _n_ in pname:layout, where _n_ is the sum of the index into pname:pDescriptorSets and pname:firstSet</usage> 3832 <usage>pname:dynamicOffsetCount must: be equal to the total number of dynamic descriptors in pname:pDescriptorSets</usage> 3833 <usage>pname:pipelineBindPoint must: be supported by the pname:commandBuffer's parent sname:VkCommandPool's queue family</usage> 3834 <usage>Any given element of pname:pDynamicOffsets must: satisfy the required alignment for the corresponding descriptor binding's descriptor type</usage> 3835 </validity> 3836 </command> 3837 <command queues="graphics" renderpass="both" cmdbufferlevel="primary,secondary"> 3838 <proto><type>void</type> <name>vkCmdBindIndexBuffer</name></proto> 3839 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 3840 <param><type>VkBuffer</type> <name>buffer</name></param> 3841 <param><type>VkDeviceSize</type> <name>offset</name></param> 3842 <param><type>VkIndexType</type> <name>indexType</name></param> 3843 <validity> 3844 <usage>The value of pname:offset must: be less than the size of pname:buffer</usage> 3845 <usage>The sum of pname:offset, and the address of the range of sname:VkDeviceMemory object that's backing pname:buffer, must: be a multiple of the type indicated by pname:indexType</usage> 3846 <usage>pname:buffer must: have been created with the ename:VK_BUFFER_USAGE_INDEX_BUFFER_BIT flag</usage> 3847 </validity> 3848 </command> 3849 <command queues="graphics" renderpass="both" cmdbufferlevel="primary,secondary"> 3850 <proto><type>void</type> <name>vkCmdBindVertexBuffers</name></proto> 3851 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 3852 <param><type>uint32_t</type> <name>firstBinding</name></param> 3853 <param><type>uint32_t</type> <name>bindingCount</name></param> 3854 <param len="bindingCount">const <type>VkBuffer</type>* <name>pBuffers</name></param> 3855 <param len="bindingCount">const <type>VkDeviceSize</type>* <name>pOffsets</name></param> 3856 <validity> 3857 <usage>pname:firstBinding must: be less than sname:VkPhysicalDeviceLimits::pname:maxVertexInputBindings</usage> 3858 <usage>The sum of pname:firstBinding and pname:bindingCount must: be less than or equal to sname:VkPhysicalDeviceLimits::pname:maxVertexInputBindings</usage> 3859 <usage>All elements of pname:pOffsets must: be less than the size of the corresponding element in pname:pBuffers</usage> 3860 <usage>All elements of pname:pBuffers must: have been created with the ename:VK_BUFFER_USAGE_VERTEX_BUFFER_BIT flag</usage> 3861 </validity> 3862 </command> 3863 <command queues="graphics" renderpass="inside" cmdbufferlevel="primary,secondary"> 3864 <proto><type>void</type> <name>vkCmdDraw</name></proto> 3865 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 3866 <param><type>uint32_t</type> <name>vertexCount</name></param> 3867 <param><type>uint32_t</type> <name>instanceCount</name></param> 3868 <param><type>uint32_t</type> <name>firstVertex</name></param> 3869 <param><type>uint32_t</type> <name>firstInstance</name></param> 3870 <validity> 3871 <usage>For each set _n_ that is statically used by the sname:VkPipeline currently bound to ename:VK_PIPELINE_BIND_POINT_GRAPHICS, a descriptor set must: have been bound to _n_ at ename:VK_PIPELINE_BIND_POINT_GRAPHICS, with a sname:VkPipelineLayout that is compatible for set _n_, with the sname:VkPipelineLayout used to create the current sname:VkPipeline, as described in <<descriptorsets-compatibility>></usage> 3872 <usage>For each push constant that is statically used by the sname:VkPipeline currently bound to ename:VK_PIPELINE_BIND_POINT_GRAPHICS, a push constant value must: have been set for ename:VK_PIPELINE_BIND_POINT_GRAPHICS, with a sname:VkPipelineLayout that is compatible for push constants, with the sname:VkPipelineLayout used to create the current sname:VkPipeline, as described in <<descriptorsets-compatibility>></usage> 3873 <usage>Descriptors in each bound descriptor set, specified via fname:vkCmdBindDescriptorSets, must: be valid if they are statically used by the currently bound sname:VkPipeline object, specified via fname:vkCmdBindPipeline</usage> 3874 <usage>All vertex input bindings accessed via vertex input variables declared in the vertex shader entry point's interface must: have valid buffers bound</usage> 3875 <usage>For a given vertex buffer binding, any attribute data fetched must: be entirely contained within the corresponding vertex buffer binding, as described in <<fxvertex-input>></usage> 3876 <usage>A valid graphics pipeline must: be bound to the current command buffer with ename:VK_PIPELINE_BIND_POINT_GRAPHICS</usage> 3877 <usage>If the sname:VkPipeline object currently bound to ename:VK_PIPELINE_BIND_POINT_GRAPHICS requires any dynamic state, that state must: have been set on the current command buffer</usage> 3878 <usage>Every input attachment used by the current subpass must: be bound to the pipeline via a descriptor set</usage> 3879 <usage>If any sname:VkSampler object that is accessed from a shader by the sname:VkPipeline currently bound to ename:VK_PIPELINE_BIND_POINT_GRAPHICS uses unnormalized coordinates, it mustnot: be used to sample from any sname:VkImage with a sname:VkImageView of the type ename:VK_IMAGE_VIEW_TYPE_3D, ename:VK_IMAGE_VIEW_TYPE_CUBE, ename:VK_IMAGE_VIEW_TYPE_1D_ARRAY, ename:VK_IMAGE_VIEW_TYPE_2D_ARRAY or ename:VK_IMAGE_VIEW_TYPE_CUBE_ARRAY, in any shader stage</usage> 3880 <usage>If any sname:VkSampler object that is accessed from a shader by the sname:VkPipeline currently bound to ename:VK_PIPELINE_BIND_POINT_GRAPHICS uses unnormalized coordinates, it mustnot: be used with any of the SPIR-V `OpImageSample*` or `OpImageSparseSample*` instructions with "ImplicitLod", "Dref" or "Proj" in their name, in any shader stage</usage> 3881 <usage>If any sname:VkSampler object that is accessed from a shader by the sname:VkPipeline currently bound to ename:VK_PIPELINE_BIND_POINT_GRAPHICS uses unnormalized coordinates, it mustnot: be used with any of the SPIR-V `OpImageSample*` or `OpImageSparseSample*` instructions that includes a lod bias or any offset values, in any shader stage</usage> 3882 <usage>If the <<features-features-robustBufferAccess,robust buffer access>> feature is not enabled, and any shader stage in the sname:VkPipeline object currently bound to ename:VK_PIPELINE_BIND_POINT_GRAPHICS accesses a uniform buffer, it mustnot: access values outside of the range of that buffer specified in the currently bound descriptor set</usage> 3883 <usage>If the <<features-features-robustBufferAccess,robust buffer access>> feature is not enabled, and any shader stage in the sname:VkPipeline object currently bound to ename:VK_PIPELINE_BIND_POINT_GRAPHICS accesses a storage buffer, it mustnot: access values outside of the range of that buffer specified in the currently bound descriptor set</usage> 3884 </validity> 3885 </command> 3886 <command queues="graphics" renderpass="inside" cmdbufferlevel="primary,secondary"> 3887 <proto><type>void</type> <name>vkCmdDrawIndexed</name></proto> 3888 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 3889 <param><type>uint32_t</type> <name>indexCount</name></param> 3890 <param><type>uint32_t</type> <name>instanceCount</name></param> 3891 <param><type>uint32_t</type> <name>firstIndex</name></param> 3892 <param><type>int32_t</type> <name>vertexOffset</name></param> 3893 <param><type>uint32_t</type> <name>firstInstance</name></param> 3894 <validity> 3895 <usage>For each set _n_ that is statically used by the sname:VkPipeline currently bound to ename:VK_PIPELINE_BIND_POINT_GRAPHICS, a descriptor set must: have been bound to _n_ at ename:VK_PIPELINE_BIND_POINT_GRAPHICS, with a sname:VkPipelineLayout that is compatible for set _n_, with the sname:VkPipelineLayout used to create the current sname:VkPipeline, as described in <<descriptorsets-compatibility>></usage> 3896 <usage>For each push constant that is statically used by the sname:VkPipeline currently bound to ename:VK_PIPELINE_BIND_POINT_GRAPHICS, a push constant value must: have been set for ename:VK_PIPELINE_BIND_POINT_GRAPHICS, with a sname:VkPipelineLayout that is compatible for push constants, with the sname:VkPipelineLayout used to create the current sname:VkPipeline, as described in <<descriptorsets-compatibility>></usage> 3897 <usage>Descriptors in each bound descriptor set, specified via fname:vkCmdBindDescriptorSets, must: be valid if they are statically used by the currently bound sname:VkPipeline object, specified via fname:vkCmdBindPipeline</usage> 3898 <usage>All vertex input bindings accessed via vertex input variables declared in the vertex shader entry point's interface must: have valid buffers bound</usage> 3899 <usage>For a given vertex buffer binding, any attribute data fetched must: be entirely contained within the corresponding vertex buffer binding, as described in <<fxvertex-input>></usage> 3900 <usage>A valid graphics pipeline must: be bound to the current command buffer with ename:VK_PIPELINE_BIND_POINT_GRAPHICS</usage> 3901 <usage>If the sname:VkPipeline object currently bound to ename:VK_PIPELINE_BIND_POINT_GRAPHICS requires any dynamic state, that state must: have been set on the current command buffer</usage> 3902 <usage>The total value of (pname:indexSize * (pname:firstIndex + pname:indexCount) + pname:offset) must: be less than or equal to the size of the currently bound index buffer, with indexSize being based on the type specified by pname:indexType, where the index buffer, pname:indexType, and pname:offset are specified via fname:vkCmdBindIndexBuffer</usage> 3903 <usage>Every input attachment used by the current subpass must: be bound to the pipeline via a descriptor set</usage> 3904 <usage>If any sname:VkSampler object that is accessed from a shader by the sname:VkPipeline currently bound to ename:VK_PIPELINE_BIND_POINT_GRAPHICS uses unnormalized coordinates, it mustnot: be used to sample from any sname:VkImage with a sname:VkImageView of the type ename:VK_IMAGE_VIEW_TYPE_3D, ename:VK_IMAGE_VIEW_TYPE_CUBE, ename:VK_IMAGE_VIEW_TYPE_1D_ARRAY, ename:VK_IMAGE_VIEW_TYPE_2D_ARRAY or ename:VK_IMAGE_VIEW_TYPE_CUBE_ARRAY, in any shader stage</usage> 3905 <usage>If any sname:VkSampler object that is accessed from a shader by the sname:VkPipeline currently bound to ename:VK_PIPELINE_BIND_POINT_GRAPHICS uses unnormalized coordinates, it mustnot: be used with any of the SPIR-V `OpImageSample*` or `OpImageSparseSample*` instructions with "ImplicitLod", "Dref" or "Proj" in their name, in any shader stage</usage> 3906 <usage>If any sname:VkSampler object that is accessed from a shader by the sname:VkPipeline currently bound to ename:VK_PIPELINE_BIND_POINT_GRAPHICS uses unnormalized coordinates, it mustnot: be used with any of the SPIR-V `OpImageSample*` or `OpImageSparseSample*` instructions that includes a lod bias or any offset values, in any shader stage</usage> 3907 <usage>If the <<features-features-robustBufferAccess,robust buffer access>> feature is not enabled, and any shader stage in the sname:VkPipeline object currently bound to ename:VK_PIPELINE_BIND_POINT_GRAPHICS accesses a uniform buffer, it mustnot: access values outside of the range of that buffer specified in the currently bound descriptor set</usage> 3908 <usage>If the <<features-features-robustBufferAccess,robust buffer access>> feature is not enabled, and any shader stage in the sname:VkPipeline object currently bound to ename:VK_PIPELINE_BIND_POINT_GRAPHICS accesses a storage buffer, it mustnot: access values outside of the range of that buffer specified in the currently bound descriptor set</usage> 3909 </validity> 3910 </command> 3911 <command queues="graphics" renderpass="inside" cmdbufferlevel="primary,secondary"> 3912 <proto><type>void</type> <name>vkCmdDrawIndirect</name></proto> 3913 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 3914 <param><type>VkBuffer</type> <name>buffer</name></param> 3915 <param><type>VkDeviceSize</type> <name>offset</name></param> 3916 <param><type>uint32_t</type> <name>drawCount</name></param> 3917 <param><type>uint32_t</type> <name>stride</name></param> 3918 <validity> 3919 <usage>The value of pname:offset must: be a multiple of `4`</usage> 3920 <usage>If the <<features-features-multiDrawIndirect,multi-draw indirect>> feature is not enabled, the value of pname:drawCount must: be `0` or `1`</usage> 3921 <usage>If the <<features-features-drawIndirectFirstInstance,drawIndirectFirstInstance>> feature is not enabled, all the pname:firstInstance members of the sname:VkDrawIndirectCommand structures accessed by this command must: be code:0</usage> 3922 <usage>For each set _n_ that is statically used by the sname:VkPipeline currently bound to ename:VK_PIPELINE_BIND_POINT_GRAPHICS, a descriptor set must: have been bound to _n_ at ename:VK_PIPELINE_BIND_POINT_GRAPHICS, with a sname:VkPipelineLayout that is compatible for set _n_, with the sname:VkPipelineLayout used to create the current sname:VkPipeline, as described in <<descriptorsets-compatibility>></usage> 3923 <usage>For each push constant that is statically used by the sname:VkPipeline currently bound to ename:VK_PIPELINE_BIND_POINT_GRAPHICS, a push constant value must: have been set for ename:VK_PIPELINE_BIND_POINT_GRAPHICS, with a sname:VkPipelineLayout that is compatible for push constants, with the sname:VkPipelineLayout used to create the current sname:VkPipeline, as described in <<descriptorsets-compatibility>></usage> 3924 <usage>Descriptors in each bound descriptor set, specified via fname:vkCmdBindDescriptorSets, must: be valid if they are statically used by the currently bound sname:VkPipeline object, specified via fname:vkCmdBindPipeline</usage> 3925 <usage>All vertex input bindings accessed via vertex input variables declared in the vertex shader entry point's interface must: have valid buffers bound</usage> 3926 <usage>A valid graphics pipeline must: be bound to the current command buffer with ename:VK_PIPELINE_BIND_POINT_GRAPHICS</usage> 3927 <usage>If the sname:VkPipeline object currently bound to ename:VK_PIPELINE_BIND_POINT_GRAPHICS requires any dynamic state, that state must: have been set on the current command buffer</usage> 3928 <usage>If pname:drawCount is greater than `0`, the total value of (pname:stride * (pname:drawCount - 1) + pname:offset + sizeof(sname:VkDrawIndirectCommand)) must: be less than or equal to the size of pname:buffer</usage> 3929 <usage>pname:drawCount must: be less than or equal to sname:VkPhysicalDeviceLimits::pname:maxDrawIndirectCount</usage> 3930 <usage>Every input attachment used by the current subpass must: be bound to the pipeline via a descriptor set</usage> 3931 <usage>If any sname:VkSampler object that is accessed from a shader by the sname:VkPipeline currently bound to ename:VK_PIPELINE_BIND_POINT_GRAPHICS uses unnormalized coordinates, it mustnot: be used to sample from any sname:VkImage with a sname:VkImageView of the type ename:VK_IMAGE_VIEW_TYPE_3D, ename:VK_IMAGE_VIEW_TYPE_CUBE, ename:VK_IMAGE_VIEW_TYPE_1D_ARRAY, ename:VK_IMAGE_VIEW_TYPE_2D_ARRAY or ename:VK_IMAGE_VIEW_TYPE_CUBE_ARRAY, in any shader stage</usage> 3932 <usage>If any sname:VkSampler object that is accessed from a shader by the sname:VkPipeline currently bound to ename:VK_PIPELINE_BIND_POINT_GRAPHICS uses unnormalized coordinates, it mustnot: be used with any of the SPIR-V `OpImageSample*` or `OpImageSparseSample*` instructions with "ImplicitLod", "Dref" or "Proj" in their name, in any shader stage</usage> 3933 <usage>If any sname:VkSampler object that is accessed from a shader by the sname:VkPipeline currently bound to ename:VK_PIPELINE_BIND_POINT_GRAPHICS uses unnormalized coordinates, it mustnot: be used with any of the SPIR-V `OpImageSample*` or `OpImageSparseSample*` instructions that includes a lod bias or any offset values, in any shader stage</usage> 3934 <usage>If the <<features-features-robustBufferAccess,robust buffer access>> feature is not enabled, and any shader stage in the sname:VkPipeline object currently bound to ename:VK_PIPELINE_BIND_POINT_GRAPHICS accesses a uniform buffer, it mustnot: access values outside of the range of that buffer specified in the currently bound descriptor set</usage> 3935 <usage>If the <<features-features-robustBufferAccess,robust buffer access>> feature is not enabled, and any shader stage in the sname:VkPipeline object currently bound to ename:VK_PIPELINE_BIND_POINT_GRAPHICS accesses a storage buffer, it mustnot: access values outside of the range of that buffer specified in the currently bound descriptor set</usage> 3936 </validity> 3937 </command> 3938 <command queues="graphics" renderpass="inside" cmdbufferlevel="primary,secondary"> 3939 <proto><type>void</type> <name>vkCmdDrawIndexedIndirect</name></proto> 3940 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 3941 <param><type>VkBuffer</type> <name>buffer</name></param> 3942 <param><type>VkDeviceSize</type> <name>offset</name></param> 3943 <param><type>uint32_t</type> <name>drawCount</name></param> 3944 <param><type>uint32_t</type> <name>stride</name></param> 3945 <validity> 3946 <usage>The value of pname:offset must: be a multiple of `4`</usage> 3947 <usage>If the <<features-features-multiDrawIndirect,multi-draw indirect>> feature is not enabled, the value of pname:drawCount must: be `0` or `1`</usage> 3948 <usage>If the <<features-features-drawIndirectFirstInstance,drawIndirectFirstInstance>> feature is not enabled, all the pname:firstInstance members of the sname:VkDrawIndexedIndirectCommand structures accessed by this command must: be code:0</usage> 3949 <usage>For each set _n_ that is statically used by the sname:VkPipeline currently bound to ename:VK_PIPELINE_BIND_POINT_GRAPHICS, a descriptor set must: have been bound to _n_ at ename:VK_PIPELINE_BIND_POINT_GRAPHICS, with a sname:VkPipelineLayout that is compatible for set _n_, with the sname:VkPipelineLayout used to create the current sname:VkPipeline, as described in <<descriptorsets-compatibility>></usage> 3950 <usage>For each push constant that is statically used by the sname:VkPipeline currently bound to ename:VK_PIPELINE_BIND_POINT_GRAPHICS, a push constant value must: have been set for ename:VK_PIPELINE_BIND_POINT_GRAPHICS, with a sname:VkPipelineLayout that is compatible for push constants, with the sname:VkPipelineLayout used to create the current sname:VkPipeline, as described in <<descriptorsets-compatibility>></usage> 3951 <usage>Descriptors in each bound descriptor set, specified via fname:vkCmdBindDescriptorSets, must: be valid if they are statically used by the currently bound sname:VkPipeline object, specified via fname:vkCmdBindPipeline</usage> 3952 <usage>All vertex input bindings accessed via vertex input variables declared in the vertex shader entry point's interface must: have valid buffers bound</usage> 3953 <usage>A valid graphics pipeline must: be bound to the current command buffer with ename:VK_PIPELINE_BIND_POINT_GRAPHICS</usage> 3954 <usage>If the sname:VkPipeline object currently bound to ename:VK_PIPELINE_BIND_POINT_GRAPHICS requires any dynamic state, that state must: have been set on the current command buffer</usage> 3955 <usage>If pname:drawCount is greater than `0`, the total value of (pname:stride * (pname:drawCount - 1) + pname:offset + sizeof(sname:VkDrawIndexedIndirectCommand)) must: be less than or equal to the size of pname:buffer</usage> 3956 <usage>pname:drawCount must: be less than or equal to sname:VkPhysicalDeviceLimits::pname:maxDrawIndirectCount</usage> 3957 <usage>Every input attachment used by the current subpass must: be bound to the pipeline via a descriptor set</usage> 3958 <usage>If any sname:VkSampler object that is accessed from a shader by the sname:VkPipeline currently bound to ename:VK_PIPELINE_BIND_POINT_GRAPHICS uses unnormalized coordinates, it mustnot: be used to sample from any sname:VkImage with a sname:VkImageView of the type ename:VK_IMAGE_VIEW_TYPE_3D, ename:VK_IMAGE_VIEW_TYPE_CUBE, ename:VK_IMAGE_VIEW_TYPE_1D_ARRAY, ename:VK_IMAGE_VIEW_TYPE_2D_ARRAY or ename:VK_IMAGE_VIEW_TYPE_CUBE_ARRAY, in any shader stage</usage> 3959 <usage>If any sname:VkSampler object that is accessed from a shader by the sname:VkPipeline currently bound to ename:VK_PIPELINE_BIND_POINT_GRAPHICS uses unnormalized coordinates, it mustnot: be used with any of the SPIR-V `OpImageSample*` or `OpImageSparseSample*` instructions with "ImplicitLod", "Dref" or "Proj" in their name, in any shader stage</usage> 3960 <usage>If any sname:VkSampler object that is accessed from a shader by the sname:VkPipeline currently bound to ename:VK_PIPELINE_BIND_POINT_GRAPHICS uses unnormalized coordinates, it mustnot: be used with any of the SPIR-V `OpImageSample*` or `OpImageSparseSample*` instructions that includes a lod bias or any offset values, in any shader stage</usage> 3961 <usage>If the <<features-features-robustBufferAccess,robust buffer access>> feature is not enabled, and any shader stage in the sname:VkPipeline object currently bound to ename:VK_PIPELINE_BIND_POINT_GRAPHICS accesses a uniform buffer, it mustnot: access values outside of the range of that buffer specified in the currently bound descriptor set</usage> 3962 <usage>If the <<features-features-robustBufferAccess,robust buffer access>> feature is not enabled, and any shader stage in the sname:VkPipeline object currently bound to ename:VK_PIPELINE_BIND_POINT_GRAPHICS accesses a storage buffer, it mustnot: access values outside of the range of that buffer specified in the currently bound descriptor set</usage> 3963 </validity> 3964 </command> 3965 <command queues="compute" renderpass="outside" cmdbufferlevel="primary,secondary"> 3966 <proto><type>void</type> <name>vkCmdDispatch</name></proto> 3967 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 3968 <param><type>uint32_t</type> <name>x</name></param> 3969 <param><type>uint32_t</type> <name>y</name></param> 3970 <param><type>uint32_t</type> <name>z</name></param> 3971 <validity> 3972 <usage>pname:x must: be less than or equal to sname:VkPhysicalDeviceLimits::pname:maxComputeWorkGroupCount[0]</usage> 3973 <usage>pname:y must: be less than or equal to sname:VkPhysicalDeviceLimits::pname:maxComputeWorkGroupCount[1]</usage> 3974 <usage>pname:z must: be less than or equal to sname:VkPhysicalDeviceLimits::pname:maxComputeWorkGroupCount[2]</usage> 3975 <usage>For each set _n_ that is statically used by the sname:VkPipeline currently bound to ename:VK_PIPELINE_BIND_POINT_COMPUTE, a descriptor set must: have been bound to _n_ at ename:VK_PIPELINE_BIND_POINT_COMPUTE, with a sname:VkPipelineLayout that is compatible for set _n_, with the sname:VkPipelineLayout used to create the current sname:VkPipeline, as described in <<descriptorsets-compatibility>></usage> 3976 <usage>Descriptors in each bound descriptor set, specified via fname:vkCmdBindDescriptorSets, must: be valid if they are statically used by the currently bound sname:VkPipeline object, specified via fname:vkCmdBindPipeline</usage> 3977 <usage>A valid compute pipeline must: be bound to the current command buffer with ename:VK_PIPELINE_BIND_POINT_COMPUTE</usage> 3978 <usage>For each push constant that is statically used by the sname:VkPipeline currently bound to ename:VK_PIPELINE_BIND_POINT_COMPUTE, a push constant value must: have been set for ename:VK_PIPELINE_BIND_POINT_COMPUTE, with a sname:VkPipelineLayout that is compatible for push constants with the one used to create the current sname:VkPipeline, as described in <<descriptorsets-compatibility>></usage> 3979 <usage>If any sname:VkSampler object that is accessed from a shader by the sname:VkPipeline currently bound to ename:VK_PIPELINE_BIND_POINT_COMPUTE uses unnormalized coordinates, it mustnot: be used to sample from any sname:VkImage with a sname:VkImageView of the type ename:VK_IMAGE_VIEW_TYPE_3D, ename:VK_IMAGE_VIEW_TYPE_CUBE, ename:VK_IMAGE_VIEW_TYPE_1D_ARRAY, ename:VK_IMAGE_VIEW_TYPE_2D_ARRAY or ename:VK_IMAGE_VIEW_TYPE_CUBE_ARRAY, in any shader stage</usage> 3980 <usage>If any sname:VkSampler object that is accessed from a shader by the sname:VkPipeline currently bound to ename:VK_PIPELINE_BIND_POINT_COMPUTE uses unnormalized coordinates, it mustnot: be used with any of the SPIR-V `OpImageSample*` or `OpImageSparseSample*` instructions with "ImplicitLod", "Dref" or "Proj" in their name, in any shader stage</usage> 3981 <usage>If any sname:VkSampler object that is accessed from a shader by the sname:VkPipeline currently bound to ename:VK_PIPELINE_BIND_POINT_COMPUTE uses unnormalized coordinates, it mustnot: be used with any of the SPIR-V `OpImageSample*` or `OpImageSparseSample*` instructions that includes a lod bias or any offset values, in any shader stage</usage> 3982 <usage>If the <<features-features-robustBufferAccess,robust buffer access>> feature is not enabled, and any shader stage in the sname:VkPipeline object currently bound to ename:VK_PIPELINE_BIND_POINT_COMPUTE accesses a uniform buffer, it mustnot: access values outside of the range of that buffer specified in the currently bound descriptor set</usage> 3983 <usage>If the <<features-features-robustBufferAccess,robust buffer access>> feature is not enabled, and any shader stage in the sname:VkPipeline object currently bound to ename:VK_PIPELINE_BIND_POINT_COMPUTE accesses a storage buffer, it mustnot: access values outside of the range of that buffer specified in the currently bound descriptor set</usage> 3984 </validity> 3985 </command> 3986 <command queues="compute" renderpass="outside" cmdbufferlevel="primary,secondary"> 3987 <proto><type>void</type> <name>vkCmdDispatchIndirect</name></proto> 3988 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 3989 <param><type>VkBuffer</type> <name>buffer</name></param> 3990 <param><type>VkDeviceSize</type> <name>offset</name></param> 3991 <validity> 3992 <usage>For each set _n_ that is statically used by the sname:VkPipeline currently bound to ename:VK_PIPELINE_BIND_POINT_COMPUTE, a descriptor set must: have been bound to _n_ at ename:VK_PIPELINE_BIND_POINT_COMPUTE, with a sname:VkPipelineLayout that is compatible for set _n_, with the sname:VkPipelineLayout used to create the current sname:VkPipeline, as described in <<descriptorsets-compatibility>></usage> 3993 <usage>Descriptors in each bound descriptor set, specified via fname:vkCmdBindDescriptorSets, must: be valid if they are statically used by the currently bound sname:VkPipeline object, specified via fname:vkCmdBindPipeline</usage> 3994 <usage>A valid compute pipeline must: be bound to the current command buffer with ename:VK_PIPELINE_BIND_POINT_COMPUTE</usage> 3995 <usage>pname:buffer must: have been created with the ename:VK_BUFFER_USAGE_INDIRECT_BUFFER_BIT bit set</usage> 3996 <usage>The value of pname:offset must: be a multiple of `4`</usage> 3997 <usage>The sum of pname:offset and the size of sname:VkDispatchIndirectCommand must: be less than or equal to the size of pname:buffer</usage> 3998 <usage>For each push constant that is statically used by the sname:VkPipeline currently bound to ename:VK_PIPELINE_BIND_POINT_COMPUTE, a push constant value must: have been set for ename:VK_PIPELINE_BIND_POINT_COMPUTE, with a sname:VkPipelineLayout that is compatible for push constants with the one used to create the current sname:VkPipeline, as described in <<descriptorsets-compatibility>></usage> 3999 <usage>If any sname:VkSampler object that is accessed from a shader by the sname:VkPipeline currently bound to ename:VK_PIPELINE_BIND_POINT_COMPUTE uses unnormalized coordinates, it mustnot: be used to sample from any sname:VkImage with a sname:VkImageView of the type ename:VK_IMAGE_VIEW_TYPE_3D, ename:VK_IMAGE_VIEW_TYPE_CUBE, ename:VK_IMAGE_VIEW_TYPE_1D_ARRAY, ename:VK_IMAGE_VIEW_TYPE_2D_ARRAY or ename:VK_IMAGE_VIEW_TYPE_CUBE_ARRAY, in any shader stage</usage> 4000 <usage>If any sname:VkSampler object that is accessed from a shader by the sname:VkPipeline currently bound to ename:VK_PIPELINE_BIND_POINT_COMPUTE uses unnormalized coordinates, it mustnot: be used with any of the SPIR-V `OpImageSample*` or `OpImageSparseSample*` instructions with "ImplicitLod", "Dref" or "Proj" in their name, in any shader stage</usage> 4001 <usage>If any sname:VkSampler object that is accessed from a shader by the sname:VkPipeline currently bound to ename:VK_PIPELINE_BIND_POINT_COMPUTE uses unnormalized coordinates, it mustnot: be used with any of the SPIR-V `OpImageSample*` or `OpImageSparseSample*` instructions that includes a lod bias or any offset values, in any shader stage</usage> 4002 <usage>If the <<features-features-robustBufferAccess,robust buffer access>> feature is not enabled, and any shader stage in the sname:VkPipeline object currently bound to ename:VK_PIPELINE_BIND_POINT_COMPUTE accesses a uniform buffer, it mustnot: access values outside of the range of that buffer specified in the currently bound descriptor set</usage> 4003 <usage>If the <<features-features-robustBufferAccess,robust buffer access>> feature is not enabled, and any shader stage in the sname:VkPipeline object currently bound to ename:VK_PIPELINE_BIND_POINT_COMPUTE accesses a storage buffer, it mustnot: access values outside of the range of that buffer specified in the currently bound descriptor set</usage> 4004 </validity> 4005 </command> 4006 <command queues="transfer,graphics,compute" renderpass="outside" cmdbufferlevel="primary,secondary"> 4007 <proto><type>void</type> <name>vkCmdCopyBuffer</name></proto> 4008 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 4009 <param><type>VkBuffer</type> <name>srcBuffer</name></param> 4010 <param><type>VkBuffer</type> <name>dstBuffer</name></param> 4011 <param><type>uint32_t</type> <name>regionCount</name></param> 4012 <param len="regionCount">const <type>VkBufferCopy</type>* <name>pRegions</name></param> 4013 <validity> 4014 <usage>The sum of the pname:srcOffset and pname:copySize members of a given element of pname:pRegions must: be less than or equal to the size of pname:srcBuffer</usage> 4015 <usage>The sum of the pname:dstOffset and pname:copySize members of a given element of pname:pRegions must: be less than or equal to the size of pname:dstBuffer</usage> 4016 <usage>The union of the source regions, and the union of the destination regions, specified by the elements of pname:pRegions, mustnot: overlap in memory</usage> 4017 <usage>pname:srcBuffer must: have been created with pname:VK_BUFFER_USAGE_TRANSFER_SRC_BIT usage flag</usage> 4018 <usage>pname:dstBuffer must: have been created with pname:VK_BUFFER_USAGE_TRANSFER_DST_BIT usage flag</usage> 4019 </validity> 4020 </command> 4021 <command queues="transfer,graphics,compute" renderpass="outside" cmdbufferlevel="primary,secondary"> 4022 <proto><type>void</type> <name>vkCmdCopyImage</name></proto> 4023 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 4024 <param><type>VkImage</type> <name>srcImage</name></param> 4025 <param><type>VkImageLayout</type> <name>srcImageLayout</name></param> 4026 <param><type>VkImage</type> <name>dstImage</name></param> 4027 <param><type>VkImageLayout</type> <name>dstImageLayout</name></param> 4028 <param><type>uint32_t</type> <name>regionCount</name></param> 4029 <param len="regionCount">const <type>VkImageCopy</type>* <name>pRegions</name></param> 4030 <validity> 4031 <usage>The source region specified by a given element of pname:pRegions must: be a region that is contained within pname:srcImage</usage> 4032 <usage>The destination region specified by a given element of pname:pRegions must: be a region that is contained within pname:dstImage</usage> 4033 <usage>The union of all source regions, and the union of all destination regions, specified by the elements of pname:pRegions, mustnot: overlap in memory</usage> 4034 <usage>pname:srcImage must: have been created with pname:VK_IMAGE_USAGE_TRANSFER_SRC_BIT usage flag</usage> 4035 <usage>pname:srcImageLayout must: specify the layout of the subresources of pname:srcImage specified in pname:pRegions at the time this command is executed on a sname:VkDevice</usage> 4036 <usage>pname:srcImageLayout must: be either of VK_IMAGE_LAYOUT_TRANSFER_SRC_OPTIMAL or VK_IMAGE_LAYOUT_GENERAL</usage> 4037 <usage>pname:dstImage must: have been created with pname:VK_IMAGE_USAGE_TRANSFER_DST_BIT usage flag</usage> 4038 <usage>pname:dstImageLayout must: specify the layout of the subresources of pname:dstImage specified in pname:pRegions at the time this command is executed on a sname:VkDevice</usage> 4039 <usage>pname:dstImageLayout must: be either of VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL or VK_IMAGE_LAYOUT_GENERAL</usage> 4040 <usage>The elink:VkFormat of each of pname:srcImage and pname:dstImage must: be compatible, as defined <<copies-images-format-compatibility, below>></usage> 4041 <usage>The sample count of pname:srcImage and pname:dstImage must: match</usage> 4042 </validity> 4043 </command> 4044 <command queues="graphics" renderpass="outside" cmdbufferlevel="primary,secondary"> 4045 <proto><type>void</type> <name>vkCmdBlitImage</name></proto> 4046 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 4047 <param><type>VkImage</type> <name>srcImage</name></param> 4048 <param><type>VkImageLayout</type> <name>srcImageLayout</name></param> 4049 <param><type>VkImage</type> <name>dstImage</name></param> 4050 <param><type>VkImageLayout</type> <name>dstImageLayout</name></param> 4051 <param><type>uint32_t</type> <name>regionCount</name></param> 4052 <param len="regionCount">const <type>VkImageBlit</type>* <name>pRegions</name></param> 4053 <param><type>VkFilter</type> <name>filter</name></param> 4054 <validity> 4055 <usage>The source region specified by a given element of pname:pRegions must: be a region that is contained within pname:srcImage</usage> 4056 <usage>The destination region specified by a given element of pname:pRegions must: be a region that is contained within pname:dstImage</usage> 4057 <usage>The union of all source regions, and the union of all destination regions, specified by the elements of pname:pRegions, mustnot: overlap in memory</usage> 4058 <usage>pname:srcImage must: use a format that supports ename:VK_FORMAT_FEATURE_BLIT_SRC_BIT, which is indicated by sname:VkFormatProperties::pname:linearTilingFeatures (for linear tiled images) or sname:VkFormatProperties::pname:optimalTilingFeatures (for optimally tiled images) - as returned by fname:vkGetPhysicalDeviceFormatProperties</usage> 4059 <usage>pname:srcImage must: have been created with pname:VK_IMAGE_USAGE_TRANSFER_SRC_BIT usage flag</usage> 4060 <usage>pname:srcImageLayout must: specify the layout of the subresources of pname:srcImage specified in pname:pRegions at the time this command is executed on a sname:VkDevice</usage> 4061 <usage>pname:srcImageLayout must: be either of VK_IMAGE_LAYOUT_TRANSFER_SRC_OPTIMAL or VK_IMAGE_LAYOUT_GENERAL</usage> 4062 <usage>pname:dstImage must: use a format that supports ename:VK_FORMAT_FEATURE_BLIT_DST_BIT, which is indicated by sname:VkFormatProperties::pname:linearTilingFeatures (for linear tiled images) or sname:VkFormatProperties::pname:optimalTilingFeatures (for optimally tiled images) - as returned by fname:vkGetPhysicalDeviceFormatProperties</usage> 4063 <usage>pname:dstImage must: have been created with pname:VK_IMAGE_USAGE_TRANSFER_DST_BIT usage flag</usage> 4064 <usage>pname:dstImageLayout must: specify the layout of the subresources of pname:dstImage specified in pname:pRegions at the time this command is executed on a sname:VkDevice</usage> 4065 <usage>pname:dstImageLayout must: be either of VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL or VK_IMAGE_LAYOUT_GENERAL</usage> 4066 <usage>The sample count of pname:srcImage and pname:dstImage must: both be equal to ename:VK_SAMPLE_COUNT_1_BIT</usage> 4067 <usage>If either of pname:srcImage or pname:dstImage was created with a signed integer elink:VkFormat, the other must: also have been created with a signed integer elink:VkFormat</usage> 4068 <usage>If either of pname:srcImage or pname:dstImage was created with an unsigned integer elink:VkFormat, the other must: also have been created with an unsigned integer elink:VkFormat</usage> 4069 <usage>If either of pname:srcImage or pname:dstImage was created with a depth/stencil format, the other must: have exactly the same format</usage> 4070 <usage>If pname:srcImage was created with a depth/stencil format, pname:filter must: be ename:VK_FILTER_NEAREST</usage> 4071 </validity> 4072 </command> 4073 <command queues="transfer,graphics,compute" renderpass="outside" cmdbufferlevel="primary,secondary"> 4074 <proto><type>void</type> <name>vkCmdCopyBufferToImage</name></proto> 4075 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 4076 <param><type>VkBuffer</type> <name>srcBuffer</name></param> 4077 <param><type>VkImage</type> <name>dstImage</name></param> 4078 <param><type>VkImageLayout</type> <name>dstImageLayout</name></param> 4079 <param><type>uint32_t</type> <name>regionCount</name></param> 4080 <param len="regionCount">const <type>VkBufferImageCopy</type>* <name>pRegions</name></param> 4081 <validity> 4082 <usage>The buffer region specified by a given element of pname:pRegions must: be a region that is contained within pname:srcBuffer</usage> 4083 <usage>The image region specified by a given element of pname:pRegions must: be a region that is contained within pname:dstImage</usage> 4084 <usage>The union of all source regions, and the union of all destination regions, specified by the elements of pname:pRegions, mustnot: overlap in memory</usage> 4085 <usage>pname:srcBuffer must: have been created with pname:VK_BUFFER_USAGE_TRANSFER_SRC_BIT usage flag</usage> 4086 <usage>pname:dstImage must: have been created with pname:VK_IMAGE_USAGE_TRANSFER_DST_BIT usage flag</usage> 4087 <usage>pname:dstImage must: have a sample count equal to ename:VK_SAMPLE_COUNT_1_BIT</usage> 4088 <usage>pname:dstImageLayout must: specify the layout of the subresources of pname:dstImage specified in pname:pRegions at the time this command is executed on a sname:VkDevice</usage> 4089 <usage>pname:dstImageLayout must: be either of VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL or VK_IMAGE_LAYOUT_GENERAL</usage> 4090 </validity> 4091 </command> 4092 <command queues="transfer,graphics,compute" renderpass="outside" cmdbufferlevel="primary,secondary"> 4093 <proto><type>void</type> <name>vkCmdCopyImageToBuffer</name></proto> 4094 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 4095 <param><type>VkImage</type> <name>srcImage</name></param> 4096 <param><type>VkImageLayout</type> <name>srcImageLayout</name></param> 4097 <param><type>VkBuffer</type> <name>dstBuffer</name></param> 4098 <param><type>uint32_t</type> <name>regionCount</name></param> 4099 <param len="regionCount">const <type>VkBufferImageCopy</type>* <name>pRegions</name></param> 4100 <validity> 4101 <usage>The image region specified by a given element of pname:pRegions must: be a region that is contained within pname:srcImage</usage> 4102 <usage>The buffer region specified by a given element of pname:pRegions must: be a region that is contained within pname:dstBuffer</usage> 4103 <usage>The union of all source regions, and the union of all destination regions, specified by the elements of pname:pRegions, mustnot: overlap in memory</usage> 4104 <usage>pname:srcImage must: have been created with pname:VK_IMAGE_USAGE_TRANSFER_SRC_BIT usage flag</usage> 4105 <usage>pname:srcImage must: have a sample count equal to ename:VK_SAMPLE_COUNT_1_BIT</usage> 4106 <usage>pname:srcImageLayout must: specify the layout of the subresources of pname:srcImage specified in pname:pRegions at the time this command is executed on a sname:VkDevice</usage> 4107 <usage>pname:srcImageLayout must: be either of VK_IMAGE_LAYOUT_TRANSFER_SRC_OPTIMAL or VK_IMAGE_LAYOUT_GENERAL</usage> 4108 <usage>pname:dstBuffer must: have been created with pname:VK_BUFFER_USAGE_TRANSFER_DST_BIT usage flag</usage> 4109 </validity> 4110 </command> 4111 <command queues="transfer,graphics,compute" renderpass="outside" cmdbufferlevel="primary,secondary"> 4112 <proto><type>void</type> <name>vkCmdUpdateBuffer</name></proto> 4113 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 4114 <param><type>VkBuffer</type> <name>dstBuffer</name></param> 4115 <param><type>VkDeviceSize</type> <name>dstOffset</name></param> 4116 <param><type>VkDeviceSize</type> <name>dataSize</name></param> 4117 <param len="dataSize/4">const <type>uint32_t</type>* <name>pData</name></param> 4118 <validity> 4119 <usage>The sum of pname:dstOffset and pname:dataSize must: be less than or equal to the size of pname:dstBuffer</usage> 4120 <usage>pname:dstBuffer must: have been created with pname:VK_BUFFER_USAGE_TRANSFER_DST_BIT usage flag</usage> 4121 <usage>The value of pname:dstOffset must: be a multiple of `4`</usage> 4122 <usage>The value of pname:dataSize must: be greater than `0`</usage> 4123 <usage>The value of pname:dataSize must: be less than `65536`</usage> 4124 <usage>The value of pname:dataSize must: be a multiple of `4`</usage> 4125 </validity> 4126 </command> 4127 <command queues="graphics,compute" renderpass="outside" cmdbufferlevel="primary,secondary"> 4128 <proto><type>void</type> <name>vkCmdFillBuffer</name></proto> 4129 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 4130 <param><type>VkBuffer</type> <name>dstBuffer</name></param> 4131 <param><type>VkDeviceSize</type> <name>dstOffset</name></param> 4132 <param><type>VkDeviceSize</type> <name>size</name></param> 4133 <param><type>uint32_t</type> <name>data</name></param> 4134 <validity> 4135 <usage>If pname:size is not equal to ename:VK_WHOLE_SIZE, the sum of pname:dstOffset and pname:size must: be less than or equal to the size of pname:dstBuffer</usage> 4136 <usage>pname:dstBuffer must: have been created with pname:VK_BUFFER_USAGE_TRANSFER_DST_BIT usage flag</usage> 4137 <usage>pname:dstOffset must: be a multiple of `4`</usage> 4138 <usage>If pname:size is not equal to ename:VK_WHOLE_SIZE, pname:size must: be a multiple of `4`</usage> 4139 </validity> 4140 </command> 4141 <command queues="graphics,compute" renderpass="outside" cmdbufferlevel="primary,secondary"> 4142 <proto><type>void</type> <name>vkCmdClearColorImage</name></proto> 4143 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 4144 <param><type>VkImage</type> <name>image</name></param> 4145 <param><type>VkImageLayout</type> <name>imageLayout</name></param> 4146 <param>const <type>VkClearColorValue</type>* <name>pColor</name></param> 4147 <param><type>uint32_t</type> <name>rangeCount</name></param> 4148 <param len="rangeCount">const <type>VkImageSubresourceRange</type>* <name>pRanges</name></param> 4149 <validity> 4150 <usage>pname:image must: have been created with pname:VK_IMAGE_USAGE_TRANSFER_DST_BIT usage flag</usage> 4151 <usage>pname:imageLayout must: specify the layout of the subresource ranges of pname:image specified in pname:pRanges at the time this command is executed on a sname:VkDevice</usage> 4152 <usage>pname:imageLayout must: be either of VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL or VK_IMAGE_LAYOUT_GENERAL</usage> 4153 <usage>The image range of any given element of pname:pRanges must: be a subresource range that is contained within pname:image</usage> 4154 </validity> 4155 </command> 4156 <command queues="graphics" renderpass="outside" cmdbufferlevel="primary,secondary"> 4157 <proto><type>void</type> <name>vkCmdClearDepthStencilImage</name></proto> 4158 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 4159 <param><type>VkImage</type> <name>image</name></param> 4160 <param><type>VkImageLayout</type> <name>imageLayout</name></param> 4161 <param>const <type>VkClearDepthStencilValue</type>* <name>pDepthStencil</name></param> 4162 <param><type>uint32_t</type> <name>rangeCount</name></param> 4163 <param len="rangeCount">const <type>VkImageSubresourceRange</type>* <name>pRanges</name></param> 4164 <validity> 4165 <usage>pname:image must: have been created with pname:VK_IMAGE_USAGE_TRANSFER_DST_BIT usage flag</usage> 4166 <usage>pname:imageLayout must: specify the layout of the subresource ranges of pname:image specified in pname:pRanges at the time this command is executed on a sname:VkDevice</usage> 4167 <usage>pname:imageLayout must: be either of VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL or VK_IMAGE_LAYOUT_GENERAL</usage> 4168 <usage>The image range of any given element of pname:pRanges must: be a subresource range that is contained within pname:image</usage> 4169 </validity> 4170 </command> 4171 <command queues="graphics" renderpass="inside" cmdbufferlevel="primary,secondary"> 4172 <proto><type>void</type> <name>vkCmdClearAttachments</name></proto> 4173 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 4174 <param><type>uint32_t</type> <name>attachmentCount</name></param> 4175 <param len="attachmentCount">const <type>VkClearAttachment</type>* <name>pAttachments</name></param> 4176 <param><type>uint32_t</type> <name>rectCount</name></param> 4177 <param len="rectCount">const <type>VkClearRect</type>* <name>pRects</name></param> 4178 <validity> 4179 <usage>If the pname:aspectMask member of any given element of pname:pAttachments contains ename:VK_IMAGE_ASPECT_COLOR_BIT, the pname:colorAttachment member of those elements must: refer to a valid color attachment in the current subpass</usage> 4180 <usage>The rectangular region specified by a given element of pname:pRects must: be contained within the render area of the current render pass instance</usage> 4181 <usage>The layers specified by a given element of pname:pRects must: be contained within every attachment that pname:pAttachments refers to</usage> 4182 </validity> 4183 </command> 4184 <command queues="graphics" renderpass="outside" cmdbufferlevel="primary,secondary"> 4185 <proto><type>void</type> <name>vkCmdResolveImage</name></proto> 4186 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 4187 <param><type>VkImage</type> <name>srcImage</name></param> 4188 <param><type>VkImageLayout</type> <name>srcImageLayout</name></param> 4189 <param><type>VkImage</type> <name>dstImage</name></param> 4190 <param><type>VkImageLayout</type> <name>dstImageLayout</name></param> 4191 <param><type>uint32_t</type> <name>regionCount</name></param> 4192 <param len="regionCount">const <type>VkImageResolve</type>* <name>pRegions</name></param> 4193 <validity> 4194 <usage>The source region specified by a given element of pname:pRegions must: be a region that is contained within pname:srcImage</usage> 4195 <usage>The destination region specified by a given element of pname:pRegions must: be a region that is contained within pname:dstImage</usage> 4196 <usage>The union of all source regions, and the union of all destination regions, specified by the elements of pname:pRegions, mustnot: overlap in memory</usage> 4197 <usage>pname:srcImage must: have a sample count equal to any valid sample count value other than ename:VK_SAMPLE_COUNT_1_BIT</usage> 4198 <usage>pname:dstImage must: have a sample count equal to ename:VK_SAMPLE_COUNT_1_BIT</usage> 4199 <usage>pname:srcImageLayout must: specify the layout of the subresources of pname:srcImage specified in pname:pRegions at the time this command is executed on a sname:VkDevice</usage> 4200 <usage>pname:srcImageLayout must: be either of VK_IMAGE_LAYOUT_TRANSFER_SRC_OPTIMAL or VK_IMAGE_LAYOUT_GENERAL</usage> 4201 <usage>pname:dstImageLayout must: specify the layout of the subresources of pname:dstImage specified in pname:pRegions at the time this command is executed on a sname:VkDevice</usage> 4202 <usage>pname:dstImageLayout must: be either of VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL or VK_IMAGE_LAYOUT_GENERAL</usage> 4203 <usage>If pname:dstImage was created with pname:tiling equal to ename:VK_IMAGE_TILING_LINEAR, pname:dstImage must: have been created with a pname:format that supports being a color attachment, as specified by the ename:VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BIT flag in sname:VkFormatProperties::pname:linearTilingFeatures returned by fname:vkGetPhysicalDeviceFormatProperties</usage> 4204 <usage>If pname:dstImage was created with pname:tiling equal to ename:VK_IMAGE_TILING_OPTIMAL, pname:dstImage must: have been created with a pname:format that supports being a color attachment, as specified by the ename:VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BIT flag in sname:VkFormatProperties::pname:optimalTilingFeatures returned by fname:vkGetPhysicalDeviceFormatProperties</usage> 4205 4206 </validity> 4207 </command> 4208 <command queues="graphics,compute" renderpass="outside" cmdbufferlevel="primary,secondary"> 4209 <proto><type>void</type> <name>vkCmdSetEvent</name></proto> 4210 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 4211 <param><type>VkEvent</type> <name>event</name></param> 4212 <param><type>VkPipelineStageFlags</type> <name>stageMask</name></param> 4213 <validity> 4214 <usage>If the <<features-features-geometryShader,geometry shaders>> feature is not enabled, pname:stageMask mustnot: contain pname:VK_PIPELINE_STAGE_GEOMETRY_SHADER_BIT</usage> 4215 <usage>If the <<features-features-tessellationShader,tessellation shaders>> feature is not enabled, pname:stageMask mustnot: contain pname:VK_PIPELINE_STAGE_TESSELLATION_CONTROL_SHADER_BIT or pname:VK_PIPELINE_STAGE_TESSELLATION_EVALUATION_SHADER_BIT</usage> 4216 </validity> 4217 </command> 4218 <command queues="graphics,compute" renderpass="outside" cmdbufferlevel="primary,secondary"> 4219 <proto><type>void</type> <name>vkCmdResetEvent</name></proto> 4220 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 4221 <param><type>VkEvent</type> <name>event</name></param> 4222 <param><type>VkPipelineStageFlags</type> <name>stageMask</name></param> 4223 <validity> 4224 <usage>If the <<features-features-geometryShader,geometry shaders>> feature is not enabled, pname:stageMask mustnot: contain pname:VK_PIPELINE_STAGE_GEOMETRY_SHADER_BIT</usage> 4225 <usage>If the <<features-features-tessellationShader,tessellation shaders>> feature is not enabled, pname:stageMask mustnot: contain pname:VK_PIPELINE_STAGE_TESSELLATION_CONTROL_SHADER_BIT or pname:VK_PIPELINE_STAGE_TESSELLATION_EVALUATION_SHADER_BIT</usage> 4226 </validity> 4227 </command> 4228 <command queues="graphics,compute" renderpass="both" cmdbufferlevel="primary,secondary"> 4229 <proto><type>void</type> <name>vkCmdWaitEvents</name></proto> 4230 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 4231 <param><type>uint32_t</type> <name>eventCount</name></param> 4232 <param len="eventCount">const <type>VkEvent</type>* <name>pEvents</name></param> 4233 <param><type>VkPipelineStageFlags</type> <name>srcStageMask</name></param> 4234 <param><type>VkPipelineStageFlags</type> <name>dstStageMask</name></param> 4235 <param optional="true"><type>uint32_t</type> <name>memoryBarrierCount</name></param> 4236 <param len="memoryBarrierCount">const <type>VkMemoryBarrier</type>* <name>pMemoryBarriers</name></param> 4237 <param optional="true"><type>uint32_t</type> <name>bufferMemoryBarrierCount</name></param> 4238 <param len="bufferMemoryBarrierCount">const <type>VkBufferMemoryBarrier</type>* <name>pBufferMemoryBarriers</name></param> 4239 <param optional="true"><type>uint32_t</type> <name>imageMemoryBarrierCount</name></param> 4240 <param len="imageMemoryBarrierCount">const <type>VkImageMemoryBarrier</type>* <name>pImageMemoryBarriers</name></param> 4241 <validity> 4242 <usage>pname:srcStageMask must: be the bitwise OR of the pname:stageMask parameter used in previous calls to fname:vkCmdSetEvent with any of the members of pname:pEvents</usage> 4243 <usage>If fname:vkSetEvent was used to signal any of the events in pname:pEvents, pname:srcStageMask must: include the ename:VK_PIPELINE_STAGE_HOST_BIT flag</usage> 4244 <usage>If the <<features-features-geometryShader,geometry shaders>> feature is not enabled, pname:srcStageMask mustnot: contain pname:VK_PIPELINE_STAGE_GEOMETRY_SHADER_BIT</usage> 4245 <usage>If the <<features-features-geometryShader,geometry shaders>> feature is not enabled, pname:dstStageMask mustnot: contain pname:VK_PIPELINE_STAGE_GEOMETRY_SHADER_BIT</usage> 4246 <usage>If the <<features-features-tessellationShader,tessellation shaders>> feature is not enabled, pname:srcStageMask mustnot: contain pname:VK_PIPELINE_STAGE_TESSELLATION_CONTROL_SHADER_BIT or pname:VK_PIPELINE_STAGE_TESSELLATION_EVALUATION_SHADER_BIT</usage> 4247 <usage>If the <<features-features-tessellationShader,tessellation shaders>> feature is not enabled, pname:dstStageMask mustnot: contain pname:VK_PIPELINE_STAGE_TESSELLATION_CONTROL_SHADER_BIT or pname:VK_PIPELINE_STAGE_TESSELLATION_EVALUATION_SHADER_BIT</usage> 4248 <usage>If pname:pEvents includes one or more events that will be signaled by fname:vkSetEvent after pname:commandBuffer has been submitted to a queue, then fname:vkCmdWaitEvents mustnot: be called inside a render pass instance</usage> 4249 </validity> 4250 </command> 4251 <command queues="transfer,graphics,compute" renderpass="both" cmdbufferlevel="primary,secondary"> 4252 <proto><type>void</type> <name>vkCmdPipelineBarrier</name></proto> 4253 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 4254 <param><type>VkPipelineStageFlags</type> <name>srcStageMask</name></param> 4255 <param><type>VkPipelineStageFlags</type> <name>dstStageMask</name></param> 4256 <param optional="true"><type>VkDependencyFlags</type> <name>dependencyFlags</name></param> 4257 <param optional="true"><type>uint32_t</type> <name>memoryBarrierCount</name></param> 4258 <param len="memoryBarrierCount">const <type>VkMemoryBarrier</type>* <name>pMemoryBarriers</name></param> 4259 <param optional="true"><type>uint32_t</type> <name>bufferMemoryBarrierCount</name></param> 4260 <param len="bufferMemoryBarrierCount">const <type>VkBufferMemoryBarrier</type>* <name>pBufferMemoryBarriers</name></param> 4261 <param optional="true"><type>uint32_t</type> <name>imageMemoryBarrierCount</name></param> 4262 <param len="imageMemoryBarrierCount">const <type>VkImageMemoryBarrier</type>* <name>pImageMemoryBarriers</name></param> 4263 <validity> 4264 <usage>If the <<features-features-geometryShader,geometry shaders>> feature is not enabled, pname:srcStageMask mustnot: contain pname:VK_PIPELINE_STAGE_GEOMETRY_SHADER_BIT</usage> 4265 <usage>If the <<features-features-geometryShader,geometry shaders>> feature is not enabled, pname:dstStageMask mustnot: contain pname:VK_PIPELINE_STAGE_GEOMETRY_SHADER_BIT</usage> 4266 <usage>If the <<features-features-tessellationShader,tessellation shaders>> feature is not enabled, pname:srcStageMask mustnot: contain pname:VK_PIPELINE_STAGE_TESSELLATION_CONTROL_SHADER_BIT or pname:VK_PIPELINE_STAGE_TESSELLATION_EVALUATION_SHADER_BIT</usage> 4267 <usage>If the <<features-features-tessellationShader,tessellation shaders>> feature is not enabled, pname:dstStageMask mustnot: contain pname:VK_PIPELINE_STAGE_TESSELLATION_CONTROL_SHADER_BIT or pname:VK_PIPELINE_STAGE_TESSELLATION_EVALUATION_SHADER_BIT</usage> 4268 <usage>If fname:vkCmdPipelineBarrier is called within a render pass instance, the render pass must: declare at least one self-dependency from the current subpass to itself - see <<synchronization-pipeline-barriers-subpass-self-dependencies,Subpass Self-dependency>></usage> 4269 </validity> 4270 </command> 4271 <command queues="graphics,compute" renderpass="both" cmdbufferlevel="primary,secondary"> 4272 <proto><type>void</type> <name>vkCmdBeginQuery</name></proto> 4273 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 4274 <param><type>VkQueryPool</type> <name>queryPool</name></param> 4275 <param><type>uint32_t</type> <name>query</name></param> 4276 <param optional="true"><type>VkQueryControlFlags</type> <name>flags</name></param> 4277 <validity> 4278 <usage>The query identified by pname:queryPool and pname:query must: currently not be <<queries-operation-active,active>></usage> 4279 <usage>The query identified by pname:queryPool and pname:query must: be unavailable</usage> 4280 <usage>If the <<features-features-occlusionQueryPrecise,precise occlusion queries>> feature is not enabled, or the pname:queryType used to create pname:queryPool was not ename:VK_QUERY_TYPE_OCCLUSION, pname:flags mustnot: contain ename:VK_QUERY_CONTROL_PRECISE_BIT</usage> 4281 <usage>pname:queryPool must: have been created with a pname:queryType that differs from that of any other queries that have been made <<queries-operation-active,active>>, and are currently still active within pname:commandBuffer</usage> 4282 <usage>pname:query must: be less than the number of queries in pname:queryPool</usage> 4283 <usage>If the pname:queryType used to create pname:queryPool was ename:VK_QUERY_TYPE_OCCLUSION, the sname:VkCommandPool that pname:commandBuffer was created from must: support graphics operations</usage> 4284 <usage>If the pname:queryType used to create pname:queryPool was ename:VK_QUERY_TYPE_PIPELINE_STATISTICS and any of the pname:pipelineStatistics indicate graphics operations, the sname:VkCommandPool that pname:commandBuffer was created from must: support graphics operations</usage> 4285 <usage>If the pname:queryType used to create pname:queryPool was ename:VK_QUERY_TYPE_PIPELINE_STATISTICS and any of the pname:pipelineStatistics indicate compute operations, the sname:VkCommandPool that pname:commandBuffer was created from must: support compute operations</usage> 4286 </validity> 4287 </command> 4288 <command queues="graphics,compute" renderpass="both" cmdbufferlevel="primary,secondary"> 4289 <proto><type>void</type> <name>vkCmdEndQuery</name></proto> 4290 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 4291 <param><type>VkQueryPool</type> <name>queryPool</name></param> 4292 <param><type>uint32_t</type> <name>query</name></param> 4293 <validity> 4294 <usage>The query identified by pname:queryPool and pname:query must: currently be <<queries-operation-active,active>></usage> 4295 <usage>pname:query must: be less than the number of queries in pname:queryPool</usage> 4296 </validity> 4297 </command> 4298 <command queues="graphics,compute" renderpass="outside" cmdbufferlevel="primary,secondary"> 4299 <proto><type>void</type> <name>vkCmdResetQueryPool</name></proto> 4300 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 4301 <param><type>VkQueryPool</type> <name>queryPool</name></param> 4302 <param><type>uint32_t</type> <name>firstQuery</name></param> 4303 <param><type>uint32_t</type> <name>queryCount</name></param> 4304 <validity> 4305 <usage>pname:firstQuery must: be less than the number of queries in pname:queryPool</usage> 4306 <usage>The sum of pname:firstQuery and pname:queryCount must: be less than or equal to the number of queries in pname:queryPool</usage> 4307 </validity> 4308 </command> 4309 <command queues="graphics,compute" renderpass="both" cmdbufferlevel="primary,secondary"> 4310 <proto><type>void</type> <name>vkCmdWriteTimestamp</name></proto> 4311 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 4312 <param><type>VkPipelineStageFlagBits</type> <name>pipelineStage</name></param> 4313 <param><type>VkQueryPool</type> <name>queryPool</name></param> 4314 <param><type>uint32_t</type> <name>query</name></param> 4315 <validity> 4316 <usage>The query identified by pname:queryPool and pname:query must: be _unavailable_</usage> 4317 <usage>The command pool's queue family must: support a non-zero value of pname:timestampValidBits</usage> 4318 </validity> 4319 </command> 4320 <command queues="graphics,compute" renderpass="outside" cmdbufferlevel="primary,secondary"> 4321 <proto><type>void</type> <name>vkCmdCopyQueryPoolResults</name></proto> 4322 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 4323 <param><type>VkQueryPool</type> <name>queryPool</name></param> 4324 <param><type>uint32_t</type> <name>firstQuery</name></param> 4325 <param><type>uint32_t</type> <name>queryCount</name></param> 4326 <param><type>VkBuffer</type> <name>dstBuffer</name></param> 4327 <param><type>VkDeviceSize</type> <name>dstOffset</name></param> 4328 <param><type>VkDeviceSize</type> <name>stride</name></param> 4329 <param optional="true"><type>VkQueryResultFlags</type> <name>flags</name></param> 4330 <validity> 4331 <usage>pname:firstQuery must: be less than the number of queries in pname:queryPool</usage> 4332 <usage>The sum of pname:firstQuery and pname:queryCount must: be less than or equal to the number of queries in pname:queryPool</usage> 4333 <usage>If ename:VK_QUERY_RESULT_64_BIT is not set in pname:flags then pname:dstOffset and pname:stride must be multiples of `4`</usage> 4334 <usage>If ename:VK_QUERY_RESULT_64_BIT is set in pname:flags then pname:dstOffset and pname:stride must be multiples of `8`</usage> 4335 <usage>pname:dstBuffer must: have enough storage, from pname:dstOffset, to contain the result of each query, as described <<queries-operation-memorylayout,here>></usage> 4336 <usage>If the pname:queryType used to create pname:queryPool was ename:VK_QUERY_TYPE_TIMESTAMP, pname:flags mustnot: contain ename:VK_QUERY_RESULT_PARTIAL_BIT</usage> 4337 </validity> 4338 </command> 4339 <command queues="graphics,compute" renderpass="both" cmdbufferlevel="primary,secondary"> 4340 <proto><type>void</type> <name>vkCmdPushConstants</name></proto> 4341 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 4342 <param><type>VkPipelineLayout</type> <name>layout</name></param> 4343 <param><type>VkShaderStageFlags</type> <name>stageFlags</name></param> 4344 <param><type>uint32_t</type> <name>offset</name></param> 4345 <param><type>uint32_t</type> <name>size</name></param> 4346 <param len="size">const <type>void</type>* <name>pValues</name></param> 4347 <validity> 4348 <usage>pname:stageFlags must: match exactly the shader stages used in pname:layout for the range specified by pname:offset and pname:size</usage> 4349 <usage>pname:offset must: be a multiple of `4`</usage> 4350 <usage>pname:size must: be a multiple of `4`</usage> 4351 </validity> 4352 </command> 4353 <command queues="graphics" renderpass="outside" cmdbufferlevel="primary"> 4354 <proto><type>void</type> <name>vkCmdBeginRenderPass</name></proto> 4355 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 4356 <param>const <type>VkRenderPassBeginInfo</type>* <name>pRenderPassBegin</name></param> 4357 <param><type>VkSubpassContents</type> <name>contents</name></param> 4358 </command> 4359 <command queues="graphics" renderpass="inside" cmdbufferlevel="primary"> 4360 <proto><type>void</type> <name>vkCmdNextSubpass</name></proto> 4361 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 4362 <param><type>VkSubpassContents</type> <name>contents</name></param> 4363 <validity> 4364 <usage>The current render pass instance mustnot: be in the last subpass, that is - since the call to fname:vkCmdBeginRenderPass, fname:vkCmdNextSubpass must: have been called a number of times at least two less than the number of subpasses in the render pass</usage> 4365 </validity> 4366 </command> 4367 <command queues="graphics" renderpass="inside" cmdbufferlevel="primary"> 4368 <proto><type>void</type> <name>vkCmdEndRenderPass</name></proto> 4369 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 4370 <validity> 4371 <usage>The render pass instance that is being ended must: be in the last subpass, that is - since the call to fname:vkCmdBeginRenderPass, fname:vkCmdNextSubpass must: have been called a number of times equal to one less than the number of subpasses in the render pass</usage> 4372 </validity> 4373 </command> 4374 <command queues="transfer,graphics,compute" renderpass="both" cmdbufferlevel="primary"> 4375 <proto><type>void</type> <name>vkCmdExecuteCommands</name></proto> 4376 <param externsync="true"><type>VkCommandBuffer</type> <name>commandBuffer</name></param> 4377 <param><type>uint32_t</type> <name>commandBufferCount</name></param> 4378 <param len="commandBufferCount">const <type>VkCommandBuffer</type>* <name>pCommandBuffers</name></param> 4379 <validity> 4380 <usage>pname:commandBuffer must: have been created with a pname:level value of VK_COMMAND_BUFFER_LEVEL_PRIMARY</usage> 4381 <usage>Any given element of pname:pCommandBuffers must: have been created with a pname:level value of VK_COMMAND_BUFFER_LEVEL_SECONDARY</usage> 4382 <usage>Any given element of pname:pCommandBuffers mustnot: be already pending execution in pname:commandBuffer, or appear twice in pname:pCommandBuffers, unless it was created with the ename:VK_COMMAND_BUFFER_USAGE_SIMULTANEOUS_USE_BIT flag</usage> 4383 <usage>Any given element of pname:pCommandBuffers mustnot: be already pending execution in any other sname:VkCommandBuffer, unless it was created with the ename:VK_COMMAND_BUFFER_USAGE_SIMULTANEOUS_USE_BIT flag</usage> 4384 <usage>Any given element of pname:pCommandBuffers must: be in the executable state</usage> 4385 <usage>If fname:vkCmdExecuteCommands is being called within a render pass instance, that render pass instance must: have been begun with the pname:contents parameter of fname:vkCmdBeginRenderPass set to ename:VK_SUBPASS_CONTENTS_SECONDARY_COMMAND_BUFFERS</usage> 4386 <usage>If fname:vkCmdExecuteCommands is being called within a render pass instance, any given element of pname:pCommandBuffers must: have been recorded with the ename:VK_COMMAND_BUFFER_USAGE_RENDER_PASS_CONTINUE_BIT</usage> 4387 <usage>If fname:vkCmdExecuteCommands is being called within a render pass instance, any given element of pname:pCommandBuffers must: have been recorded with the pname:subpass member of the pname:inheritanceInfo structure set to the index of the subpass which the given command buffer will be executed in</usage> 4388 <usage>If fname:vkCmdExecuteCommands is being called within a render pass instance, any given element of pname:pCommandBuffers must: have been recorded with a render pass that is compatible with the current render pass - see <<renderpass-compatibility>></usage> 4389 <usage>If fname:vkCmdExecuteCommands is being called within a render pass instance, and any given element of pname:pCommandBuffers was recorded with the pname:framebuffer member of the sname:VkCommandBufferInheritanceInfo structure not equal to sname:VK_NULL_HANDLE, that sname:VkFramebuffer must: be compatible with the sname:VkFramebuffer used in the current render pass instance</usage> 4390 <usage>If the <<features-features-inheritedQueries,inherited queries>> feature is not enabled, pname:commandBuffer mustnot: have any queries <<queries-operation-active,active>></usage> 4391 <usage>If pname:commandBuffer has a ename:VK_QUERY_TYPE_OCCLUSION query <<queries-operation-active,active>>, then each element of pname:pCommandBuffers must: have been recorded with sname:VkCommandBufferBeginInfo::pname:occlusionQueryEnable set to ename:VK_TRUE</usage> 4392 <usage>If pname:commandBuffer has a ename:VK_QUERY_TYPE_OCCLUSION query <<queries-operation-active,active>>, then each element of pname:pCommandBuffers must: have been recorded with sname:VkCommandBufferBeginInfo::pname:queryFlags having all bits set that are set for the query</usage> 4393 <usage>If pname:commandBuffer has a ename:VK_QUERY_TYPE_PIPELINE_STATISTICS query <<queries-operation-active,active>>, then each element of pname:pCommandBuffers must: have been recorded with sname:VkCommandBufferBeginInfo::pname:pipelineStatistics having all bits set that are set in the sname:VkQueryPool the query uses</usage> 4394 <usage>Any given element of pname:pCommandBuffers mustnot: begin any query types that are <<queries-operation-active,active>> in pname:commandBuffer</usage> 4395 </validity> 4396 </command> 4397 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 4398 <proto><type>VkResult</type> <name>vkCreateAndroidSurfaceKHR</name></proto> 4399 <param><type>VkInstance</type> <name>instance</name></param> 4400 <param>const <type>VkAndroidSurfaceCreateInfoKHR</type>* <name>pCreateInfo</name></param> 4401 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 4402 <param><type>VkSurfaceKHR</type>* <name>pSurface</name></param> 4403 </command> 4404 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 4405 <proto><type>VkResult</type> <name>vkGetPhysicalDeviceDisplayPropertiesKHR</name></proto> 4406 <param><type>VkPhysicalDevice</type> <name>physicalDevice</name></param> 4407 <param optional="false,true"><type>uint32_t</type>* <name>pPropertyCount</name></param> 4408 <param optional="true" len="pPropertyCount"><type>VkDisplayPropertiesKHR</type>* <name>pProperties</name></param> 4409 </command> 4410 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 4411 <proto><type>VkResult</type> <name>vkGetPhysicalDeviceDisplayPlanePropertiesKHR</name></proto> 4412 <param><type>VkPhysicalDevice</type> <name>physicalDevice</name></param> 4413 <param optional="false,true"><type>uint32_t</type>* <name>pPropertyCount</name></param> 4414 <param optional="true" len="pPropertyCount"><type>VkDisplayPlanePropertiesKHR</type>* <name>pProperties</name></param> 4415 </command> 4416 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 4417 <proto><type>VkResult</type> <name>vkGetDisplayPlaneSupportedDisplaysKHR</name></proto> 4418 <param><type>VkPhysicalDevice</type> <name>physicalDevice</name></param> 4419 <param><type>uint32_t</type> <name>planeIndex</name></param> 4420 <param optional="false,true"><type>uint32_t</type>* <name>pDisplayCount</name></param> 4421 <param optional="true" len="pDisplayCount"><type>VkDisplayKHR</type>* <name>pDisplays</name></param> 4422 <validity> 4423 <usage>pname:planeIndex must: be less than the number of display planes supported by the device as determined by calling fname:vkGetPhysicalDeviceDisplayPlanePropertiesKHR</usage> 4424 </validity> 4425 </command> 4426 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 4427 <proto><type>VkResult</type> <name>vkGetDisplayModePropertiesKHR</name></proto> 4428 <param><type>VkPhysicalDevice</type> <name>physicalDevice</name></param> 4429 <param><type>VkDisplayKHR</type> <name>display</name></param> 4430 <param optional="false,true"><type>uint32_t</type>* <name>pPropertyCount</name></param> 4431 <param optional="true" len="pPropertyCount"><type>VkDisplayModePropertiesKHR</type>* <name>pProperties</name></param> 4432 </command> 4433 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 4434 <proto><type>VkResult</type> <name>vkCreateDisplayModeKHR</name></proto> 4435 <param><type>VkPhysicalDevice</type> <name>physicalDevice</name></param> 4436 <param externsync="true"><type>VkDisplayKHR</type> <name>display</name></param> 4437 <param>const <type>VkDisplayModeCreateInfoKHR</type>*<name>pCreateInfo</name></param> 4438 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 4439 <param><type>VkDisplayModeKHR</type>* <name>pMode</name></param> 4440 </command> 4441 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 4442 <proto><type>VkResult</type> <name>vkGetDisplayPlaneCapabilitiesKHR</name></proto> 4443 <param><type>VkPhysicalDevice</type> <name>physicalDevice</name></param> 4444 <param externsync="true"><type>VkDisplayModeKHR</type> <name>mode</name></param> 4445 <param><type>uint32_t</type> <name>planeIndex</name></param> 4446 <param><type>VkDisplayPlaneCapabilitiesKHR</type>* <name>pCapabilities</name></param> 4447 </command> 4448 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 4449 <proto><type>VkResult</type> <name>vkCreateDisplayPlaneSurfaceKHR</name></proto> 4450 <param><type>VkInstance</type> <name>instance</name></param> 4451 <param>const <type>VkDisplaySurfaceCreateInfoKHR</type>* <name>pCreateInfo</name></param> 4452 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 4453 <param><type>VkSurfaceKHR</type>* <name>pSurface</name></param> 4454 </command> 4455 <command> 4456 <proto><type>VkResult</type> <name>vkCreateSharedSwapchainsKHR</name></proto> 4457 <param><type>VkDevice</type> <name>device</name></param> 4458 <param><type>uint32_t</type> <name>swapchainCount</name></param> 4459 <param len="swapchainCount">const <type>VkSwapchainCreateInfoKHR</type>* <name>pCreateInfos</name></param> 4460 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 4461 <param len="swapchainCount"><type>VkSwapchainKHR</type>* <name>pSwapchains</name></param> 4462 </command> 4463 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 4464 <proto><type>VkResult</type> <name>vkCreateMirSurfaceKHR</name></proto> 4465 <param><type>VkInstance</type> <name>instance</name></param> 4466 <param>const <type>VkMirSurfaceCreateInfoKHR</type>* <name>pCreateInfo</name></param> 4467 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 4468 <param><type>VkSurfaceKHR</type>* <name>pSurface</name></param> 4469 </command> 4470 <command> 4471 <proto><type>VkBool32</type> <name>vkGetPhysicalDeviceMirPresentationSupportKHR</name></proto> 4472 <param><type>VkPhysicalDevice</type> <name>physicalDevice</name></param> 4473 <param><type>uint32_t</type> <name>queueFamilyIndex</name></param> 4474 <param><type>MirConnection</type>* <name>connection</name></param> 4475 <validity> 4476 <usage>pname:queueFamilyIndex must: be less than the value of pname:pQueueFamilyPropertyCount returned by fname:vkGetPhysicalDeviceQueueFamilyProperties for the given pname:physicalDevice</usage> 4477 </validity> 4478 </command> 4479 <command> 4480 <proto>void <name>vkDestroySurfaceKHR</name></proto> 4481 <param><type>VkInstance</type> <name>instance</name></param> 4482 <param optional="true" externsync="true"><type>VkSurfaceKHR</type> <name>surface</name></param> 4483 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 4484 <validity> 4485 <usage>All sname:VkSwapchainKHR objects created for pname:surface must: have been destroyed prior to destroying pname:surface</usage> 4486 <usage>If sname:VkAllocationCallbacks were provided when pname:surface was created, a compatible set of callbacks must: be provided here</usage> 4487 <usage>If no sname:VkAllocationCallbacks were provided when pname:surface was created, pname:pAllocator must: be `NULL`</usage> 4488 </validity> 4489 </command> 4490 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 4491 <proto><type>VkResult</type> <name>vkGetPhysicalDeviceSurfaceSupportKHR</name></proto> 4492 <param><type>VkPhysicalDevice</type> <name>physicalDevice</name></param> 4493 <param><type>uint32_t</type> <name>queueFamilyIndex</name></param> 4494 <param><type>VkSurfaceKHR</type> <name>surface</name></param> 4495 <param><type>VkBool32</type>* <name>pSupported</name></param> 4496 <validity> 4497 <usage>pname:queueFamilyIndex must: be less than the value of pname:pQueueFamilyPropertyCount returned by fname:vkGetPhysicalDeviceQueueFamilyProperties for the given pname:physicalDevice</usage> 4498 </validity> 4499 </command> 4500 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 4501 <proto><type>VkResult</type> <name>vkGetPhysicalDeviceSurfaceCapabilitiesKHR</name></proto> 4502 <param><type>VkPhysicalDevice</type> <name>physicalDevice</name></param> 4503 <param><type>VkSurfaceKHR</type> <name>surface</name></param> 4504 <param><type>VkSurfaceCapabilitiesKHR</type>* <name>pSurfaceCapabilities</name></param> 4505 </command> 4506 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 4507 <proto><type>VkResult</type> <name>vkGetPhysicalDeviceSurfaceFormatsKHR</name></proto> 4508 <param><type>VkPhysicalDevice</type> <name>physicalDevice</name></param> 4509 <param><type>VkSurfaceKHR</type> <name>surface</name></param> 4510 <param optional="false,true"><type>uint32_t</type>* <name>pSurfaceFormatCount</name></param> 4511 <param optional="true" len="pSurfaceFormatCount"><type>VkSurfaceFormatKHR</type>* <name>pSurfaceFormats</name></param> 4512 </command> 4513 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 4514 <proto><type>VkResult</type> <name>vkGetPhysicalDeviceSurfacePresentModesKHR</name></proto> 4515 <param><type>VkPhysicalDevice</type> <name>physicalDevice</name></param> 4516 <param><type>VkSurfaceKHR</type> <name>surface</name></param> 4517 <param optional="false,true"><type>uint32_t</type>* <name>pPresentModeCount</name></param> 4518 <param optional="true" len="pPresentModeCount"><type>VkPresentModeKHR</type>* <name>pPresentModes</name></param> 4519 </command> 4520 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 4521 <proto><type>VkResult</type> <name>vkCreateSwapchainKHR</name></proto> 4522 <param><type>VkDevice</type> <name>device</name></param> 4523 <param>const <type>VkSwapchainCreateInfoKHR</type>* <name>pCreateInfo</name></param> 4524 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 4525 <param><type>VkSwapchainKHR</type>* <name>pSwapchain</name></param> 4526 </command> 4527 <command> 4528 <proto>void <name>vkDestroySwapchainKHR</name></proto> 4529 <param><type>VkDevice</type> <name>device</name></param> 4530 <param optional="true" externsync="true"><type>VkSwapchainKHR</type> <name>swapchain</name></param> 4531 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 4532 <validity> 4533 <usage>All uses of presentable images acquired from pname:swapchain and owned by the application must: have completed execution</usage> 4534 <usage>If sname:VkAllocationCallbacks were provided when pname:swapchain was created, a compatible set of callbacks must: be provided here</usage> 4535 <usage>If no sname:VkAllocationCallbacks were provided when pname:swapchain was created, pname:pAllocator must: be `NULL`</usage> 4536 </validity> 4537 </command> 4538 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 4539 <proto><type>VkResult</type> <name>vkGetSwapchainImagesKHR</name></proto> 4540 <param><type>VkDevice</type> <name>device</name></param> 4541 <param><type>VkSwapchainKHR</type> <name>swapchain</name></param> 4542 <param optional="false,true"><type>uint32_t</type>* <name>pSwapchainImageCount</name></param> 4543 <param optional="true" len="pSwapchainImageCount"><type>VkImage</type>* <name>pSwapchainImages</name></param> 4544 </command> 4545 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 4546 <proto><type>VkResult</type> <name>vkAcquireNextImageKHR</name></proto> 4547 <param><type>VkDevice</type> <name>device</name></param> 4548 <param externsync="true"><type>VkSwapchainKHR</type> <name>swapchain</name></param> 4549 <param><type>uint64_t</type> <name>timeout</name></param> 4550 <param optional="true"><type>VkSemaphore</type> <name>semaphore</name></param> 4551 <param optional="true"><type>VkFence</type> <name>fence</name></param> 4552 <param><type>uint32_t</type>* <name>pImageIndex</name></param> 4553 <validity> 4554 <usage>If pname:semaphore is not sname:VK_NULL_HANDLE it must: be unsignalled</usage> 4555 <usage>If pname:fence is not sname:VK_NULL_HANDLE it must: be unsignalled and mustnot: be associated with any other queue command that has not yet completed execution on that queue</usage> 4556 </validity> 4557 </command> 4558 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 4559 <proto><type>VkResult</type> <name>vkQueuePresentKHR</name></proto> 4560 <param externsync="true"><type>VkQueue</type> <name>queue</name></param> 4561 <param>const <type>VkPresentInfoKHR</type>* <name>pPresentInfo</name></param> 4562 <validity> 4563 <usage>Any given element of pname:pSwapchains member of pname:pPresentInfo must: be a swapchain that is created for a surface for which presentation is supported from pname:queue as determined using a call to fname:vkGetPhysicalDeviceSurfaceSupportKHR</usage> 4564 </validity> 4565 </command> 4566 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 4567 <proto><type>VkResult</type> <name>vkCreateWaylandSurfaceKHR</name></proto> 4568 <param><type>VkInstance</type> <name>instance</name></param> 4569 <param>const <type>VkWaylandSurfaceCreateInfoKHR</type>* <name>pCreateInfo</name></param> 4570 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 4571 <param><type>VkSurfaceKHR</type>* <name>pSurface</name></param> 4572 </command> 4573 <command> 4574 <proto><type>VkBool32</type> <name>vkGetPhysicalDeviceWaylandPresentationSupportKHR</name></proto> 4575 <param><type>VkPhysicalDevice</type> <name>physicalDevice</name></param> 4576 <param><type>uint32_t</type> <name>queueFamilyIndex</name></param> 4577 <param>struct <type>wl_display</type>* <name>display</name></param> 4578 <validity> 4579 <usage>pname:queueFamilyIndex must: be less than the value of pname:pQueueFamilyPropertyCount returned by fname:vkGetPhysicalDeviceQueueFamilyProperties for the given pname:physicalDevice</usage> 4580 </validity> 4581 </command> 4582 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 4583 <proto><type>VkResult</type> <name>vkCreateWin32SurfaceKHR</name></proto> 4584 <param><type>VkInstance</type> <name>instance</name></param> 4585 <param>const <type>VkWin32SurfaceCreateInfoKHR</type>* <name>pCreateInfo</name></param> 4586 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 4587 <param><type>VkSurfaceKHR</type>* <name>pSurface</name></param> 4588 </command> 4589 <command> 4590 <proto><type>VkBool32</type> <name>vkGetPhysicalDeviceWin32PresentationSupportKHR</name></proto> 4591 <param><type>VkPhysicalDevice</type> <name>physicalDevice</name></param> 4592 <param><type>uint32_t</type> <name>queueFamilyIndex</name></param> 4593 <validity> 4594 <usage>pname:queueFamilyIndex must: be less than the value of pname:pQueueFamilyPropertyCount returned by fname:vkGetPhysicalDeviceQueueFamilyProperties for the given pname:physicalDevice</usage> 4595 </validity> 4596 </command> 4597 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 4598 <proto><type>VkResult</type> <name>vkCreateXlibSurfaceKHR</name></proto> 4599 <param><type>VkInstance</type> <name>instance</name></param> 4600 <param>const <type>VkXlibSurfaceCreateInfoKHR</type>* <name>pCreateInfo</name></param> 4601 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 4602 <param><type>VkSurfaceKHR</type>* <name>pSurface</name></param> 4603 </command> 4604 <command> 4605 <proto><type>VkBool32</type> <name>vkGetPhysicalDeviceXlibPresentationSupportKHR</name></proto> 4606 <param><type>VkPhysicalDevice</type> <name>physicalDevice</name></param> 4607 <param><type>uint32_t</type> <name>queueFamilyIndex</name></param> 4608 <param><type>Display</type>* <name>dpy</name></param> 4609 <param><type>VisualID</type> <name>visualID</name></param> 4610 <validity> 4611 <usage>pname:queueFamilyIndex must: be less than the value of pname:pQueueFamilyPropertyCount returned by fname:vkGetPhysicalDeviceQueueFamilyProperties for the given pname:physicalDevice</usage> 4612 </validity> 4613 </command> 4614 <command successcodes="VK_SUCCESS" errorcodes="VK_ERROR_OUT_OF_HOST_MEMORY,VK_ERROR_OUT_OF_DEVICE_MEMORY"> 4615 <proto><type>VkResult</type> <name>vkCreateXcbSurfaceKHR</name></proto> 4616 <param><type>VkInstance</type> <name>instance</name></param> 4617 <param>const <type>VkXcbSurfaceCreateInfoKHR</type>* <name>pCreateInfo</name></param> 4618 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 4619 <param><type>VkSurfaceKHR</type>* <name>pSurface</name></param> 4620 </command> 4621 <command> 4622 <proto><type>VkBool32</type> <name>vkGetPhysicalDeviceXcbPresentationSupportKHR</name></proto> 4623 <param><type>VkPhysicalDevice</type> <name>physicalDevice</name></param> 4624 <param><type>uint32_t</type> <name>queueFamilyIndex</name></param> 4625 <param><type>xcb_connection_t</type>* <name>connection</name></param> 4626 <param><type>xcb_visualid_t</type> <name>visual_id</name></param> 4627 <validity> 4628 <usage>pname:queueFamilyIndex must: be less than the value of pname:pQueueFamilyPropertyCount returned by fname:vkGetPhysicalDeviceQueueFamilyProperties for the given pname:physicalDevice</usage> 4629 </validity> 4630 </command> 4631 <command> 4632 <proto><type>VkResult</type> <name>vkCreateDebugReportCallbackEXT</name></proto> 4633 <param><type>VkInstance</type> <name>instance</name></param> 4634 <param>const <type>VkDebugReportCallbackCreateInfoEXT</type>* <name>pCreateInfo</name></param> 4635 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 4636 <param><type>VkDebugReportCallbackEXT</type>* <name>pCallback</name></param> 4637 </command> 4638 <command> 4639 <proto>void <name>vkDestroyDebugReportCallbackEXT</name></proto> 4640 <param><type>VkInstance</type> <name>instance</name></param> 4641 <param externsync="true"><type>VkDebugReportCallbackEXT</type> <name>callback</name></param> 4642 <param optional="true">const <type>VkAllocationCallbacks</type>* <name>pAllocator</name></param> 4643 <validity> 4644 <usage>If sname:VkAllocationCallbacks were provided when pname:instance was created, a compatible set of callbacks must: be provided here</usage> 4645 <usage>If no sname:VkAllocationCallbacks were provided when pname:instance was created, pname:pAllocator must: be `NULL`</usage> 4646 </validity> 4647 </command> 4648 <command> 4649 <proto>void <name>vkDebugReportMessageEXT</name></proto> 4650 <param><type>VkInstance</type> <name>instance</name></param> 4651 <param><type>VkDebugReportFlagsEXT</type> <name>flags</name></param> 4652 <param><type>VkDebugReportObjectTypeEXT</type> <name>objectType</name></param> 4653 <param><type>uint64_t</type> <name>object</name></param> 4654 <param><type>size_t</type> <name>location</name></param> 4655 <param><type>int32_t</type> <name>messageCode</name></param> 4656 <param>const <type>char</type>* <name>pLayerPrefix</name></param> 4657 <param>const <type>char</type>* <name>pMessage</name></param> 4658 </command> 4659 </commands> 4660 4661 <!-- SECTION: Vulkan API interface definitions --> 4662 <feature api="vulkan" name="VK_VERSION_1_0" number="1.0"> 4663 <require comment="Header boilerplate"> 4664 <type name="vk_platform"/> 4665 </require> 4666 <require comment="API version"> 4667 <type name="VK_API_VERSION"/> 4668 </require> 4669 <require comment="API constants"> 4670 <enum name="VK_LOD_CLAMP_NONE"/> 4671 <enum name="VK_REMAINING_MIP_LEVELS"/> 4672 <enum name="VK_REMAINING_ARRAY_LAYERS"/> 4673 <enum name="VK_WHOLE_SIZE"/> 4674 <enum name="VK_ATTACHMENT_UNUSED"/> 4675 <enum name="VK_TRUE"/> 4676 <enum name="VK_FALSE"/> 4677 <type name="VK_NULL_HANDLE"/> 4678 <enum name="VK_QUEUE_FAMILY_IGNORED"/> 4679 <enum name="VK_SUBPASS_EXTERNAL"/> 4680 <type name="VkPipelineCacheHeaderVersion"/> 4681 </require> 4682 <require comment="Device initialization"> 4683 <command name="vkCreateInstance"/> 4684 <command name="vkDestroyInstance"/> 4685 <command name="vkEnumeratePhysicalDevices"/> 4686 <command name="vkGetPhysicalDeviceFeatures"/> 4687 <command name="vkGetPhysicalDeviceFormatProperties"/> 4688 <command name="vkGetPhysicalDeviceImageFormatProperties"/> 4689 <command name="vkGetPhysicalDeviceProperties"/> 4690 <command name="vkGetPhysicalDeviceQueueFamilyProperties"/> 4691 <command name="vkGetPhysicalDeviceMemoryProperties"/> 4692 <command name="vkGetInstanceProcAddr"/> 4693 <command name="vkGetDeviceProcAddr"/> 4694 </require> 4695 <require comment="Device commands"> 4696 <command name="vkCreateDevice"/> 4697 <command name="vkDestroyDevice"/> 4698 </require> 4699 <require comment="Extension discovery commands"> 4700 <command name="vkEnumerateInstanceExtensionProperties"/> 4701 <command name="vkEnumerateDeviceExtensionProperties"/> 4702 </require> 4703 <require comment="Layer discovery commands"> 4704 <command name="vkEnumerateInstanceLayerProperties"/> 4705 <command name="vkEnumerateDeviceLayerProperties"/> 4706 </require> 4707 <require comment="queue commands"> 4708 <command name="vkGetDeviceQueue"/> 4709 <command name="vkQueueSubmit"/> 4710 <command name="vkQueueWaitIdle"/> 4711 <command name="vkDeviceWaitIdle"/> 4712 </require> 4713 <require comment="Memory commands"> 4714 <command name="vkAllocateMemory"/> 4715 <command name="vkFreeMemory"/> 4716 <command name="vkMapMemory"/> 4717 <command name="vkUnmapMemory"/> 4718 <command name="vkFlushMappedMemoryRanges"/> 4719 <command name="vkInvalidateMappedMemoryRanges"/> 4720 <command name="vkGetDeviceMemoryCommitment"/> 4721 </require> 4722 <require comment="Memory management API commands"> 4723 <command name="vkBindBufferMemory"/> 4724 <command name="vkBindImageMemory"/> 4725 <command name="vkGetBufferMemoryRequirements"/> 4726 <command name="vkGetImageMemoryRequirements"/> 4727 </require> 4728 <require comment="Sparse resource memory management API commands"> 4729 <command name="vkGetImageSparseMemoryRequirements"/> 4730 <command name="vkGetPhysicalDeviceSparseImageFormatProperties"/> 4731 <command name="vkQueueBindSparse"/> 4732 </require> 4733 <require comment="Fence commands"> 4734 <command name="vkCreateFence"/> 4735 <command name="vkDestroyFence"/> 4736 <command name="vkResetFences"/> 4737 <command name="vkGetFenceStatus"/> 4738 <command name="vkWaitForFences"/> 4739 </require> 4740 <require comment="Queue semaphore commands"> 4741 <command name="vkCreateSemaphore"/> 4742 <command name="vkDestroySemaphore"/> 4743 </require> 4744 <require comment="Event commands"> 4745 <command name="vkCreateEvent"/> 4746 <command name="vkDestroyEvent"/> 4747 <command name="vkGetEventStatus"/> 4748 <command name="vkSetEvent"/> 4749 <command name="vkResetEvent"/> 4750 </require> 4751 <require comment="Query commands"> 4752 <command name="vkCreateQueryPool"/> 4753 <command name="vkDestroyQueryPool"/> 4754 <command name="vkGetQueryPoolResults"/> 4755 </require> 4756 <require comment="Buffer commands"> 4757 <command name="vkCreateBuffer"/> 4758 <command name="vkDestroyBuffer"/> 4759 </require> 4760 <require comment="Buffer view commands"> 4761 <command name="vkCreateBufferView"/> 4762 <command name="vkDestroyBufferView"/> 4763 </require> 4764 <require comment="Image commands"> 4765 <command name="vkCreateImage"/> 4766 <command name="vkDestroyImage"/> 4767 <command name="vkGetImageSubresourceLayout"/> 4768 </require> 4769 <require comment="Image view commands"> 4770 <command name="vkCreateImageView"/> 4771 <command name="vkDestroyImageView"/> 4772 </require> 4773 <require comment="Shader commands"> 4774 <command name="vkCreateShaderModule"/> 4775 <command name="vkDestroyShaderModule"/> 4776 </require> 4777 <require comment="Pipeline Cache commands"> 4778 <command name="vkCreatePipelineCache"/> 4779 <command name="vkDestroyPipelineCache"/> 4780 <command name="vkGetPipelineCacheData"/> 4781 <command name="vkMergePipelineCaches"/> 4782 </require> 4783 4784 <require comment="Pipeline commands"> 4785 <command name="vkCreateGraphicsPipelines"/> 4786 <command name="vkCreateComputePipelines"/> 4787 <command name="vkDestroyPipeline"/> 4788 </require> 4789 <require comment="Pipeline layout commands"> 4790 <command name="vkCreatePipelineLayout"/> 4791 <command name="vkDestroyPipelineLayout"/> 4792 </require> 4793 <require comment="Sampler commands"> 4794 <command name="vkCreateSampler"/> 4795 <command name="vkDestroySampler"/> 4796 </require> 4797 <require comment="Descriptor set commands"> 4798 <command name="vkCreateDescriptorSetLayout"/> 4799 <command name="vkDestroyDescriptorSetLayout"/> 4800 <command name="vkCreateDescriptorPool"/> 4801 <command name="vkDestroyDescriptorPool"/> 4802 <command name="vkResetDescriptorPool"/> 4803 <command name="vkAllocateDescriptorSets"/> 4804 <command name="vkFreeDescriptorSets"/> 4805 <command name="vkUpdateDescriptorSets"/> 4806 </require> 4807 <require comment="Pass commands"> 4808 <command name="vkCreateFramebuffer"/> 4809 <command name="vkDestroyFramebuffer"/> 4810 <command name="vkCreateRenderPass"/> 4811 <command name="vkDestroyRenderPass"/> 4812 <command name="vkGetRenderAreaGranularity"/> 4813 </require> 4814 <require comment="Command pool commands"> 4815 <command name="vkCreateCommandPool"/> 4816 <command name="vkDestroyCommandPool"/> 4817 <command name="vkResetCommandPool"/> 4818 </require> 4819 <require comment="Command buffer commands"> 4820 <command name="vkAllocateCommandBuffers"/> 4821 <command name="vkFreeCommandBuffers"/> 4822 <command name="vkBeginCommandBuffer"/> 4823 <command name="vkEndCommandBuffer"/> 4824 <command name="vkResetCommandBuffer"/> 4825 </require> 4826 <require comment="Command buffer building commands"> 4827 <command name="vkCmdBindPipeline"/> 4828 <command name="vkCmdSetViewport"/> 4829 <command name="vkCmdSetScissor"/> 4830 <command name="vkCmdSetLineWidth"/> 4831 <command name="vkCmdSetDepthBias"/> 4832 <command name="vkCmdSetBlendConstants"/> 4833 <command name="vkCmdSetDepthBounds"/> 4834 <command name="vkCmdSetStencilCompareMask"/> 4835 <command name="vkCmdSetStencilWriteMask"/> 4836 <command name="vkCmdSetStencilReference"/> 4837 <command name="vkCmdBindDescriptorSets"/> 4838 <command name="vkCmdBindIndexBuffer"/> 4839 <command name="vkCmdBindVertexBuffers"/> 4840 <command name="vkCmdDraw"/> 4841 <command name="vkCmdDrawIndexed"/> 4842 <command name="vkCmdDrawIndirect"/> 4843 <command name="vkCmdDrawIndexedIndirect"/> 4844 <command name="vkCmdDispatch"/> 4845 <command name="vkCmdDispatchIndirect"/> 4846 <command name="vkCmdCopyBuffer"/> 4847 <command name="vkCmdCopyImage"/> 4848 <command name="vkCmdBlitImage"/> 4849 <command name="vkCmdCopyBufferToImage"/> 4850 <command name="vkCmdCopyImageToBuffer"/> 4851 <command name="vkCmdUpdateBuffer"/> 4852 <command name="vkCmdFillBuffer"/> 4853 <command name="vkCmdClearColorImage"/> 4854 <command name="vkCmdClearDepthStencilImage"/> 4855 <command name="vkCmdClearAttachments"/> 4856 <command name="vkCmdResolveImage"/> 4857 <command name="vkCmdSetEvent"/> 4858 <command name="vkCmdResetEvent"/> 4859 <command name="vkCmdWaitEvents"/> 4860 <command name="vkCmdPipelineBarrier"/> 4861 <command name="vkCmdBeginQuery"/> 4862 <command name="vkCmdEndQuery"/> 4863 <command name="vkCmdResetQueryPool"/> 4864 <command name="vkCmdWriteTimestamp"/> 4865 <command name="vkCmdCopyQueryPoolResults"/> 4866 <command name="vkCmdPushConstants"/> 4867 <command name="vkCmdBeginRenderPass"/> 4868 <command name="vkCmdNextSubpass"/> 4869 <command name="vkCmdEndRenderPass"/> 4870 <command name="vkCmdExecuteCommands"/> 4871 </require> 4872 <require comment="Types not directly used by the API"> 4873 <!-- Include <type name="typename"/> here for e.g. structs that 4874 are not parameter types of commands, but still need to be 4875 defined in the API. 4876 --> 4877 <type name="VkBufferMemoryBarrier"/> 4878 <type name="VkDispatchIndirectCommand"/> 4879 <type name="VkDrawIndexedIndirectCommand"/> 4880 <type name="VkDrawIndirectCommand"/> 4881 <type name="VkImageMemoryBarrier"/> 4882 <type name="VkMemoryBarrier"/> 4883 </require> 4884 </feature> 4885 4886 <!-- SECTION: Vulkan extension interface definitions (none yet) --> 4887 <extensions> 4888 <!-- WSI extensions --> 4889 <extension name="VK_KHR_surface" number="1" supported="vulkan"> 4890 <require> 4891 <enum value="25" name="VK_KHR_SURFACE_SPEC_VERSION"/> 4892 <enum value=""VK_KHR_surface"" name="VK_KHR_SURFACE_EXTENSION_NAME"/> 4893 <enum offset="0" dir="-" extends="VkResult" name="VK_ERROR_SURFACE_LOST_KHR"/> 4894 <enum offset="1" dir="-" extends="VkResult" name="VK_ERROR_NATIVE_WINDOW_IN_USE_KHR"/> 4895 <command name="vkDestroySurfaceKHR"/> 4896 <command name="vkGetPhysicalDeviceSurfaceSupportKHR"/> 4897 <command name="vkGetPhysicalDeviceSurfaceCapabilitiesKHR"/> 4898 <command name="vkGetPhysicalDeviceSurfaceFormatsKHR"/> 4899 <command name="vkGetPhysicalDeviceSurfacePresentModesKHR"/> 4900 </require> 4901 </extension> 4902 <extension name="VK_KHR_swapchain" number="2" supported="vulkan"> 4903 <require> 4904 <enum value="67" name="VK_KHR_SWAPCHAIN_SPEC_VERSION"/> 4905 <enum value=""VK_KHR_swapchain"" name="VK_KHR_SWAPCHAIN_EXTENSION_NAME"/> 4906 <enum offset="0" extends="VkStructureType" name="VK_STRUCTURE_TYPE_SWAPCHAIN_CREATE_INFO_KHR"/> 4907 <enum offset="1" extends="VkStructureType" name="VK_STRUCTURE_TYPE_PRESENT_INFO_KHR"/> 4908 <enum offset="2" extends="VkImageLayout" name="VK_IMAGE_LAYOUT_PRESENT_SRC_KHR"/> 4909 <enum offset="3" extends="VkResult" name="VK_SUBOPTIMAL_KHR"/> 4910 <enum offset="4" dir="-" extends="VkResult" name="VK_ERROR_OUT_OF_DATE_KHR"/> 4911 <command name="vkCreateSwapchainKHR"/> 4912 <command name="vkDestroySwapchainKHR"/> 4913 <command name="vkGetSwapchainImagesKHR"/> 4914 <command name="vkAcquireNextImageKHR"/> 4915 <command name="vkQueuePresentKHR"/> 4916 </require> 4917 </extension> 4918 <extension name="VK_KHR_display" number="3" supported="vulkan"> 4919 <require> 4920 <enum value="21" name="VK_KHR_DISPLAY_SPEC_VERSION"/> 4921 <enum value=""VK_KHR_display"" name="VK_KHR_DISPLAY_EXTENSION_NAME"/> 4922 <enum offset="0" extends="VkStructureType" name="VK_STRUCTURE_TYPE_DISPLAY_MODE_CREATE_INFO_KHR"/> 4923 <enum offset="1" extends="VkStructureType" name="VK_STRUCTURE_TYPE_DISPLAY_SURFACE_CREATE_INFO_KHR"/> 4924 <type name="VkDisplayPlaneAlphaFlagBitsKHR"/> 4925 <type name="VkDisplayPropertiesKHR"/> 4926 <type name="VkDisplayModeParametersKHR"/> 4927 <type name="VkDisplayModePropertiesKHR"/> 4928 <type name="VkDisplayModeCreateInfoKHR"/> 4929 <type name="VkDisplayPlaneCapabilitiesKHR"/> 4930 <type name="VkDisplayPlanePropertiesKHR"/> 4931 <type name="VkDisplaySurfaceCreateInfoKHR"/> 4932 <command name="vkGetPhysicalDeviceDisplayPropertiesKHR"/> 4933 <command name="vkGetPhysicalDeviceDisplayPlanePropertiesKHR"/> 4934 <command name="vkGetDisplayPlaneSupportedDisplaysKHR"/> 4935 <command name="vkGetDisplayModePropertiesKHR"/> 4936 <command name="vkCreateDisplayModeKHR"/> 4937 <command name="vkGetDisplayPlaneCapabilitiesKHR"/> 4938 <command name="vkCreateDisplayPlaneSurfaceKHR"/> 4939 </require> 4940 </extension> 4941 <extension name="VK_KHR_display_swapchain" number="4" supported="vulkan"> 4942 <require> 4943 <enum value="9" name="VK_KHR_DISPLAY_SWAPCHAIN_SPEC_VERSION"/> 4944 <enum value=""VK_KHR_display_swapchain"" name="VK_KHR_DISPLAY_SWAPCHAIN_EXTENSION_NAME"/> 4945 <enum offset="0" extends="VkStructureType" name="VK_STRUCTURE_TYPE_DISPLAY_PRESENT_INFO_KHR"/> 4946 <enum offset="1" dir="-" extends="VkResult" name="VK_ERROR_INCOMPATIBLE_DISPLAY_KHR"/> 4947 <type name="VkDisplayPresentInfoKHR"/> 4948 <command name="vkCreateSharedSwapchainsKHR"/> 4949 </require> 4950 </extension> 4951 <extension name="VK_KHR_xlib_surface" number="5" protect="VK_USE_PLATFORM_XLIB_KHR" supported="vulkan"> 4952 <require> 4953 <enum value="6" name="VK_KHR_XLIB_SURFACE_SPEC_VERSION"/> 4954 <enum value=""VK_KHR_xlib_surface"" name="VK_KHR_XLIB_SURFACE_EXTENSION_NAME"/> 4955 <enum offset="0" extends="VkStructureType" name="VK_STRUCTURE_TYPE_XLIB_SURFACE_CREATE_INFO_KHR"/> 4956 <type name="VkXlibSurfaceCreateFlagsKHR"/> 4957 <type name="VkXlibSurfaceCreateInfoKHR"/> 4958 <command name="vkCreateXlibSurfaceKHR"/> 4959 <command name="vkGetPhysicalDeviceXlibPresentationSupportKHR"/> 4960 </require> 4961 </extension> 4962 <extension name="VK_KHR_xcb_surface" number="6" protect="VK_USE_PLATFORM_XCB_KHR" supported="vulkan"> 4963 <require> 4964 <enum value="6" name="VK_KHR_XCB_SURFACE_SPEC_VERSION"/> 4965 <enum value=""VK_KHR_xcb_surface"" name="VK_KHR_XCB_SURFACE_EXTENSION_NAME"/> 4966 <enum offset="0" extends="VkStructureType" name="VK_STRUCTURE_TYPE_XCB_SURFACE_CREATE_INFO_KHR"/> 4967 <type name="VkXcbSurfaceCreateFlagsKHR"/> 4968 <type name="VkXcbSurfaceCreateInfoKHR"/> 4969 <command name="vkCreateXcbSurfaceKHR"/> 4970 <command name="vkGetPhysicalDeviceXcbPresentationSupportKHR"/> 4971 </require> 4972 </extension> 4973 <extension name="VK_KHR_wayland_surface" number="7" protect="VK_USE_PLATFORM_WAYLAND_KHR" supported="vulkan"> 4974 <require> 4975 <enum value="5" name="VK_KHR_WAYLAND_SURFACE_SPEC_VERSION"/> 4976 <enum value=""VK_KHR_wayland_surface"" name="VK_KHR_WAYLAND_SURFACE_EXTENSION_NAME"/> 4977 <enum offset="0" extends="VkStructureType" name="VK_STRUCTURE_TYPE_WAYLAND_SURFACE_CREATE_INFO_KHR"/> 4978 <type name="VkWaylandSurfaceCreateFlagsKHR"/> 4979 <type name="VkWaylandSurfaceCreateInfoKHR"/> 4980 <command name="vkCreateWaylandSurfaceKHR"/> 4981 <command name="vkGetPhysicalDeviceWaylandPresentationSupportKHR"/> 4982 </require> 4983 </extension> 4984 <extension name="VK_KHR_mir_surface" number="8" protect="VK_USE_PLATFORM_MIR_KHR" supported="vulkan"> 4985 <require> 4986 <enum value="4" name="VK_KHR_MIR_SURFACE_SPEC_VERSION"/> 4987 <enum value=""VK_KHR_mir_surface"" name="VK_KHR_MIR_SURFACE_EXTENSION_NAME"/> 4988 <enum offset="0" extends="VkStructureType" name="VK_STRUCTURE_TYPE_MIR_SURFACE_CREATE_INFO_KHR"/> 4989 <type name="VkMirSurfaceCreateFlagsKHR"/> 4990 <type name="VkMirSurfaceCreateInfoKHR"/> 4991 <command name="vkCreateMirSurfaceKHR"/> 4992 <command name="vkGetPhysicalDeviceMirPresentationSupportKHR"/> 4993 </require> 4994 </extension> 4995 <extension name="VK_KHR_android_surface" number="9" protect="VK_USE_PLATFORM_ANDROID_KHR" supported="vulkan"> 4996 <require> 4997 <enum value="6" name="VK_KHR_ANDROID_SURFACE_SPEC_VERSION"/> 4998 <enum value=""VK_KHR_android_surface"" name="VK_KHR_ANDROID_SURFACE_EXTENSION_NAME"/> 4999 <enum offset="0" extends="VkStructureType" name="VK_STRUCTURE_TYPE_ANDROID_SURFACE_CREATE_INFO_KHR"/> 5000 <type name="VkAndroidSurfaceCreateFlagsKHR"/> 5001 <type name="VkAndroidSurfaceCreateInfoKHR"/> 5002 <command name="vkCreateAndroidSurfaceKHR"/> 5003 </require> 5004 </extension> 5005 <extension name="VK_KHR_win32_surface" number="10" protect="VK_USE_PLATFORM_WIN32_KHR" supported="vulkan"> 5006 <require> 5007 <enum value="5" name="VK_KHR_WIN32_SURFACE_SPEC_VERSION"/> 5008 <enum value=""VK_KHR_win32_surface"" name="VK_KHR_WIN32_SURFACE_EXTENSION_NAME"/> 5009 <enum offset="0" extends="VkStructureType" name="VK_STRUCTURE_TYPE_WIN32_SURFACE_CREATE_INFO_KHR"/> 5010 <type name="VkWin32SurfaceCreateFlagsKHR"/> 5011 <type name="VkWin32SurfaceCreateInfoKHR"/> 5012 <command name="vkCreateWin32SurfaceKHR"/> 5013 <command name="vkGetPhysicalDeviceWin32PresentationSupportKHR"/> 5014 </require> 5015 </extension> 5016 <extension name="VK_ANDROID_native_buffer" number="11" supported="disabled"> 5017 <require> 5018 <enum value="4" name="VK_ANDROID_NATIVE_BUFFER_SPEC_VERSION"/> 5019 <enum value="11" name="VK_ANDROID_NATIVE_BUFFER_NUMBER"/> 5020 <enum value=""VK_ANDROID_native_buffer"" name="VK_ANDROID_NATIVE_BUFFER_NAME"/> 5021 </require> 5022 </extension> 5023 <extension name="VK_EXT_debug_report" number="12" author="Google, Inc." contact="Courtney Goeltzenleuchter @courtney" supported="vulkan"> 5024 <require> 5025 <enum value="1" name="VK_EXT_DEBUG_REPORT_SPEC_VERSION"/> 5026 <enum value=""VK_EXT_debug_report"" name="VK_EXT_DEBUG_REPORT_EXTENSION_NAME"/> 5027 <enum offset="0" extends="VkStructureType" name="VK_STRUCTURE_TYPE_DEBUG_REPORT_CREATE_INFO_EXT"/> 5028 <enum offset="1" dir="-" extends="VkResult" name="VK_ERROR_VALIDATION_FAILED_EXT"/> 5029 <type name="VkDebugReportObjectTypeEXT"/> 5030 <type name="VkDebugReportErrorEXT"/> 5031 <command name="vkCreateDebugReportCallbackEXT"/> 5032 <command name="vkDestroyDebugReportCallbackEXT"/> 5033 <command name="vkDebugReportMessageEXT"/> 5034 </require> 5035 </extension> 5036 </extensions> 5037</registry> 5038