VkRenderPassTileShadingCreateInfoQCOM(3)

# VkRenderPassTileShadingCreateInfoQCOM(3) Manual Page

## Name

VkRenderPassTileShadingCreateInfoQCOM - Structure specifying, tile shading information for a render pass object.

## 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

- `sType` is a VkStructureType value identifying this structure

- `pNext` is `NULL` 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.

## 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

Structure Chaining

Extends the structures

  - VkCommandBufferInheritanceInfo

  - VkRenderPassCreateInfo

  - VkRenderPassCreateInfo2

  - VkRenderingInfo

## See Also

VK_QCOM_tile_shading, VkExtent2D, VkStructureType, VkTileShadingRenderPassFlagsQCOM

## 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

Copyright 2014-2026 The Khronos Group Inc.

SPDX-License-Identifier: CC-BY-4.0