== VK_AMD_texture_gather_bias_lod

*Name String*::
    +VK_AMD_texture_gather_bias_lod+
*Extension Type*::
    Device extension
*Registered Extension Number*::
    42
*Last Modified Date*::
    03/21/2017
*Revision*::
    1
*IP Status*::
    No known IP claims.
*Dependencies*::
  - This extension is written against version 1.0 of the Vulkan API.
  - Requires +VK_KHR_get_physical_device_properties2+.
  - Requires the
    https://www.khronos.org/registry/spir-v/extensions/AMD/SPV_AMD_texture_gather_bias_lod.html[+SPV_AMD_texture_gather_bias_lod+]
    SPIR-V extension.
*Contributors*::
  - Dominik Witczak, AMD
  - Daniel Rakos, AMD
  - Graham Sellers, AMD
  - Matthaeus G.
    Chajdas, AMD
  - Qun Lin, AMD
  - Rex Xu, AMD
  - Timothy Lottes, AMD
*Contacts*::
  - Rex Xu, AMD (Rex.Xu@amd.com)

This extension adds two related features.

Firstly, support for the following SPIR-V extension in {apiname} is added:

  * SPV_AMD_texture_gather_bias_lod

Secondly, the extension allows the application to query, which formats can
be used together with the new function prototypes introduced by the SPIR-V
extension.

=== New Object Types

None.

=== New Enum Constants

  * Extending ename:VkStructureType:
  ** ename:VK_STRUCTURE_TYPE_TEXTURE_LOD_GATHER_FORMAT_PROPERTIES_AMD

=== New Enums

None.

=== New SPIR-V Capabilities

* <<spirvenv-capabilities-table-imagegatherbiaslodamd,code:ImageGatherBiasLodAMD>>


=== New Structures

  * slink:VkTextureLODGatherFormatPropertiesAMD

=== New Functions

None.

=== Examples

[source,c++]
--------------------------------------

struct VkTextureLODGatherFormatPropertiesAMD
{
    VkStructureType sType;
    const void*     pNext;
    VkBool32        supportsTextureGatherLODBiasAMD;
};

// ----------------------------------------------------------------------------------------
// How to detect if an image format can be used with the new function prototypes.
VkPhysicalDeviceImageFormatInfo2KHR   formatInfo;
VkImageFormatProperties2KHR           formatProps;
VkTextureLODGatherFormatPropertiesAMD textureLODGatherSupport;

textureLODGatherSupport.sType = VK_STRUCTURE_TYPE_TEXTURE_LOD_GATHER_FORMAT_PROPERTIES_AMD;
textureLODGatherSupport.pNext = nullptr;

formatInfo.sType  = VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_IMAGE_FORMAT_INFO_2_KHR;
formatInfo.pNext  = nullptr;
formatInfo.format = ...;
formatInfo.type   = ...;
formatInfo.tiling = ...;
formatInfo.usage  = ...;
formatInfo.flags  = ...;

formatProps.sType = VK_STRUCTURE_TYPE_IMAGE_FORMAT_PROPERTIES_2_KHR;
formatProps.pNext = &textureLODGatherSupport;

vkGetPhysicalDeviceImageFormatProperties2KHR(physical_device, &formatInfo, &formatProps);

if (textureLODGatherSupport.supportsTextureGatherLODBiasAMD == VK_TRUE)
{
    // physical device supports SPV_AMD_texture_gather_bias_lod for the specified
    // format configuration.
}
else
{
    // physical device does not support SPV_AMD_texture_gather_bias_lod for the
    // specified format configuration.
}
--------------------------------------

=== Version History

 * Revision 1, 2017-03-21 (Dominik Witczak)
   - Initial draft
