vulkan-3.26.1: Bindings to the Vulkan graphics API.
Safe HaskellSafe-Inferred
LanguageHaskell2010

Vulkan.Extensions.VK_QCOM_tile_properties

Description

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
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 is supported:

New Enum Constants

Version History

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

    • Initial version

See Also

PhysicalDeviceTilePropertiesFeaturesQCOM, TilePropertiesQCOM, getDynamicRenderingTilePropertiesQCOM, getFramebufferTilePropertiesQCOM

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.

Synopsis

Documentation

getFramebufferTilePropertiesQCOM Source #

Arguments

:: forall io. MonadIO io 
=> Device

device is a logical device associated with the framebuffer.

-> Framebuffer

framebuffer is a handle of the framebuffer to query.

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

See Also

VK_QCOM_tile_properties, Device, Framebuffer, TilePropertiesQCOM

getDynamicRenderingTilePropertiesQCOM Source #

Arguments

:: forall a io. (Extendss RenderingInfo a, PokeChain a, MonadIO io) 
=> Device

device is a logical device associated with the render pass.

device must be a valid Device handle

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

-> io TilePropertiesQCOM 

vkGetDynamicRenderingTilePropertiesQCOM - Get the properties when using dynamic rendering

Return Codes

Success

See Also

VK_QCOM_tile_properties, Device, RenderingInfo, TilePropertiesQCOM

data PhysicalDeviceTilePropertiesFeaturesQCOM Source #

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. PhysicalDeviceTilePropertiesFeaturesQCOM can also be used in the pNext chain of DeviceCreateInfo to selectively enable these features.

Valid Usage (Implicit)

See Also

VK_QCOM_tile_properties, Bool32, StructureType

Constructors

PhysicalDeviceTilePropertiesFeaturesQCOM 

Fields

  • tileProperties :: Bool

    tileProperties indicates that the implementation supports queries for returning tile properties.

Instances

Instances details
Storable PhysicalDeviceTilePropertiesFeaturesQCOM Source # 
Instance details

Defined in Vulkan.Extensions.VK_QCOM_tile_properties

Show PhysicalDeviceTilePropertiesFeaturesQCOM Source # 
Instance details

Defined in Vulkan.Extensions.VK_QCOM_tile_properties

Eq PhysicalDeviceTilePropertiesFeaturesQCOM Source # 
Instance details

Defined in Vulkan.Extensions.VK_QCOM_tile_properties

FromCStruct PhysicalDeviceTilePropertiesFeaturesQCOM Source # 
Instance details

Defined in Vulkan.Extensions.VK_QCOM_tile_properties

ToCStruct PhysicalDeviceTilePropertiesFeaturesQCOM Source # 
Instance details

Defined in Vulkan.Extensions.VK_QCOM_tile_properties

Zero PhysicalDeviceTilePropertiesFeaturesQCOM Source # 
Instance details

Defined in Vulkan.Extensions.VK_QCOM_tile_properties

data TilePropertiesQCOM Source #

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.

Note

Reported value for apronSize will be zero and its functionality will be described in a future extension.

Valid Usage (Implicit)

See Also

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

Constructors

TilePropertiesQCOM 

Fields

  • 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.

Instances

Instances details
Storable TilePropertiesQCOM Source # 
Instance details

Defined in Vulkan.Extensions.VK_QCOM_tile_properties

Show TilePropertiesQCOM Source # 
Instance details

Defined in Vulkan.Extensions.VK_QCOM_tile_properties

FromCStruct TilePropertiesQCOM Source # 
Instance details

Defined in Vulkan.Extensions.VK_QCOM_tile_properties

ToCStruct TilePropertiesQCOM Source # 
Instance details

Defined in Vulkan.Extensions.VK_QCOM_tile_properties

Zero TilePropertiesQCOM Source # 
Instance details

Defined in Vulkan.Extensions.VK_QCOM_tile_properties

type QCOM_TILE_PROPERTIES_EXTENSION_NAME = "VK_QCOM_tile_properties" Source #

pattern QCOM_TILE_PROPERTIES_EXTENSION_NAME :: forall a. (Eq a, IsString a) => a Source #