HORIZON HASKELLDocslts/ghc-10.0.x8174fa42026-10-11Search names, modules, packages, or :: a typeCtrl K

GHC 10.0.0.20260917 · lts/ghc-10.0.x · 8174fa4 · 2026-10-11

Modulevulkan-3.27GHC2021

Vulkan.Extensions.VK_QCOM_tile_properties

Name

VK_QCOM_tile_properties - device extension

VK_QCOM_tile_properties

Name String

VK_QCOM_tile_properties

Extension Type

Device extension

Registered Extension Number

485

Revision

1

Ratification Status

Not ratified

Extension and Version Dependencies

VK_KHR_get_physical_device_properties2

or

Vulkan Version 1.1

API Interactions

  • Interacts with VK_VERSION_1_3

  • Interacts with VK_KHR_dynamic_rendering

Contact
Extension Proposal

VK_QCOM_tile_properties

Other Extension Metadata

Last Modified Date

2022-07-11

Interactions and External Dependencies

  • This extension interacts with VK_EXT_subpass_merge_feedback

Contributors

  • Jonathan Wicks, Qualcomm Technologies, Inc.

  • Jonathan Tinkham, Qualcomm Technologies, Inc.

  • Arpit Agarwal, Qualcomm Technologies, Inc.

  • Jeff Leger, Qualcomm Technologies, Inc.

Description

This extension allows an application to query the tile properties. This extension supports both renderpasses and dynamic rendering.

New Commands

New Structures

If VK_KHR_dynamic_rendering or Vulkan Version 1.3 is supported:

New Enum Constants

Version History

  • Revision 1, 2022-07-11 (Arpit Agarwal)

    • Initial version

See Also

No cross-references are available

Document Notes

For more information, see the Vulkan Specification.

This page is a generated document. Fixes and changes should be made to the generator scripts, not directly.

  • 5 types
  • 2 values
  • Packagevulkan-3.27
  • Exports9
  • LanguageGHC2021
  • LicenceBSD-3-Clause
  • SourceVK_QCOM_tile_properties.hs
valuegetFramebufferTilePropertiesQCOM
  1. :: MonadIO io
  2. => Device

    device is a logical device associated with the framebuffer.

  3. -> Framebuffer

    framebuffer is a handle of the framebuffer to query.

  4. -> io (Result, "properties" ::: Vector TilePropertiesQCOM)
#

vkGetFramebufferTilePropertiesQCOM - Get tile properties from the attachments in framebuffer

Description

If pProperties is NULL, then the number of tile properties available is returned in pPropertiesCount. Otherwise, pPropertiesCount must point to a variable set by the application to the number of elements in the pProperties array, and on return the variable is overwritten with the number of properties actually written to pProperties. If pPropertiesCount is less than the number of tile properties available, at most pPropertiesCount structures will be written, and INCOMPLETE will be returned instead of SUCCESS, to indicate that not all the available properties were returned.

The number of tile properties available is determined by the number of merged subpasses, and each tile property is associated with a merged subpass. There will be at most as many properties as there are subpasses within the render pass. To obtain the tile properties for a given merged subpass, the pProperties array can be indexed using the postMergeIndex value provided in RenderPassSubpassFeedbackInfoEXT.

Valid Usage (Implicit)

  • device must be a valid Device handle

  • framebuffer must be a valid Framebuffer handle

  • pPropertiesCount must be a valid pointer to a uint32_t value

  • If the value referenced by pPropertiesCount is not 0, and pProperties is not NULL, pProperties must be a valid pointer to an array of pPropertiesCount TilePropertiesQCOM structures

  • framebuffer must have been created, allocated, or retrieved from device

Return Codes

Success
Failure

See Also

VK_QCOM_tile_properties, Device, Framebuffer, TilePropertiesQCOM

valuegetDynamicRenderingTilePropertiesQCOM
  1. :: (Extendss RenderingInfo a, PokeChain a, MonadIO io)
  2. => Device

    device is a logical device associated with the render pass.

    device must be a valid Device handle

  3. -> RenderingInfo a

    pRenderingInfo is a pointer to the RenderingInfo structure specifying details of the render pass instance in dynamic rendering.

    pRenderingInfo must be a valid pointer to a valid RenderingInfo structure

  4. -> io TilePropertiesQCOM
#

vkGetDynamicRenderingTilePropertiesQCOM - Get the properties when using dynamic rendering

Return Codes

Success
Failure

See Also

VK_QCOM_tile_properties, Device, RenderingInfo, TilePropertiesQCOM

datadata PhysicalDeviceTilePropertiesFeaturesQCOM
#

VkPhysicalDeviceTilePropertiesFeaturesQCOM - Structure describing tile properties features that can be supported by an implementation

Members

This structure describes the following features:

Description

If the PhysicalDeviceTilePropertiesFeaturesQCOM structure is included in the pNext chain of the PhysicalDeviceFeatures2 structure passed to getPhysicalDeviceFeatures2, it is filled in to indicate whether each corresponding feature is supported. If the application wishes to use a Device with any features described by PhysicalDeviceTilePropertiesFeaturesQCOM, it must add an instance of the structure, with the desired feature members set to TRUE, to the pNext chain of DeviceCreateInfo when creating the Device.

Structure Chaining

Extends the structures

See Also

VK_QCOM_tile_properties, Bool32, StructureType

Constructors

Instances6Eq, Show, Storable, FromCStruct, ToCStruct, Zero
datadata TilePropertiesQCOM
#

VkTilePropertiesQCOM - Structure holding available tile properties

Description

All tiles will be tightly packed around the first tile, with edges being multiples of tile width and/or height from the origin.

The tileSize is guaranteed to be a multiple of tileGranularity.

Valid Usage (Implicit)

See Also

VK_QCOM_tile_properties, Extent2D, Extent3D, Offset2D, StructureType, getDynamicRenderingTilePropertiesQCOM, getFramebufferTilePropertiesQCOM

Constructors

  • TilePropertiesQCOM
    • tileSize :: Extent3D

      tileSize is the dimensions of a tile, with width and height describing the width and height of a tile in pixels, and depth corresponding to the number of slices the tile spans.

    • apronSize :: Extent2D

      apronSize is the dimension of the apron.

    • origin :: Offset2D

      origin is the top-left corner of the first tile in attachment space.

Instances5Show, Storable, FromCStruct, ToCStruct, Zero