1// Copyright 2020-2023 The Khronos Group Inc.
2//
3// SPDX-License-Identifier: CC-BY-4.0
4
5// Common Valid Usage
6// Common to vkCmdCopyBufferToImage* commands
7  * [[VUID-{refpage}-pRegions-00171]]
8    pname:srcBuffer must: be large enough to contain all buffer locations
9    that are accessed according to <<copies-buffers-images-addressing,Buffer
10    and Image Addressing>>, for each element of pname:pRegions
11  * [[VUID-{refpage}-pRegions-00173]]
12    The union of all source regions, and the union of all destination
13    regions, specified by the elements of pname:pRegions, must: not overlap
14    in memory
15  * [[VUID-{refpage}-srcBuffer-00174]]
16    pname:srcBuffer must: have been created with
17    ename:VK_BUFFER_USAGE_TRANSFER_SRC_BIT usage flag
18ifdef::VK_VERSION_1_1,VK_KHR_maintenance1[]
19  * [[VUID-{refpage}-dstImage-01997]]
20    The <<resources-image-format-features,format features>> of
21    pname:dstImage must: contain ename:VK_FORMAT_FEATURE_TRANSFER_DST_BIT
22endif::VK_VERSION_1_1,VK_KHR_maintenance1[]
23  * [[VUID-{refpage}-srcBuffer-00176]]
24    If pname:srcBuffer is non-sparse then it must: be bound completely and
25    contiguously to a single sname:VkDeviceMemory object
26  * [[VUID-{refpage}-dstImage-00177]]
27    pname:dstImage must: have been created with
28    ename:VK_IMAGE_USAGE_TRANSFER_DST_BIT usage flag
29  * [[VUID-{refpage}-dstImageLayout-00180]]
30    pname:dstImageLayout must: specify the layout of the image subresources
31    of pname:dstImage specified in pname:pRegions at the time this command
32    is executed on a sname:VkDevice
33  * [[VUID-{refpage}-dstImageLayout-01396]]
34    pname:dstImageLayout must: be
35ifdef::VK_KHR_shared_presentable_image[]
36    ename:VK_IMAGE_LAYOUT_SHARED_PRESENT_KHR,
37endif::VK_KHR_shared_presentable_image[]
38    ename:VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL, or
39    ename:VK_IMAGE_LAYOUT_GENERAL
40  * [[VUID-{refpage}-pRegions-07931]]
41ifdef::VK_EXT_depth_range_unrestricted[]
42    If apiext:VK_EXT_depth_range_unrestricted is not enabled, for
43endif::VK_EXT_depth_range_unrestricted[]
44ifndef::VK_EXT_depth_range_unrestricted[For]
45    each element of pname:pRegions whose pname:imageSubresource contains a
46    depth aspect, the data in pname:srcBuffer must: be in the range
47    [eq]#[0,1]#
48// Common Valid Usage
49