VkRenderPassTileShadingCreateInfoQCOM
To enable tile shading for a render pass object, add a
VkRenderPassTileShadingCreateInfoQCOM to the pNext
chain of
VkRenderPassCreateInfo
.
To enable tile shading for a dynamic render pass, add a
VkRenderPassTileShadingCreateInfoQCOM to the pNext
chain of
VkRenderingInfo.
To execute a secondary command buffer within a render pass, add a
VkRenderPassTileShadingCreateInfoQCOM to the pNext
chain of
VkCommandBufferInheritanceInfo when the secondary command buffer is
recorded.
The VkRenderPassTileShadingCreateInfoQCOM
structure is defined as:
typedef struct VkRenderPassTileShadingCreateInfoQCOM {
VkStructureType sType;
const void* pNext;
VkTileShadingRenderPassFlagsQCOM flags;
VkExtent2D tileApronSize;
} VkRenderPassTileShadingCreateInfoQCOM;
sType
is a VkStructureType value identifying this structurepNext
isNULL
or a pointer to a structure extending this structure.flags
is a bitmask of VkTileShadingRenderPassFlagBitsQCOM.tileApronSize
is a VkExtent2D describing the is size of the tiling apron in each dimension.
If this structure is not present, the render pass will have flags
set
to 0
and tileApronSize
is set to (0,0)
.
Valid Usage
VUID-VkRenderPassTileShadingCreateInfoQCOM-tileShading-10658
If the tileShading
feature is not
enabled, VK_TILE_SHADING_RENDER_PASS_ENABLE_BIT_QCOM
must not be
included in flags
VUID-VkRenderPassTileShadingCreateInfoQCOM-flags-10659
If VK_TILE_SHADING_RENDER_PASS_ENABLE_BIT_QCOM
is not included in
flags
or the tileShadingApron
feature is not enabled, tileApronSize
must be (0,0)
VUID-VkRenderPassTileShadingCreateInfoQCOM-flags-10660
If VK_TILE_SHADING_RENDER_PASS_ENABLE_BIT_QCOM
is not included in
flags
, or neither the
tileShadingPerTileDispatch and
tileShadingPerTileDraw features are
enabled, flags
must not include
VK_TILE_SHADING_RENDER_PASS_PER_TILE_EXECUTION_BIT_QCOM
VUID-VkRenderPassTileShadingCreateInfoQCOM-tileShadingAnisotropicApron-10661
If the tileShadingAnisotropicApron
feature is not enabled,
tileApronSize.x
and must be equal to tileApronSize.y
VUID-VkRenderPassTileShadingCreateInfoQCOM-tileApronSize-10662
tileApronSize.x
must be less than or equal to
maxApronSize
VUID-VkRenderPassTileShadingCreateInfoQCOM-tileApronSize-10663
tileApronSize.y
must be less than or equal to
maxApronSize
Valid Usage (Implicit)
VUID-VkRenderPassTileShadingCreateInfoQCOM-sType-sType
sType
must be VK_STRUCTURE_TYPE_RENDER_PASS_TILE_SHADING_CREATE_INFO_QCOM
VUID-VkRenderPassTileShadingCreateInfoQCOM-flags-parameter
flags
must be a valid combination of VkTileShadingRenderPassFlagBitsQCOM values