VkCommandBufferInheritanceRenderPassTransformInfoQCOM
To begin recording a secondary command buffer compatible with execution
inside a render pass using render
pass transform, add the
VkCommandBufferInheritanceRenderPassTransformInfoQCOM to the
pNext
chain of VkCommandBufferInheritanceInfo structure passed
to the vkBeginCommandBuffer command specifying the parameters for
transformed rasterization.
The VkCommandBufferInheritanceRenderPassTransformInfoQCOM
structure is
defined as:
typedef struct VkCommandBufferInheritanceRenderPassTransformInfoQCOM {
VkStructureType sType;
void* pNext;
VkSurfaceTransformFlagBitsKHR transform;
VkRect2D renderArea;
} VkCommandBufferInheritanceRenderPassTransformInfoQCOM;
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 to the render pass.renderArea
is the render area that is affected by the command buffer.
When the secondary is recorded to execute within a render pass instance
using vkCmdExecuteCommands, the render pass transform parameters of
the secondary command buffer must be consistent with the render pass
transform parameters specified for the render pass instance.
In particular, the transform
and renderArea
for command buffer
must be identical to the transform
and renderArea
of the render
pass instance.
Valid Usage
VUID-VkCommandBufferInheritanceRenderPassTransformInfoQCOM-transform-02864
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-VkCommandBufferInheritanceRenderPassTransformInfoQCOM-sType-sType
sType
must be VK_STRUCTURE_TYPE_COMMAND_BUFFER_INHERITANCE_RENDER_PASS_TRANSFORM_INFO_QCOM