// WARNING: DO NOT MODIFY! This file is automatically generated from the vk.xml registry ifndef::doctype-manpage[] .Valid Usage ******************************************************************************** endif::doctype-manpage[] ifdef::doctype-manpage[] Valid Usage ----------- endif::doctype-manpage[] * pname:commandBuffer must: be a valid sname:VkCommandBuffer handle * pname:image must: be a valid sname:VkImage handle * pname:imageLayout must: be a valid elink:VkImageLayout value * pname:pDepthStencil must: be a pointer to a valid sname:VkClearDepthStencilValue structure * pname:pRanges must: be a pointer to an array of pname:rangeCount valid sname:VkImageSubresourceRange structures * pname:commandBuffer must: be in the recording state * The sname:VkCommandPool that pname:commandBuffer was allocated from must: support graphics operations * This command must: only be called outside of a render pass instance * pname:rangeCount must: be greater than `0` * Each of pname:commandBuffer and pname:image must: have been created, allocated or retrieved from the same sname:VkDevice * pname:image must: have been created with ename:VK_IMAGE_USAGE_TRANSFER_DST_BIT usage flag * pname:imageLayout must: specify the layout of the image subresource ranges of pname:image specified in pname:pRanges at the time this command is executed on a sname:VkDevice * pname:imageLayout must: be either of ename:VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL or ename:VK_IMAGE_LAYOUT_GENERAL * The image range of any given element of pname:pRanges must: be an image subresource range that is contained within pname:image * pname:image must: have a depth/stencil format ifndef::doctype-manpage[] ******************************************************************************** endif::doctype-manpage[] ifndef::doctype-manpage[] .Host Synchronization ******************************************************************************** endif::doctype-manpage[] ifdef::doctype-manpage[] Host Synchronization -------------------- endif::doctype-manpage[] * Host access to pname:commandBuffer must: be externally synchronized ifndef::doctype-manpage[] ******************************************************************************** endif::doctype-manpage[] ifndef::doctype-manpage[] .Command Properties ******************************************************************************** endif::doctype-manpage[] ifdef::doctype-manpage[] Command Properties ------------------ endif::doctype-manpage[] [options="header", width="100%"] |===================== |Command Buffer Levels|Render Pass Scope|Supported Queue Types |Primary + Secondary|Outside|GRAPHICS |===================== ifndef::doctype-manpage[] ******************************************************************************** endif::doctype-manpage[]