C Specification

To enable tile shading for a render pass object, add a VkRenderPassTileShadingCreateInfoQCOM to the pNext chain of VkRenderPassCreateInfo or VkRenderPassCreateInfo2 . 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:

// Provided by VK_QCOM_tile_shading
typedef struct VkRenderPassTileShadingCreateInfoQCOM {
    VkStructureType                     sType;
    const void*                         pNext;
    VkTileShadingRenderPassFlagsQCOM    flags;
    VkExtent2D                          tileApronSize;
} VkRenderPassTileShadingCreateInfoQCOM;

Members

Description

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

See Also

Document Notes

For more information, see the Vulkan Specification

This page is extracted from the Vulkan Specification. Fixes and changes should be made to the Specification, not directly.

Copyright 2014-2025 The Khronos Group Inc.

SPDX-License-Identifier: CC-BY-4.0