// Copyright 2023 The Khronos Group Inc.
//
// SPDX-License-Identifier: CC-BY-4.0

:imageparam: srcImage
:imagesubresource: imageSubresource

// Common Valid Usage

  * If pname:{imageparam} is of type ename:VK_IMAGE_TYPE_1D, then for each element
    of pname:pRegions, pname:imageOffset.y must: be `0` and pname:imageExtent.height must: be `1`
  * For each element of pname:pRegions, pname:imageOffset.z and
    [eq]#(pname:imageExtent.depth {plus} pname:imageOffset.z)# must: both be
    greater than or equal to `0` and less than or equal to the depth of the specified pname:{imagesubresource} of pname:{imageparam}
  * If pname:{imageparam} is of type ename:VK_IMAGE_TYPE_1D or ename:VK_IMAGE_TYPE_2D, then for each element of pname:pRegions, pname:imageOffset.z must: be `0` and pname:imageExtent.depth must: be `1`
  * For each element of pname:pRegions, pname:bufferRowLength must: be a
    multiple of the <<formats-compatibility-classes,texel block extent width>> of the elink:VkFormat of pname:{imageparam}
  * For each element of pname:pRegions, pname:bufferImageHeight must: be a
    multiple of the <<formats-compatibility-classes,texel block extent height>> of the elink:VkFormat of pname:{imageparam}
  * For each element of pname:pRegions, pname:imageOffset.x must: be a
    multiple of the <<formats-compatibility-classes,texel block extent width>> of the elink:VkFormat of pname:{imageparam}
  * For each element of pname:pRegions, pname:imageOffset.y must: be a
    multiple of the <<formats-compatibility-classes,texel block extent height>> of the elink:VkFormat of pname:{imageparam}
  * For each element of pname:pRegions, pname:imageOffset.z must: be a
    multiple of the <<formats-compatibility-classes,texel block extent depth>> of the elink:VkFormat of pname:{imageparam}
  * For each element of pname:pRegions, if the sum of pname:imageOffset.x
    and pname:extent.width does not equal the width of the subresource specified by pname:srcSubresource, pname:extent.width must: be a multiple of the <<formats-compatibility-classes,texel block extent width>> of the elink:VkFormat of pname:{imageparam}
  * For each element of pname:pRegions, if the sum of pname:imageOffset.y
    and pname:extent.height does not equal the height of the subresource specified by pname:srcSubresource, pname:extent.height must: be a multiple of the <<formats-compatibility-classes,texel block extent
    height>> of the elink:VkFormat of pname:{imageparam}
  * For each element of pname:pRegions, if the sum of pname:imageOffset.z
    and pname:extent.depth does not equal the depth of the subresource specified by pname:srcSubresource, pname:extent.depth must: be a
    multiple of the <<formats-compatibility-classes,texel block extent
    depth>> of the elink:VkFormat of pname:{imageparam}
  * For each element of pname:pRegions, pname:{imagesubresource}.aspectMask must: specify aspects present in pname:{imageparam}
ifdef::VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion[]
  * If pname:{imageparam} has a elink:VkFormat with <<formats-requiring-sampler-ycbcr-conversion,two planes>> then for each
    element of pname:pRegions, pname:{imagesubresource}.aspectMask must: be
    ename:VK_IMAGE_ASPECT_PLANE_0_BIT or ename:VK_IMAGE_ASPECT_PLANE_1_BIT
  * If pname:{imageparam} has a elink:VkFormat with
    <<formats-requiring-sampler-ycbcr-conversion,three planes>> then for
    each element of pname:pRegions, pname:{imagesubresource}.aspectMask must: be ename:VK_IMAGE_ASPECT_PLANE_0_BIT, ename:VK_IMAGE_ASPECT_PLANE_1_BIT, or ename:VK_IMAGE_ASPECT_PLANE_2_BIT
endif::VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion[]
  * If pname:{imageparam} is of type ename:VK_IMAGE_TYPE_3D, for each element of
    pname:pRegions, pname:{imagesubresource}.baseArrayLayer must: be `0` and pname:{imagesubresource}.layerCount must: be `1`
  * For each element of pname:pRegions, pname:bufferRowLength divided by the <<formats-compatibility-classes,texel block extent width>> and then multiplied by the texel block size of pname:{imageparam} must: be less than or equal to [eq]#2^31^-1#
// Common Valid Usage