VkCopyCommandTransformInfoQCOM
The VkCopyCommandTransformInfoQCOM
structure is defined as:
typedef struct VkCopyCommandTransformInfoQCOM {
VkStructureType sType;
const void* pNext;
VkSurfaceTransformFlagBitsKHR transform;
} VkCopyCommandTransformInfoQCOM;
sType
is a VkStructureType value identifying this structure.pNext
isNULL
or a pointer to a structure extending this structure.transform
is a VkSurfaceTransformFlagBitsKHR value describing the transform to be applied.
Including this structure in the pNext
chain of
VkBufferImageCopy2 defines a rotation to be performed when copying
between an image and a buffer.
Including this structure in the pNext
chain of VkBlitImageInfo2
defines a rotation to be performed when blitting between two images.
If this structure is not specified in either case, the implementation
behaves as if it was specified with a transform
equal to
VK_SURFACE_TRANSFORM_IDENTITY_BIT_KHR
.
Specifying a transform for a copy between an image and a buffer rotates the region accessed in the image around the offset. Specifying a transform for a blit performs a similar transform as described in Image Blits with Scaling and Rotation.
Rotations other than VK_SURFACE_TRANSFORM_IDENTITY_BIT_KHR
can only
be specified for single-plane 2D images with a 1x1x1
texel block extent.
Valid Usage
VUID-VkCopyCommandTransformInfoQCOM-transform-04560
transform
must be VK_SURFACE_TRANSFORM_IDENTITY_BIT_KHR
,
VK_SURFACE_TRANSFORM_ROTATE_90_BIT_KHR
,
VK_SURFACE_TRANSFORM_ROTATE_180_BIT_KHR
, or
VK_SURFACE_TRANSFORM_ROTATE_270_BIT_KHR
Valid Usage (Implicit)
VUID-VkCopyCommandTransformInfoQCOM-sType-sType
sType
must be VK_STRUCTURE_TYPE_COPY_COMMAND_TRANSFORM_INFO_QCOM