Safe Haskell	None
Language	Haskell2010

Vulkan.Extensions.VK_EXT_texture_compression_astc_hdr

Description

Name

VK_EXT_texture_compression_astc_hdr - device extension

VK_EXT_texture_compression_astc_hdr

Name String: VK_EXT_texture_compression_astc_hdr

Extension Type

Device extension

Registered Extension Number

67

Revision

1

Extension and Version Dependencies

Requires Vulkan 1.0
Requires VK_KHR_get_physical_device_properties2

Contact

Jan-Harald Fredriksen https://github.com/KhronosGroup/Vulkan-Docs/issues/new?title=VK_EXT_texture_compression_astc_hdr:%20&body=@janharaldfredriksen-arm%20

Other Extension Metadata

Last Modified Date: 2019-05-28

IP Status

No known issues.

Contributors

Jan-Harald Fredriksen, Arm

Description

This extension adds support for textures compressed using the Adaptive Scalable Texture Compression (ASTC) High Dynamic Range (HDR) profile.

When this extension is enabled, the HDR profile is supported for all ASTC formats listed in ASTC Compressed Image Formats.

New Structures

Extending PhysicalDeviceFeatures2, DeviceCreateInfo:
- PhysicalDeviceTextureCompressionASTCHDRFeaturesEXT

New Enum Constants

EXT_TEXTURE_COMPRESSION_ASTC_HDR_EXTENSION_NAME

Issues

1) Should we add a feature or limit for this functionality?

Yes. It is consistent with the ASTC LDR support to add a feature like textureCompressionASTC_HDR.

The feature is strictly speaking redundant as long as this is just an extension; it would be sufficient to just enable the extension. But adding the feature is more forward-looking if wanted to make this an optional core feature in the future.

2) Should we introduce new format enums for HDR?

Yes. Vulkan 1.0 describes the ASTC format enums as UNORM, e.g. FORMAT_ASTC_4x4_UNORM_BLOCK, so it’s confusing to make these contain HDR data. Note that the OpenGL (ES) extensions did not make this distinction because a single ASTC HDR texture may contain both unorm and float blocks. Implementations may not be able to distinguish between LDR and HDR ASTC textures internally and just treat them as the same format, i.e. if this extension is supported then sampling from a FORMAT_ASTC_4x4_UNORM_BLOCK image format may return HDR results. Applications can get predictable results by using the appropriate image format.

Version History

Revision 1, 2019-05-28 (Jan-Harald Fredriksen)
- Initial version

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

data PhysicalDeviceTextureCompressionASTCHDRFeaturesEXT = PhysicalDeviceTextureCompressionASTCHDRFeaturesEXT {
- textureCompressionASTC_HDR :: Bool
}
type EXT_TEXTURE_COMPRESSION_ASTC_HDR_SPEC_VERSION = 1
pattern EXT_TEXTURE_COMPRESSION_ASTC_HDR_SPEC_VERSION :: forall a. Integral a => a
type EXT_TEXTURE_COMPRESSION_ASTC_HDR_EXTENSION_NAME = "VK_EXT_texture_compression_astc_hdr"
pattern EXT_TEXTURE_COMPRESSION_ASTC_HDR_EXTENSION_NAME :: forall a. (Eq a, IsString a) => a

Documentation

data PhysicalDeviceTextureCompressionASTCHDRFeaturesEXT Source #

VkPhysicalDeviceTextureCompressionASTCHDRFeaturesEXT - Structure describing ASTC HDR features that can be supported by an implementation

Members

The members of the PhysicalDeviceTextureCompressionASTCHDRFeaturesEXT structure describe the following features:

Description

If the PhysicalDeviceTextureCompressionASTCHDRFeaturesEXT structure is included in the pNext chain of PhysicalDeviceFeatures2, it is filled with values indicating whether each feature is supported. PhysicalDeviceTextureCompressionASTCHDRFeaturesEXT can also be included in the pNext chain of createDevice to enable features.

Valid Usage (Implicit)

textureCompressionASTC_HDR :: Bool
textureCompressionASTC_HDR indicates whether all of the ASTC HDR compressed texture formats are supported. If this feature is enabled, then the FORMAT_FEATURE_SAMPLED_IMAGE_BIT, FORMAT_FEATURE_BLIT_SRC_BIT and FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT features must be supported in optimalTilingFeatures for the following formats:
To query for additional properties, or if the feature is not enabled, getPhysicalDeviceFormatProperties and getPhysicalDeviceImageFormatProperties can be used to check for supported properties of individual formats as normal.

Instances

Instances details

Eq PhysicalDeviceTextureCompressionASTCHDRFeaturesEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_texture_compression_astc_hdr Methods (==) :: PhysicalDeviceTextureCompressionASTCHDRFeaturesEXT -> PhysicalDeviceTextureCompressionASTCHDRFeaturesEXT -> Bool # (/=) :: PhysicalDeviceTextureCompressionASTCHDRFeaturesEXT -> PhysicalDeviceTextureCompressionASTCHDRFeaturesEXT -> Bool #
Show PhysicalDeviceTextureCompressionASTCHDRFeaturesEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_texture_compression_astc_hdr Methods showsPrec :: Int -> PhysicalDeviceTextureCompressionASTCHDRFeaturesEXT -> ShowS # show :: PhysicalDeviceTextureCompressionASTCHDRFeaturesEXT -> String # showList :: [PhysicalDeviceTextureCompressionASTCHDRFeaturesEXT] -> ShowS #
Storable PhysicalDeviceTextureCompressionASTCHDRFeaturesEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_texture_compression_astc_hdr Methods sizeOf :: PhysicalDeviceTextureCompressionASTCHDRFeaturesEXT -> Int # alignment :: PhysicalDeviceTextureCompressionASTCHDRFeaturesEXT -> Int # peekElemOff :: Ptr PhysicalDeviceTextureCompressionASTCHDRFeaturesEXT -> Int -> IO PhysicalDeviceTextureCompressionASTCHDRFeaturesEXT # pokeElemOff :: Ptr PhysicalDeviceTextureCompressionASTCHDRFeaturesEXT -> Int -> PhysicalDeviceTextureCompressionASTCHDRFeaturesEXT -> IO () # peekByteOff :: Ptr b -> Int -> IO PhysicalDeviceTextureCompressionASTCHDRFeaturesEXT # pokeByteOff :: Ptr b -> Int -> PhysicalDeviceTextureCompressionASTCHDRFeaturesEXT -> IO () # peek :: Ptr PhysicalDeviceTextureCompressionASTCHDRFeaturesEXT -> IO PhysicalDeviceTextureCompressionASTCHDRFeaturesEXT # poke :: Ptr PhysicalDeviceTextureCompressionASTCHDRFeaturesEXT -> PhysicalDeviceTextureCompressionASTCHDRFeaturesEXT -> IO () #
FromCStruct PhysicalDeviceTextureCompressionASTCHDRFeaturesEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_texture_compression_astc_hdr Methods peekCStruct :: Ptr PhysicalDeviceTextureCompressionASTCHDRFeaturesEXT -> IO PhysicalDeviceTextureCompressionASTCHDRFeaturesEXT Source #
ToCStruct PhysicalDeviceTextureCompressionASTCHDRFeaturesEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_texture_compression_astc_hdr Methods withCStruct :: PhysicalDeviceTextureCompressionASTCHDRFeaturesEXT -> (Ptr PhysicalDeviceTextureCompressionASTCHDRFeaturesEXT -> IO b) -> IO b Source # pokeCStruct :: Ptr PhysicalDeviceTextureCompressionASTCHDRFeaturesEXT -> PhysicalDeviceTextureCompressionASTCHDRFeaturesEXT -> IO b -> IO b Source # withZeroCStruct :: (Ptr PhysicalDeviceTextureCompressionASTCHDRFeaturesEXT -> IO b) -> IO b Source # pokeZeroCStruct :: Ptr PhysicalDeviceTextureCompressionASTCHDRFeaturesEXT -> IO b -> IO b Source # cStructSize :: Int Source # cStructAlignment :: Int Source #
Zero PhysicalDeviceTextureCompressionASTCHDRFeaturesEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_texture_compression_astc_hdr Methods zero :: PhysicalDeviceTextureCompressionASTCHDRFeaturesEXT Source #