VkFormatProperties3(3)

# VkFormatProperties3(3) Manual Page

## Name

VkFormatProperties3 - Structure specifying image format properties

Loading… please wait.

## C Specification

To query supported format extended features which are properties of the physical device, add VkFormatProperties3 structure to the `pNext` chain of VkFormatProperties2.

The VkFormatProperties3 structure is defined as:

    // Provided by VK_VERSION_1_3
    typedef struct VkFormatProperties3 {
        VkStructureType          sType;
        void*                    pNext;
        VkFormatFeatureFlags2    linearTilingFeatures;
        VkFormatFeatureFlags2    optimalTilingFeatures;
        VkFormatFeatureFlags2    bufferFeatures;
    } VkFormatProperties3;

or the equivalent

    // Provided by VK_KHR_format_feature_flags2
    typedef VkFormatProperties3 VkFormatProperties3KHR;

## Members

- `linearTilingFeatures` is a bitmask of VkFormatFeatureFlagBits2 specifying features supported by images created with a `tiling` parameter of `VK_IMAGE_TILING_LINEAR`.

- `optimalTilingFeatures` is a bitmask of VkFormatFeatureFlagBits2 specifying features supported by images created with a `tiling` parameter of `VK_IMAGE_TILING_OPTIMAL`.

- `bufferFeatures` is a bitmask of VkFormatFeatureFlagBits2 specifying features supported by buffers.

## Description

The bits reported in `linearTilingFeatures`, `optimalTilingFeatures` and `bufferFeatures` must include the bits reported in the corresponding fields of `VkFormatProperties2`::`formatProperties`.

Valid Usage (Implicit)

- VUID-VkFormatProperties3-sType-sType
  `sType` must be `VK_STRUCTURE_TYPE_FORMAT_PROPERTIES_3`

## See Also

VK_KHR_format_feature_flags2, VK_VERSION_1_3, VkFormatFeatureFlags2, VkStructureType

## 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-2024 The Khronos Group Inc.

SPDX-License-Identifier: CC-BY-4.0