Vulkan.Extensions.VK_ANDROID_external_memory_android_hardware_buffer

Name

VK_ANDROID_external_memory_android_hardware_buffer - device extension

VK_ANDROID_external_memory_android_hardware_buffer

Name String

VK_ANDROID_external_memory_android_hardware_buffer

Extension Type

Device extension

Registered Extension Number

130

Revision

4

Extension and Version Dependencies

• Requires Vulkan 1.0
• Requires VK_KHR_sampler_ycbcr_conversion
• Requires VK_KHR_external_memory
• Requires VK_EXT_queue_family_foreign
• Requires VK_KHR_dedicated_allocation

Contact

• Jesse Hall @critsec%0A<<Here describe the issue or question you have about the VK_ANDROID_external_memory_android_hardware_buffer extension> >

Other Extension Metadata

Last Modified Date

2021-09-30

IP Status

No known IP claims.

Contributors

• Ray Smith, ARM
• Chad Versace, Google
• Jesse Hall, Google
• Tobias Hector, Imagination
• James Jones, NVIDIA
• Tony Zlatinski, NVIDIA
• Matthew Netsch, Qualcomm
• Andrew Garrard, Samsung

Description

This extension enables an application to import Android AHardwareBuffer objects created outside of the Vulkan device into Vulkan memory objects, where they can be bound to images and buffers. It also allows exporting an AHardwareBuffer from a Vulkan memory object for symmetry with other operating systems. But since not all AHardwareBuffer usages and formats have Vulkan equivalents, exporting from Vulkan provides strictly less functionality than creating the AHardwareBuffer externally and importing it.

Some AHardwareBuffer images have implementation-defined /external formats that may/ not correspond to Vulkan formats. Sampler Y′CBCR conversion can be used to sample from these images and convert them to a known color space.

New Base Types

• AHardwareBuffer

New Commands

• getAndroidHardwareBufferPropertiesANDROID

• getMemoryAndroidHardwareBufferANDROID

New Structures

• AndroidHardwareBufferPropertiesANDROID

• MemoryGetAndroidHardwareBufferInfoANDROID

• Extending AndroidHardwareBufferPropertiesANDROID:

  • AndroidHardwareBufferFormatPropertiesANDROID

• Extending ImageCreateInfo, SamplerYcbcrConversionCreateInfo:

  • ExternalFormatANDROID

• Extending ImageFormatProperties2:

  • AndroidHardwareBufferUsageANDROID

• Extending MemoryAllocateInfo:

  • ImportAndroidHardwareBufferInfoANDROID

If VK_KHR_format_feature_flags2 is supported:

• Extending AndroidHardwareBufferPropertiesANDROID:

  • AndroidHardwareBufferFormatProperties2ANDROID

New Enum Constants

• ANDROID_EXTERNAL_MEMORY_ANDROID_HARDWARE_BUFFER_EXTENSION_NAME

• ANDROID_EXTERNAL_MEMORY_ANDROID_HARDWARE_BUFFER_SPEC_VERSION

• Extending ExternalMemoryHandleTypeFlagBits:

  • EXTERNAL_MEMORY_HANDLE_TYPE_ANDROID_HARDWARE_BUFFER_BIT_ANDROID

• Extending StructureType:

  • STRUCTURE_TYPE_ANDROID_HARDWARE_BUFFER_FORMAT_PROPERTIES_ANDROID
  • STRUCTURE_TYPE_ANDROID_HARDWARE_BUFFER_PROPERTIES_ANDROID
  • STRUCTURE_TYPE_ANDROID_HARDWARE_BUFFER_USAGE_ANDROID
  • STRUCTURE_TYPE_EXTERNAL_FORMAT_ANDROID
  • STRUCTURE_TYPE_IMPORT_ANDROID_HARDWARE_BUFFER_INFO_ANDROID
  • STRUCTURE_TYPE_MEMORY_GET_ANDROID_HARDWARE_BUFFER_INFO_ANDROID

If VK_KHR_format_feature_flags2 is supported:

• Extending StructureType:

  • STRUCTURE_TYPE_ANDROID_HARDWARE_BUFFER_FORMAT_PROPERTIES_2_ANDROID

Issues

1) Other external memory objects are represented as weakly-typed handles (e.g. Win32 HANDLE or POSIX file descriptor), and require a handle type parameter along with handles. AHardwareBuffer is strongly typed, so naming the handle type is redundant. Does symmetry justify adding handle type parameters/fields anyway?

RESOLVED: No. The handle type is already provided in places that treat external memory objects generically. In the places we would add it, the application code that would have to provide the handle type value is already dealing with AHardwareBuffer-specific commands/structures; the extra symmetry would not be enough to make that code generic.

2) The internal layout and therefore size of a AHardwareBuffer image may depend on native usage flags that do not have corresponding Vulkan counterparts. Do we provide this information to createImage somehow, or allow the allocation size reported by getImageMemoryRequirements to be approximate?

RESOLVED: Allow the allocation size to be unspecified when allocating the memory. It has to work this way for exported image memory anyway, since AHardwareBuffer allocation happens in allocateMemory, and internally is performed by a separate HAL, not the Vulkan implementation itself. There is a similar issue with getImageSubresourceLayout: the layout is determined by the allocator HAL, so it is not known until the image is bound to memory.

3) Should the result of sampling an external-format image with the suggested Y′CBCR conversion parameters yield the same results as using a samplerExternalOES in OpenGL ES?

RESOLVED: This would be desirable, so that apps converting from OpenGL ES to Vulkan could get the same output given the same input. But since sampling and conversion from Y′CBCR images is so loosely defined in OpenGL ES, multiple implementations do it in a way that does not conform to Vulkan’s requirements. Modifying the OpenGL ES implementation would be difficult, and would change the output of existing unmodified applications. Changing the output only for applications that are being modified gives developers the chance to notice and mitigate any problems. Implementations are encouraged to minimize differences as much as possible without causing compatibility problems for existing OpenGL ES applications or violating Vulkan requirements.

4) Should an AHardwareBuffer with AHARDWAREBUFFER_USAGE_CPU_* usage be mappable in Vulkan? Should it be possible to export an AHardwareBuffers with such usage?

RESOLVED: Optional, and mapping in Vulkan is not the same as AHardwareBuffer_lock. The semantics of these are different: mapping in memory is persistent, just gives a raw view of the memory contents, and does not involve ownership. AHardwareBuffer_lock gives the host exclusive access to the buffer, is temporary, and allows for reformatting copy-in/copy-out. Implementations are not required to support host-visible memory types for imported Android hardware buffers or resources backed by them. If a host-visible memory type is supported and used, the memory can be mapped in Vulkan, but doing so follows Vulkan semantics: it is just a raw view of the data and does not imply ownership (this means implementations must not internally call AHardwareBuffer_lock to implement mapMemory, or assume the application has done so). Implementations are not required to support linear-tiled images backed by Android hardware buffers, even if the AHardwareBuffer has CPU usage. There is no reliable way to allocate memory in Vulkan that can be exported to a AHardwareBuffer with CPU usage.

5) Android may add new AHardwareBuffer formats and usage flags over time. Can reference to them be added to this extension, or do they need a new extension?

RESOLVED: This extension can document the interaction between the new AHB formats/usages and existing Vulkan features. No new Vulkan features or implementation requirements can be added. The extension version number will be incremented when this additional documentation is added, but the version number does not indicate that an implementaiton supports Vulkan memory or resources that map to the new AHardwareBuffer features: support for that must be queried with getPhysicalDeviceImageFormatProperties2 or is implied by successfully allocating a AHardwareBuffer outside of Vulkan that uses the new feature and has a GPU usage flag.

In essence, these are new features added to a new Android API level, rather than new Vulkan features. The extension will only document how existing Vulkan features map to that new Android feature.

Version History

• Revision 4, 2021-09-30 (Jon Leech)

  • Add interaction with VK_KHR_format_feature_flags2 to vk.xml

• Revision 3, 2019-08-27 (Jon Leech)

  • Update revision history to correspond to XML version number

• Revision 2, 2018-04-09 (Petr Kraus)

  • Markup fixes and remove incorrect Draft status

• Revision 1, 2018-03-04 (Jesse Hall)

  • Initial version

See Also

AHardwareBuffer, AndroidHardwareBufferFormatPropertiesANDROID, AndroidHardwareBufferPropertiesANDROID, AndroidHardwareBufferUsageANDROID, ExternalFormatANDROID, ImportAndroidHardwareBufferInfoANDROID, MemoryGetAndroidHardwareBufferInfoANDROID, getAndroidHardwareBufferPropertiesANDROID, getMemoryAndroidHardwareBufferANDROID

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.

Documentation

getAndroidHardwareBufferPropertiesANDROID

Arguments

:: forall a io. (Extendss AndroidHardwareBufferPropertiesANDROID a, PokeChain a, PeekChain a, MonadIO io)

=> Device

device is the logical device that will be importing buffer.

device must be a valid Device handle

-> Ptr AHardwareBuffer

buffer is the Android hardware buffer which will be imported.

buffer must be a valid Android hardware buffer object with at least one of the AHARDWAREBUFFER_USAGE_GPU_* flags in its AHardwareBuffer_Desc::usage

buffer must be a valid pointer to a valid AHardwareBuffer value

-> io (AndroidHardwareBufferPropertiesANDROID a)

vkGetAndroidHardwareBufferPropertiesANDROID - Get Properties of External Memory Android Hardware Buffers

Return Codes

Success

• SUCCESS

Failure

• ERROR_OUT_OF_HOST_MEMORY
• ERROR_INVALID_EXTERNAL_HANDLE_KHR

See Also

VK_ANDROID_external_memory_android_hardware_buffer, AndroidHardwareBufferPropertiesANDROID, Device

getMemoryAndroidHardwareBufferANDROID

Arguments

:: forall io. MonadIO io

=> Device

device is the logical device that created the device memory being exported.

device must be a valid Device handle

-> MemoryGetAndroidHardwareBufferInfoANDROID

pInfo is a pointer to a MemoryGetAndroidHardwareBufferInfoANDROID structure containing parameters of the export operation.

pInfo must be a valid pointer to a valid MemoryGetAndroidHardwareBufferInfoANDROID structure

-> io (Ptr AHardwareBuffer)

vkGetMemoryAndroidHardwareBufferANDROID - Get an Android hardware buffer for a memory object

Description

Each call to getMemoryAndroidHardwareBufferANDROID must return an Android hardware buffer with a new reference acquired in addition to the reference held by the DeviceMemory. To avoid leaking resources, the application must release the reference by calling AHardwareBuffer_release when it is no longer needed. When called with the same handle in MemoryGetAndroidHardwareBufferInfoANDROID::memory, getMemoryAndroidHardwareBufferANDROID must return the same Android hardware buffer object. If the device memory was created by importing an Android hardware buffer, getMemoryAndroidHardwareBufferANDROID must return that same Android hardware buffer object.

Return Codes

Success

• SUCCESS

Failure

• ERROR_TOO_MANY_OBJECTS
• ERROR_OUT_OF_HOST_MEMORY

See Also

VK_ANDROID_external_memory_android_hardware_buffer, Device, MemoryGetAndroidHardwareBufferInfoANDROID

data ImportAndroidHardwareBufferInfoANDROID

VkImportAndroidHardwareBufferInfoANDROID - Import memory from an Android hardware buffer

Description

If the allocateMemory command succeeds, the implementation must acquire a reference to the imported hardware buffer, which it must release when the device memory object is freed. If the command fails, the implementation must not retain a reference.

Valid Usage

• If buffer is not NULL, Android hardware buffers must be supported for import, as reported by ExternalImageFormatProperties or ExternalBufferProperties

• If buffer is not NULL, it must be a valid Android hardware buffer object with AHardwareBuffer_Desc::usage compatible with Vulkan as described in Android Hardware Buffers

Valid Usage (Implicit)

• sType must be STRUCTURE_TYPE_IMPORT_ANDROID_HARDWARE_BUFFER_INFO_ANDROID

• buffer must be a valid pointer to an AHardwareBuffer value

See Also

VK_ANDROID_external_memory_android_hardware_buffer, StructureType

Constructors

ImportAndroidHardwareBufferInfoANDROID

Fields

• buffer :: Ptr AHardwareBuffer

  buffer is the Android hardware buffer to import.

Instances

Eq ImportAndroidHardwareBufferInfoANDROID

Defined in Vulkan.Extensions.VK_ANDROID_external_memory_android_hardware_buffer

Methods

(==) :: ImportAndroidHardwareBufferInfoANDROID -> ImportAndroidHardwareBufferInfoANDROID -> Bool

(/=) :: ImportAndroidHardwareBufferInfoANDROID -> ImportAndroidHardwareBufferInfoANDROID -> Bool

Show ImportAndroidHardwareBufferInfoANDROID

Defined in Vulkan.Extensions.VK_ANDROID_external_memory_android_hardware_buffer

Methods

showsPrec :: Int -> ImportAndroidHardwareBufferInfoANDROID -> ShowS

show :: ImportAndroidHardwareBufferInfoANDROID -> String

showList :: [ImportAndroidHardwareBufferInfoANDROID] -> ShowS

Storable ImportAndroidHardwareBufferInfoANDROID

Defined in Vulkan.Extensions.VK_ANDROID_external_memory_android_hardware_buffer

Methods

sizeOf :: ImportAndroidHardwareBufferInfoANDROID -> Int

alignment :: ImportAndroidHardwareBufferInfoANDROID -> Int

peekElemOff :: Ptr ImportAndroidHardwareBufferInfoANDROID -> Int -> IO ImportAndroidHardwareBufferInfoANDROID

pokeElemOff :: Ptr ImportAndroidHardwareBufferInfoANDROID -> Int -> ImportAndroidHardwareBufferInfoANDROID -> IO ()

peekByteOff :: Ptr b -> Int -> IO ImportAndroidHardwareBufferInfoANDROID

pokeByteOff :: Ptr b -> Int -> ImportAndroidHardwareBufferInfoANDROID -> IO ()

peek :: Ptr ImportAndroidHardwareBufferInfoANDROID -> IO ImportAndroidHardwareBufferInfoANDROID

poke :: Ptr ImportAndroidHardwareBufferInfoANDROID -> ImportAndroidHardwareBufferInfoANDROID -> IO ()

FromCStruct ImportAndroidHardwareBufferInfoANDROID

Defined in Vulkan.Extensions.VK_ANDROID_external_memory_android_hardware_buffer

Methods

peekCStruct :: Ptr ImportAndroidHardwareBufferInfoANDROID -> IO ImportAndroidHardwareBufferInfoANDROID

ToCStruct ImportAndroidHardwareBufferInfoANDROID

Defined in Vulkan.Extensions.VK_ANDROID_external_memory_android_hardware_buffer

Methods

withCStruct :: ImportAndroidHardwareBufferInfoANDROID -> (Ptr ImportAndroidHardwareBufferInfoANDROID -> IO b) -> IO b

pokeCStruct :: Ptr ImportAndroidHardwareBufferInfoANDROID -> ImportAndroidHardwareBufferInfoANDROID -> IO b -> IO b

withZeroCStruct :: (Ptr ImportAndroidHardwareBufferInfoANDROID -> IO b) -> IO b

pokeZeroCStruct :: Ptr ImportAndroidHardwareBufferInfoANDROID -> IO b -> IO b

cStructSize :: Int

cStructAlignment :: Int

Zero ImportAndroidHardwareBufferInfoANDROID

Defined in Vulkan.Extensions.VK_ANDROID_external_memory_android_hardware_buffer

Methods

zero :: ImportAndroidHardwareBufferInfoANDROID

data AndroidHardwareBufferUsageANDROID

VkAndroidHardwareBufferUsageANDROID - Struct containing Android hardware buffer usage flags

Description

The androidHardwareBufferUsage field must include Android hardware buffer usage flags listed in the AHardwareBuffer Usage Equivalence table when the corresponding Vulkan image usage or image creation flags are included in the usage or flags fields of PhysicalDeviceImageFormatInfo2. It must include at least one GPU usage flag (AHARDWAREBUFFER_USAGE_GPU_*), even if none of the corresponding Vulkan usages or flags are requested.

Note

Requiring at least one GPU usage flag ensures that Android hardware buffer memory will be allocated in a memory pool accessible to the Vulkan implementation, and that specializing the memory layout based on usage flags does not prevent it from being compatible with Vulkan. Implementations may avoid unnecessary restrictions caused by this requirement by using vendor usage flags to indicate that only the Vulkan uses indicated in ImageFormatProperties2 are required.

Valid Usage (Implicit)

See Also

VK_ANDROID_external_memory_android_hardware_buffer, StructureType

Constructors

AndroidHardwareBufferUsageANDROID

Fields

• androidHardwareBufferUsage :: Word64

  androidHardwareBufferUsage returns the Android hardware buffer usage flags.

Instances

Eq AndroidHardwareBufferUsageANDROID

Defined in Vulkan.Extensions.VK_ANDROID_external_memory_android_hardware_buffer

Methods

(==) :: AndroidHardwareBufferUsageANDROID -> AndroidHardwareBufferUsageANDROID -> Bool

(/=) :: AndroidHardwareBufferUsageANDROID -> AndroidHardwareBufferUsageANDROID -> Bool

Show AndroidHardwareBufferUsageANDROID

Defined in Vulkan.Extensions.VK_ANDROID_external_memory_android_hardware_buffer

Methods

showsPrec :: Int -> AndroidHardwareBufferUsageANDROID -> ShowS

show :: AndroidHardwareBufferUsageANDROID -> String

showList :: [AndroidHardwareBufferUsageANDROID] -> ShowS

Storable AndroidHardwareBufferUsageANDROID

Defined in Vulkan.Extensions.VK_ANDROID_external_memory_android_hardware_buffer

Methods

sizeOf :: AndroidHardwareBufferUsageANDROID -> Int

alignment :: AndroidHardwareBufferUsageANDROID -> Int

peekElemOff :: Ptr AndroidHardwareBufferUsageANDROID -> Int -> IO AndroidHardwareBufferUsageANDROID

pokeElemOff :: Ptr AndroidHardwareBufferUsageANDROID -> Int -> AndroidHardwareBufferUsageANDROID -> IO ()

peekByteOff :: Ptr b -> Int -> IO AndroidHardwareBufferUsageANDROID

pokeByteOff :: Ptr b -> Int -> AndroidHardwareBufferUsageANDROID -> IO ()

peek :: Ptr AndroidHardwareBufferUsageANDROID -> IO AndroidHardwareBufferUsageANDROID

poke :: Ptr AndroidHardwareBufferUsageANDROID -> AndroidHardwareBufferUsageANDROID -> IO ()

FromCStruct AndroidHardwareBufferUsageANDROID

Defined in Vulkan.Extensions.VK_ANDROID_external_memory_android_hardware_buffer

Methods

peekCStruct :: Ptr AndroidHardwareBufferUsageANDROID -> IO AndroidHardwareBufferUsageANDROID

ToCStruct AndroidHardwareBufferUsageANDROID

Defined in Vulkan.Extensions.VK_ANDROID_external_memory_android_hardware_buffer

Methods

withCStruct :: AndroidHardwareBufferUsageANDROID -> (Ptr AndroidHardwareBufferUsageANDROID -> IO b) -> IO b

pokeCStruct :: Ptr AndroidHardwareBufferUsageANDROID -> AndroidHardwareBufferUsageANDROID -> IO b -> IO b

withZeroCStruct :: (Ptr AndroidHardwareBufferUsageANDROID -> IO b) -> IO b

pokeZeroCStruct :: Ptr AndroidHardwareBufferUsageANDROID -> IO b -> IO b

cStructSize :: Int

cStructAlignment :: Int

Zero AndroidHardwareBufferUsageANDROID

Defined in Vulkan.Extensions.VK_ANDROID_external_memory_android_hardware_buffer

Methods

zero :: AndroidHardwareBufferUsageANDROID

data AndroidHardwareBufferPropertiesANDROID (es :: [Type])

VkAndroidHardwareBufferPropertiesANDROID - Properties of External Memory Android Hardware Buffers

Valid Usage (Implicit)

• sType must be STRUCTURE_TYPE_ANDROID_HARDWARE_BUFFER_PROPERTIES_ANDROID

• Each pNext member of any structure (including this one) in the pNext chain must be either NULL or a pointer to a valid instance of AndroidHardwareBufferFormatProperties2ANDROID or AndroidHardwareBufferFormatPropertiesANDROID
• The sType value of each struct in the pNext chain must be unique

See Also

VK_ANDROID_external_memory_android_hardware_buffer, DeviceSize, StructureType, getAndroidHardwareBufferPropertiesANDROID

Constructors

AndroidHardwareBufferPropertiesANDROID

Fields

• next :: Chain es

  pNext is NULL or a pointer to a structure extending this structure.

• allocationSize :: DeviceSize

  allocationSize is the size of the external memory

• memoryTypeBits :: Word32

  memoryTypeBits is a bitmask containing one bit set for every memory type which the specified Android hardware buffer can be imported as.

Instances

Extensible AndroidHardwareBufferPropertiesANDROID

Defined in Vulkan.Extensions.VK_ANDROID_external_memory_android_hardware_buffer

Methods

extensibleTypeName :: String

getNext :: forall (es :: [Type]). AndroidHardwareBufferPropertiesANDROID es -> Chain es

setNext :: forall (ds :: [Type]) (es :: [Type]). AndroidHardwareBufferPropertiesANDROID ds -> Chain es -> AndroidHardwareBufferPropertiesANDROID es

extends :: forall e b proxy. Typeable e => proxy e -> (Extends AndroidHardwareBufferPropertiesANDROID e => b) -> Maybe b

Show (Chain es) => Show (AndroidHardwareBufferPropertiesANDROID es)

Defined in Vulkan.Extensions.VK_ANDROID_external_memory_android_hardware_buffer

Methods

showsPrec :: Int -> AndroidHardwareBufferPropertiesANDROID es -> ShowS

show :: AndroidHardwareBufferPropertiesANDROID es -> String

showList :: [AndroidHardwareBufferPropertiesANDROID es] -> ShowS

(Extendss AndroidHardwareBufferPropertiesANDROID es, PeekChain es) => FromCStruct (AndroidHardwareBufferPropertiesANDROID es)

Defined in Vulkan.Extensions.VK_ANDROID_external_memory_android_hardware_buffer

Methods

peekCStruct :: Ptr (AndroidHardwareBufferPropertiesANDROID es) -> IO (AndroidHardwareBufferPropertiesANDROID es)

(Extendss AndroidHardwareBufferPropertiesANDROID es, PokeChain es) => ToCStruct (AndroidHardwareBufferPropertiesANDROID es)

Defined in Vulkan.Extensions.VK_ANDROID_external_memory_android_hardware_buffer

Methods

withCStruct :: AndroidHardwareBufferPropertiesANDROID es -> (Ptr (AndroidHardwareBufferPropertiesANDROID es) -> IO b) -> IO b

pokeCStruct :: Ptr (AndroidHardwareBufferPropertiesANDROID es) -> AndroidHardwareBufferPropertiesANDROID es -> IO b -> IO b

withZeroCStruct :: (Ptr (AndroidHardwareBufferPropertiesANDROID es) -> IO b) -> IO b

pokeZeroCStruct :: Ptr (AndroidHardwareBufferPropertiesANDROID es) -> IO b -> IO b

cStructSize :: Int

cStructAlignment :: Int

es ~ ('[] :: [Type]) => Zero (AndroidHardwareBufferPropertiesANDROID es)

Defined in Vulkan.Extensions.VK_ANDROID_external_memory_android_hardware_buffer

Methods

zero :: AndroidHardwareBufferPropertiesANDROID es

data MemoryGetAndroidHardwareBufferInfoANDROID

VkMemoryGetAndroidHardwareBufferInfoANDROID - Structure describing an Android hardware buffer memory export operation

Valid Usage

• EXTERNAL_MEMORY_HANDLE_TYPE_ANDROID_HARDWARE_BUFFER_BIT_ANDROID must have been included in ExportMemoryAllocateInfo::handleTypes when memory was created

• If the pNext chain of the MemoryAllocateInfo used to allocate memory included a MemoryDedicatedAllocateInfo with non-NULL image member, then that image must already be bound to memory

Valid Usage (Implicit)

• sType must be STRUCTURE_TYPE_MEMORY_GET_ANDROID_HARDWARE_BUFFER_INFO_ANDROID

• pNext must be NULL
• memory must be a valid DeviceMemory handle

See Also

VK_ANDROID_external_memory_android_hardware_buffer, DeviceMemory, StructureType, getMemoryAndroidHardwareBufferANDROID

Constructors

MemoryGetAndroidHardwareBufferInfoANDROID

Fields

• memory :: DeviceMemory

  memory is the memory object from which the Android hardware buffer will be exported.

Instances

Eq MemoryGetAndroidHardwareBufferInfoANDROID

Defined in Vulkan.Extensions.VK_ANDROID_external_memory_android_hardware_buffer

Methods

(==) :: MemoryGetAndroidHardwareBufferInfoANDROID -> MemoryGetAndroidHardwareBufferInfoANDROID -> Bool

(/=) :: MemoryGetAndroidHardwareBufferInfoANDROID -> MemoryGetAndroidHardwareBufferInfoANDROID -> Bool

Show MemoryGetAndroidHardwareBufferInfoANDROID

Defined in Vulkan.Extensions.VK_ANDROID_external_memory_android_hardware_buffer

Methods

showsPrec :: Int -> MemoryGetAndroidHardwareBufferInfoANDROID -> ShowS

show :: MemoryGetAndroidHardwareBufferInfoANDROID -> String

showList :: [MemoryGetAndroidHardwareBufferInfoANDROID] -> ShowS

Storable MemoryGetAndroidHardwareBufferInfoANDROID

Defined in Vulkan.Extensions.VK_ANDROID_external_memory_android_hardware_buffer

Methods

sizeOf :: MemoryGetAndroidHardwareBufferInfoANDROID -> Int

alignment :: MemoryGetAndroidHardwareBufferInfoANDROID -> Int

peekElemOff :: Ptr MemoryGetAndroidHardwareBufferInfoANDROID -> Int -> IO MemoryGetAndroidHardwareBufferInfoANDROID

pokeElemOff :: Ptr MemoryGetAndroidHardwareBufferInfoANDROID -> Int -> MemoryGetAndroidHardwareBufferInfoANDROID -> IO ()

peekByteOff :: Ptr b -> Int -> IO MemoryGetAndroidHardwareBufferInfoANDROID

pokeByteOff :: Ptr b -> Int -> MemoryGetAndroidHardwareBufferInfoANDROID -> IO ()

peek :: Ptr MemoryGetAndroidHardwareBufferInfoANDROID -> IO MemoryGetAndroidHardwareBufferInfoANDROID

poke :: Ptr MemoryGetAndroidHardwareBufferInfoANDROID -> MemoryGetAndroidHardwareBufferInfoANDROID -> IO ()

FromCStruct MemoryGetAndroidHardwareBufferInfoANDROID

Defined in Vulkan.Extensions.VK_ANDROID_external_memory_android_hardware_buffer

Methods

peekCStruct :: Ptr MemoryGetAndroidHardwareBufferInfoANDROID -> IO MemoryGetAndroidHardwareBufferInfoANDROID

ToCStruct MemoryGetAndroidHardwareBufferInfoANDROID

Defined in Vulkan.Extensions.VK_ANDROID_external_memory_android_hardware_buffer

Methods

withCStruct :: MemoryGetAndroidHardwareBufferInfoANDROID -> (Ptr MemoryGetAndroidHardwareBufferInfoANDROID -> IO b) -> IO b

pokeCStruct :: Ptr MemoryGetAndroidHardwareBufferInfoANDROID -> MemoryGetAndroidHardwareBufferInfoANDROID -> IO b -> IO b

withZeroCStruct :: (Ptr MemoryGetAndroidHardwareBufferInfoANDROID -> IO b) -> IO b

pokeZeroCStruct :: Ptr MemoryGetAndroidHardwareBufferInfoANDROID -> IO b -> IO b

cStructSize :: Int

cStructAlignment :: Int

Zero MemoryGetAndroidHardwareBufferInfoANDROID

Defined in Vulkan.Extensions.VK_ANDROID_external_memory_android_hardware_buffer

Methods

zero :: MemoryGetAndroidHardwareBufferInfoANDROID

data AndroidHardwareBufferFormatPropertiesANDROID

VkAndroidHardwareBufferFormatPropertiesANDROID - Structure describing the image format properties of an Android hardware buffer

Description

If the Android hardware buffer has one of the formats listed in the Format Equivalence table, then format must have the equivalent Vulkan format listed in the table. Otherwise, format may be FORMAT_UNDEFINED, indicating the Android hardware buffer can only be used with an external format.

The formatFeatures member must include FORMAT_FEATURE_SAMPLED_IMAGE_BIT and at least one of FORMAT_FEATURE_MIDPOINT_CHROMA_SAMPLES_BIT or FORMAT_FEATURE_COSITED_CHROMA_SAMPLES_BIT, and should include FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT and FORMAT_FEATURE_SAMPLED_IMAGE_YCBCR_CONVERSION_LINEAR_FILTER_BIT.

Note

The formatFeatures member only indicates the features available when using an external-format image created from the Android hardware buffer. Images from Android hardware buffers with a format other than FORMAT_UNDEFINED are subject to the format capabilities obtained from getPhysicalDeviceFormatProperties2, and getPhysicalDeviceImageFormatProperties2 with appropriate parameters. These sets of features are independent of each other, e.g. the external format will support sampler Y′CBCR conversion even if the non-external format does not, and writing to non-external format images is possible but writing to external format images is not.

Android hardware buffers with the same external format must have the same support for FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT, FORMAT_FEATURE_MIDPOINT_CHROMA_SAMPLES_BIT, FORMAT_FEATURE_COSITED_CHROMA_SAMPLES_BIT, FORMAT_FEATURE_SAMPLED_IMAGE_YCBCR_CONVERSION_LINEAR_FILTER_BIT, FORMAT_FEATURE_SAMPLED_IMAGE_YCBCR_CONVERSION_SEPARATE_RECONSTRUCTION_FILTER_BIT, and FORMAT_FEATURE_SAMPLED_IMAGE_YCBCR_CONVERSION_CHROMA_RECONSTRUCTION_EXPLICIT_FORCEABLE_BIT. in formatFeatures. Other format features may differ between Android hardware buffers that have the same external format. This allows applications to use the same SamplerYcbcrConversion object (and samplers and pipelines created from them) for any Android hardware buffers that have the same external format.

If format is not FORMAT_UNDEFINED, then the value of samplerYcbcrConversionComponents must be valid when used as the components member of SamplerYcbcrConversionCreateInfo with that format. If format is FORMAT_UNDEFINED, all members of samplerYcbcrConversionComponents must be the identity swizzle.

Implementations may not always be able to determine the color model, numerical range, or chroma offsets of the image contents, so the values in AndroidHardwareBufferFormatPropertiesANDROID are only suggestions. Applications should treat these values as sensible defaults to use in the absence of more reliable information obtained through some other means. If the underlying physical device is also usable via OpenGL ES with the GL_OES_EGL_image_external extension, the implementation should suggest values that will produce similar sampled values as would be obtained by sampling the same external image via samplerExternalOES in OpenGL ES using equivalent sampler parameters.

Note

Since GL_OES_EGL_image_external does not require the same sampling and conversion calculations as Vulkan does, achieving identical results between APIs may not be possible on some implementations.

Valid Usage (Implicit)

See Also

VK_ANDROID_external_memory_android_hardware_buffer, ChromaLocation, ComponentMapping, Format, FormatFeatureFlags, SamplerYcbcrModelConversion, SamplerYcbcrRange, StructureType

Constructors

AndroidHardwareBufferFormatPropertiesANDROID

Fields

• format :: Format

  format is the Vulkan format corresponding to the Android hardware buffer’s format, or FORMAT_UNDEFINED if there is not an equivalent Vulkan format.

• externalFormat :: Word64

  externalFormat is an implementation-defined external format identifier for use with ExternalFormatANDROID. It must not be zero.

• formatFeatures :: FormatFeatureFlags

  formatFeatures describes the capabilities of this external format when used with an image bound to memory imported from buffer.

• samplerYcbcrConversionComponents :: ComponentMapping

  samplerYcbcrConversionComponents is the component swizzle that should be used in SamplerYcbcrConversionCreateInfo.

• suggestedYcbcrModel :: SamplerYcbcrModelConversion

  suggestedYcbcrModel is a suggested color model to use in the SamplerYcbcrConversionCreateInfo.

• suggestedYcbcrRange :: SamplerYcbcrRange

  suggestedYcbcrRange is a suggested numerical value range to use in SamplerYcbcrConversionCreateInfo.

• suggestedXChromaOffset :: ChromaLocation

  suggestedXChromaOffset is a suggested X chroma offset to use in SamplerYcbcrConversionCreateInfo.

• suggestedYChromaOffset :: ChromaLocation

  suggestedYChromaOffset is a suggested Y chroma offset to use in SamplerYcbcrConversionCreateInfo.

Instances

Show AndroidHardwareBufferFormatPropertiesANDROID

Defined in Vulkan.Extensions.VK_ANDROID_external_memory_android_hardware_buffer

Methods

showsPrec :: Int -> AndroidHardwareBufferFormatPropertiesANDROID -> ShowS

show :: AndroidHardwareBufferFormatPropertiesANDROID -> String

showList :: [AndroidHardwareBufferFormatPropertiesANDROID] -> ShowS

Storable AndroidHardwareBufferFormatPropertiesANDROID

Defined in Vulkan.Extensions.VK_ANDROID_external_memory_android_hardware_buffer

Methods

sizeOf :: AndroidHardwareBufferFormatPropertiesANDROID -> Int

alignment :: AndroidHardwareBufferFormatPropertiesANDROID -> Int

peekElemOff :: Ptr AndroidHardwareBufferFormatPropertiesANDROID -> Int -> IO AndroidHardwareBufferFormatPropertiesANDROID

pokeElemOff :: Ptr AndroidHardwareBufferFormatPropertiesANDROID -> Int -> AndroidHardwareBufferFormatPropertiesANDROID -> IO ()

peekByteOff :: Ptr b -> Int -> IO AndroidHardwareBufferFormatPropertiesANDROID

pokeByteOff :: Ptr b -> Int -> AndroidHardwareBufferFormatPropertiesANDROID -> IO ()

peek :: Ptr AndroidHardwareBufferFormatPropertiesANDROID -> IO AndroidHardwareBufferFormatPropertiesANDROID

poke :: Ptr AndroidHardwareBufferFormatPropertiesANDROID -> AndroidHardwareBufferFormatPropertiesANDROID -> IO ()

FromCStruct AndroidHardwareBufferFormatPropertiesANDROID

Defined in Vulkan.Extensions.VK_ANDROID_external_memory_android_hardware_buffer

Methods

peekCStruct :: Ptr AndroidHardwareBufferFormatPropertiesANDROID -> IO AndroidHardwareBufferFormatPropertiesANDROID

ToCStruct AndroidHardwareBufferFormatPropertiesANDROID

Defined in Vulkan.Extensions.VK_ANDROID_external_memory_android_hardware_buffer

Methods

withCStruct :: AndroidHardwareBufferFormatPropertiesANDROID -> (Ptr AndroidHardwareBufferFormatPropertiesANDROID -> IO b) -> IO b

pokeCStruct :: Ptr AndroidHardwareBufferFormatPropertiesANDROID -> AndroidHardwareBufferFormatPropertiesANDROID -> IO b -> IO b

withZeroCStruct :: (Ptr AndroidHardwareBufferFormatPropertiesANDROID -> IO b) -> IO b

pokeZeroCStruct :: Ptr AndroidHardwareBufferFormatPropertiesANDROID -> IO b -> IO b

cStructSize :: Int

cStructAlignment :: Int

Zero AndroidHardwareBufferFormatPropertiesANDROID

Defined in Vulkan.Extensions.VK_ANDROID_external_memory_android_hardware_buffer

Methods

zero :: AndroidHardwareBufferFormatPropertiesANDROID

data ExternalFormatANDROID

VkExternalFormatANDROID - Structure containing an Android hardware buffer external format

Description

If externalFormat is zero, the effect is as if the ExternalFormatANDROID structure was not present. Otherwise, the image will have the specified external format.

Valid Usage (Implicit)

See Also

VK_ANDROID_external_memory_android_hardware_buffer, StructureType

Constructors

ExternalFormatANDROID

Fields

• externalFormat :: Word64

  externalFormat is an implementation-defined identifier for the external format

  externalFormat must be 0 or a value returned in the externalFormat member of AndroidHardwareBufferFormatPropertiesANDROID by an earlier call to getAndroidHardwareBufferPropertiesANDROID

Instances

Eq ExternalFormatANDROID

Defined in Vulkan.Extensions.VK_ANDROID_external_memory_android_hardware_buffer

Methods

(==) :: ExternalFormatANDROID -> ExternalFormatANDROID -> Bool

(/=) :: ExternalFormatANDROID -> ExternalFormatANDROID -> Bool

Show ExternalFormatANDROID

Defined in Vulkan.Extensions.VK_ANDROID_external_memory_android_hardware_buffer

Methods

showsPrec :: Int -> ExternalFormatANDROID -> ShowS

show :: ExternalFormatANDROID -> String

showList :: [ExternalFormatANDROID] -> ShowS

Storable ExternalFormatANDROID

Defined in Vulkan.Extensions.VK_ANDROID_external_memory_android_hardware_buffer

Methods

sizeOf :: ExternalFormatANDROID -> Int

alignment :: ExternalFormatANDROID -> Int

peekElemOff :: Ptr ExternalFormatANDROID -> Int -> IO ExternalFormatANDROID

pokeElemOff :: Ptr ExternalFormatANDROID -> Int -> ExternalFormatANDROID -> IO ()

peekByteOff :: Ptr b -> Int -> IO ExternalFormatANDROID

pokeByteOff :: Ptr b -> Int -> ExternalFormatANDROID -> IO ()

peek :: Ptr ExternalFormatANDROID -> IO ExternalFormatANDROID

poke :: Ptr ExternalFormatANDROID -> ExternalFormatANDROID -> IO ()

FromCStruct ExternalFormatANDROID

Defined in Vulkan.Extensions.VK_ANDROID_external_memory_android_hardware_buffer

Methods

peekCStruct :: Ptr ExternalFormatANDROID -> IO ExternalFormatANDROID

ToCStruct ExternalFormatANDROID

Defined in Vulkan.Extensions.VK_ANDROID_external_memory_android_hardware_buffer

Methods

withCStruct :: ExternalFormatANDROID -> (Ptr ExternalFormatANDROID -> IO b) -> IO b

pokeCStruct :: Ptr ExternalFormatANDROID -> ExternalFormatANDROID -> IO b -> IO b

withZeroCStruct :: (Ptr ExternalFormatANDROID -> IO b) -> IO b

pokeZeroCStruct :: Ptr ExternalFormatANDROID -> IO b -> IO b

cStructSize :: Int

cStructAlignment :: Int

Zero ExternalFormatANDROID

Defined in Vulkan.Extensions.VK_ANDROID_external_memory_android_hardware_buffer

Methods

zero :: ExternalFormatANDROID

data AndroidHardwareBufferFormatProperties2ANDROID

VkAndroidHardwareBufferFormatProperties2ANDROID - Structure describing the image format properties of an Android hardware buffer

Valid Usage (Implicit)

See Also

VK_ANDROID_external_memory_android_hardware_buffer, VK_KHR_format_feature_flags2, ChromaLocation, ComponentMapping, Format, FormatFeatureFlags2KHR, SamplerYcbcrModelConversion, SamplerYcbcrRange, StructureType

Constructors

AndroidHardwareBufferFormatProperties2ANDROID

Fields

• format :: Format

  format is the Vulkan format corresponding to the Android hardware buffer’s format, or FORMAT_UNDEFINED if there is not an equivalent Vulkan format.

• externalFormat :: Word64

  externalFormat is an implementation-defined external format identifier for use with ExternalFormatANDROID. It must not be zero.

• formatFeatures :: FormatFeatureFlags2KHR

  formatFeatures describes the capabilities of this external format when used with an image bound to memory imported from buffer.

• samplerYcbcrConversionComponents :: ComponentMapping

  samplerYcbcrConversionComponents is the component swizzle that should be used in SamplerYcbcrConversionCreateInfo.

• suggestedYcbcrModel :: SamplerYcbcrModelConversion

  suggestedYcbcrModel is a suggested color model to use in the SamplerYcbcrConversionCreateInfo.

• suggestedYcbcrRange :: SamplerYcbcrRange

  suggestedYcbcrRange is a suggested numerical value range to use in SamplerYcbcrConversionCreateInfo.

• suggestedXChromaOffset :: ChromaLocation

  suggestedXChromaOffset is a suggested X chroma offset to use in SamplerYcbcrConversionCreateInfo.

• suggestedYChromaOffset :: ChromaLocation

  suggestedYChromaOffset is a suggested Y chroma offset to use in SamplerYcbcrConversionCreateInfo.

Instances

Show AndroidHardwareBufferFormatProperties2ANDROID

Defined in Vulkan.Extensions.VK_ANDROID_external_memory_android_hardware_buffer

Methods

showsPrec :: Int -> AndroidHardwareBufferFormatProperties2ANDROID -> ShowS

show :: AndroidHardwareBufferFormatProperties2ANDROID -> String

showList :: [AndroidHardwareBufferFormatProperties2ANDROID] -> ShowS

Storable AndroidHardwareBufferFormatProperties2ANDROID

Defined in Vulkan.Extensions.VK_ANDROID_external_memory_android_hardware_buffer

Methods

sizeOf :: AndroidHardwareBufferFormatProperties2ANDROID -> Int

alignment :: AndroidHardwareBufferFormatProperties2ANDROID -> Int

peekElemOff :: Ptr AndroidHardwareBufferFormatProperties2ANDROID -> Int -> IO AndroidHardwareBufferFormatProperties2ANDROID

pokeElemOff :: Ptr AndroidHardwareBufferFormatProperties2ANDROID -> Int -> AndroidHardwareBufferFormatProperties2ANDROID -> IO ()

peekByteOff :: Ptr b -> Int -> IO AndroidHardwareBufferFormatProperties2ANDROID

pokeByteOff :: Ptr b -> Int -> AndroidHardwareBufferFormatProperties2ANDROID -> IO ()

peek :: Ptr AndroidHardwareBufferFormatProperties2ANDROID -> IO AndroidHardwareBufferFormatProperties2ANDROID

poke :: Ptr AndroidHardwareBufferFormatProperties2ANDROID -> AndroidHardwareBufferFormatProperties2ANDROID -> IO ()

FromCStruct AndroidHardwareBufferFormatProperties2ANDROID

Defined in Vulkan.Extensions.VK_ANDROID_external_memory_android_hardware_buffer

Methods

peekCStruct :: Ptr AndroidHardwareBufferFormatProperties2ANDROID -> IO AndroidHardwareBufferFormatProperties2ANDROID

ToCStruct AndroidHardwareBufferFormatProperties2ANDROID

Defined in Vulkan.Extensions.VK_ANDROID_external_memory_android_hardware_buffer

Methods

withCStruct :: AndroidHardwareBufferFormatProperties2ANDROID -> (Ptr AndroidHardwareBufferFormatProperties2ANDROID -> IO b) -> IO b

pokeCStruct :: Ptr AndroidHardwareBufferFormatProperties2ANDROID -> AndroidHardwareBufferFormatProperties2ANDROID -> IO b -> IO b

withZeroCStruct :: (Ptr AndroidHardwareBufferFormatProperties2ANDROID -> IO b) -> IO b

pokeZeroCStruct :: Ptr AndroidHardwareBufferFormatProperties2ANDROID -> IO b -> IO b

cStructSize :: Int

cStructAlignment :: Int

Zero AndroidHardwareBufferFormatProperties2ANDROID

Defined in Vulkan.Extensions.VK_ANDROID_external_memory_android_hardware_buffer

Methods

zero :: AndroidHardwareBufferFormatProperties2ANDROID

type ANDROID_EXTERNAL_MEMORY_ANDROID_HARDWARE_BUFFER_SPEC_VERSION = 4

pattern ANDROID_EXTERNAL_MEMORY_ANDROID_HARDWARE_BUFFER_SPEC_VERSION :: forall a. Integral a => a

type ANDROID_EXTERNAL_MEMORY_ANDROID_HARDWARE_BUFFER_EXTENSION_NAME = "VK_ANDROID_external_memory_android_hardware_buffer"

pattern ANDROID_EXTERNAL_MEMORY_ANDROID_HARDWARE_BUFFER_EXTENSION_NAME :: forall a. (Eq a, IsString a) => a

data AHardwareBuffer

newtype FormatFeatureFlagBits2KHR

VkFormatFeatureFlagBits2KHR - Bitmask specifying features supported by a buffer

Description

The following bits may be set in linearTilingFeatures and optimalTilingFeatures, specifying that the features are supported by images or image views or sampler Y′CBCR conversion objects created with the queried getPhysicalDeviceFormatProperties2::format:

• FORMAT_FEATURE_2_SAMPLED_IMAGE_BIT_KHR specifies that an image view can be sampled from.
• FORMAT_FEATURE_2_STORAGE_IMAGE_BIT_KHR specifies that an image view can be used as a storage image.
• FORMAT_FEATURE_2_STORAGE_IMAGE_ATOMIC_BIT_KHR specifies that an image view can be used as storage image that supports atomic operations.
• FORMAT_FEATURE_2_COLOR_ATTACHMENT_BIT_KHR specifies that an image view can be used as a framebuffer color attachment and as an input attachment.
• FORMAT_FEATURE_2_COLOR_ATTACHMENT_BLEND_BIT_KHR specifies that an image view can be used as a framebuffer color attachment that supports blending and as an input attachment.
• FORMAT_FEATURE_2_DEPTH_STENCIL_ATTACHMENT_BIT_KHR specifies that an image view can be used as a framebuffer depth/stencil attachment and as an input attachment.
• FORMAT_FEATURE_2_BLIT_SRC_BIT_KHR specifies that an image can be used as srcImage for the cmdBlitImage2KHR and cmdBlitImage commands.
• FORMAT_FEATURE_2_BLIT_DST_BIT_KHR specifies that an image can be used as dstImage for the cmdBlitImage2KHR and cmdBlitImage commands.

• FORMAT_FEATURE_2_SAMPLED_IMAGE_FILTER_LINEAR_BIT_KHR specifies that if FORMAT_FEATURE_2_SAMPLED_IMAGE_BIT_KHR is also set, an image view can be used with a sampler that has either of magFilter or minFilter set to FILTER_LINEAR, or mipmapMode set to SAMPLER_MIPMAP_MODE_LINEAR. If FORMAT_FEATURE_2_BLIT_SRC_BIT_KHR is also set, an image can be used as the srcImage to cmdBlitImage2KHR and cmdBlitImage with a filter of FILTER_LINEAR. This bit must only be exposed for formats that also support the FORMAT_FEATURE_2_SAMPLED_IMAGE_BIT_KHR or FORMAT_FEATURE_2_BLIT_SRC_BIT_KHR.

  If the format being queried is a depth/stencil format, this bit only specifies that the depth aspect (not the stencil aspect) of an image of this format supports linear filtering. Where depth comparison is supported it may be linear filtered whether this bit is present or not, but where this bit is not present the filtered value may be computed in an implementation-dependent manner which differs from the normal rules of linear filtering. The resulting value must be in the range [0,1] and should be proportional to, or a weighted average of, the number of comparison passes or failures.

• FORMAT_FEATURE_2_TRANSFER_SRC_BIT_KHR specifies that an image can be used as a source image for copy commands.
• FORMAT_FEATURE_2_TRANSFER_DST_BIT_KHR specifies that an image can be used as a destination image for copy commands and clear commands.
• FORMAT_FEATURE_2_SAMPLED_IMAGE_FILTER_MINMAX_BIT_KHR specifies Image can be used as a sampled image with a min or max SamplerReductionMode. This bit must only be exposed for formats that also support the FORMAT_FEATURE_2_SAMPLED_IMAGE_BIT_KHR.
• FORMAT_FEATURE_2_SAMPLED_IMAGE_FILTER_CUBIC_BIT_EXT specifies that Image can be used with a sampler that has either of magFilter or minFilter set to FILTER_CUBIC_EXT, or be the source image for a blit with filter set to FILTER_CUBIC_EXT. This bit must only be exposed for formats that also support the FORMAT_FEATURE_2_SAMPLED_IMAGE_BIT_KHR. If the format being queried is a depth/stencil format, this only specifies that the depth aspect is cubic filterable.
• FORMAT_FEATURE_2_MIDPOINT_CHROMA_SAMPLES_BIT_KHR specifies that an application can define a sampler Y′CBCR conversion using this format as a source, and that an image of this format can be used with a SamplerYcbcrConversionCreateInfo xChromaOffset and/or yChromaOffset of CHROMA_LOCATION_MIDPOINT. Otherwise both xChromaOffset and yChromaOffset must be CHROMA_LOCATION_COSITED_EVEN. If a format does not incorporate chroma downsampling (it is not a “422” or “420” format) but the implementation supports sampler Y′CBCR conversion for this format, the implementation must set FORMAT_FEATURE_2_MIDPOINT_CHROMA_SAMPLES_BIT_KHR.
• FORMAT_FEATURE_2_COSITED_CHROMA_SAMPLES_BIT_KHR specifies that an application can define a sampler Y′CBCR conversion using this format as a source, and that an image of this format can be used with a SamplerYcbcrConversionCreateInfo xChromaOffset and/or yChromaOffset of CHROMA_LOCATION_COSITED_EVEN. Otherwise both xChromaOffset and yChromaOffset must be CHROMA_LOCATION_MIDPOINT. If neither FORMAT_FEATURE_2_COSITED_CHROMA_SAMPLES_BIT_KHR nor FORMAT_FEATURE_2_MIDPOINT_CHROMA_SAMPLES_BIT_KHR is set, the application must not define a sampler Y′CBCR conversion using this format as a source.
• FORMAT_FEATURE_2_SAMPLED_IMAGE_YCBCR_CONVERSION_LINEAR_FILTER_BIT_KHR specifies that an application can define a sampler Y′CBCR conversion using this format as a source with chromaFilter set to FILTER_LINEAR.
• FORMAT_FEATURE_2_SAMPLED_IMAGE_YCBCR_CONVERSION_SEPARATE_RECONSTRUCTION_FILTER_BIT_KHR specifies that the format can have different chroma, min, and mag filters.
• FORMAT_FEATURE_2_SAMPLED_IMAGE_YCBCR_CONVERSION_CHROMA_RECONSTRUCTION_EXPLICIT_BIT_KHR specifies that reconstruction is explicit, as described in https://www.khronos.org/registry/vulkan/specs/1.2-extensions/html/vkspec.html#textures-chroma-reconstruction. If this bit is not present, reconstruction is implicit by default.
• FORMAT_FEATURE_2_SAMPLED_IMAGE_YCBCR_CONVERSION_CHROMA_RECONSTRUCTION_EXPLICIT_FORCEABLE_BIT_KHR specifies that reconstruction can be forcibly made explicit by setting SamplerYcbcrConversionCreateInfo::forceExplicitReconstruction to TRUE. If the format being queried supports FORMAT_FEATURE_2_SAMPLED_IMAGE_YCBCR_CONVERSION_CHROMA_RECONSTRUCTION_EXPLICIT_BIT_KHR it must also support FORMAT_FEATURE_2_SAMPLED_IMAGE_YCBCR_CONVERSION_CHROMA_RECONSTRUCTION_EXPLICIT_FORCEABLE_BIT_KHR.
• FORMAT_FEATURE_2_DISJOINT_BIT_KHR specifies that a multi-planar image can have the IMAGE_CREATE_DISJOINT_BIT set during image creation. An implementation must not set FORMAT_FEATURE_2_DISJOINT_BIT_KHR for single-plane formats.
• FORMAT_FEATURE_2_FRAGMENT_DENSITY_MAP_BIT_EXT specifies that an image view can be used as a fragment density map attachment.
• FORMAT_FEATURE_2_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR specifies that an image view can be used as a fragment shading rate attachment. An implementation must not set this feature for formats with numeric type other than *UINT, or set it as a buffer feature.
• FORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT_KHR specifies that image views created with this format can be used as storage images for read operations without specifying a format.
• FORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT_KHR specifies that image views created with this format can be used as storage images for write operations without specifying a format.
• FORMAT_FEATURE_2_SAMPLED_IMAGE_DEPTH_COMPARISON_BIT_KHR specifies that image views created with this format can be used for depth comparison performed by OpImage*Dref instructions.

The following bits may be set in bufferFeatures, specifying that the features are supported by buffers or buffer views created with the queried getPhysicalDeviceFormatProperties2::format:

• FORMAT_FEATURE_2_UNIFORM_TEXEL_BUFFER_BIT_KHR specifies that the format can be used to create a buffer view that can be bound to a DESCRIPTOR_TYPE_UNIFORM_TEXEL_BUFFER descriptor.
• FORMAT_FEATURE_2_STORAGE_TEXEL_BUFFER_BIT_KHR specifies that the format can be used to create a buffer view that can be bound to a DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER descriptor.
• FORMAT_FEATURE_2_STORAGE_TEXEL_BUFFER_ATOMIC_BIT_KHR specifies that atomic operations are supported on DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER with this format.
• FORMAT_FEATURE_2_VERTEX_BUFFER_BIT_KHR specifies that the format can be used as a vertex attribute format (VertexInputAttributeDescription::format).
• FORMAT_FEATURE_2_ACCELERATION_STRUCTURE_VERTEX_BUFFER_BIT_KHR specifies that the format can be used as the vertex format when creating an acceleration structure (AccelerationStructureGeometryTrianglesDataKHR::vertexFormat). This format can also be used as the vertex format in host memory when doing host acceleration structure builds.

See Also

VK_KHR_format_feature_flags2

Constructors

FormatFeatureFlagBits2KHR Flags64

Bundled Patterns

pattern FORMAT_FEATURE_2_SAMPLED_IMAGE_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_SAMPLED_IMAGE_BIT_KHR specifies that an image view can be sampled from.

pattern FORMAT_FEATURE_2_STORAGE_IMAGE_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_STORAGE_IMAGE_BIT_KHR specifies that an image view can be used as a storage image.

pattern FORMAT_FEATURE_2_STORAGE_IMAGE_ATOMIC_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_STORAGE_IMAGE_ATOMIC_BIT_KHR specifies that an image view can be used as storage image that supports atomic operations.

pattern FORMAT_FEATURE_2_UNIFORM_TEXEL_BUFFER_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_UNIFORM_TEXEL_BUFFER_BIT_KHR specifies that the format can be used to create a buffer view that can be bound to a DESCRIPTOR_TYPE_UNIFORM_TEXEL_BUFFER descriptor.

pattern FORMAT_FEATURE_2_STORAGE_TEXEL_BUFFER_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_STORAGE_TEXEL_BUFFER_BIT_KHR specifies that the format can be used to create a buffer view that can be bound to a DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER descriptor.

pattern FORMAT_FEATURE_2_STORAGE_TEXEL_BUFFER_ATOMIC_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_STORAGE_TEXEL_BUFFER_ATOMIC_BIT_KHR specifies that atomic operations are supported on DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER with this format.

pattern FORMAT_FEATURE_2_VERTEX_BUFFER_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_VERTEX_BUFFER_BIT_KHR specifies that the format can be used as a vertex attribute format (VertexInputAttributeDescription::format).

pattern FORMAT_FEATURE_2_COLOR_ATTACHMENT_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_COLOR_ATTACHMENT_BIT_KHR specifies that an image view can be used as a framebuffer color attachment and as an input attachment.

pattern FORMAT_FEATURE_2_COLOR_ATTACHMENT_BLEND_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_COLOR_ATTACHMENT_BLEND_BIT_KHR specifies that an image view can be used as a framebuffer color attachment that supports blending and as an input attachment.

pattern FORMAT_FEATURE_2_DEPTH_STENCIL_ATTACHMENT_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_DEPTH_STENCIL_ATTACHMENT_BIT_KHR specifies that an image view can be used as a framebuffer depth/stencil attachment and as an input attachment.

pattern FORMAT_FEATURE_2_BLIT_SRC_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_BLIT_SRC_BIT_KHR specifies that an image can be used as srcImage for the cmdBlitImage2KHR and cmdBlitImage commands.

pattern FORMAT_FEATURE_2_BLIT_DST_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_BLIT_DST_BIT_KHR specifies that an image can be used as dstImage for the cmdBlitImage2KHR and cmdBlitImage commands.

pattern FORMAT_FEATURE_2_SAMPLED_IMAGE_FILTER_LINEAR_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_SAMPLED_IMAGE_FILTER_LINEAR_BIT_KHR specifies that if FORMAT_FEATURE_2_SAMPLED_IMAGE_BIT_KHR is also set, an image view can be used with a sampler that has either of magFilter or minFilter set to FILTER_LINEAR, or mipmapMode set to SAMPLER_MIPMAP_MODE_LINEAR. If FORMAT_FEATURE_2_BLIT_SRC_BIT_KHR is also set, an image can be used as the srcImage to cmdBlitImage2KHR and cmdBlitImage with a filter of FILTER_LINEAR. This bit must only be exposed for formats that also support the FORMAT_FEATURE_2_SAMPLED_IMAGE_BIT_KHR or FORMAT_FEATURE_2_BLIT_SRC_BIT_KHR.

If the format being queried is a depth/stencil format, this bit only specifies that the depth aspect (not the stencil aspect) of an image of this format supports linear filtering. Where depth comparison is supported it may be linear filtered whether this bit is present or not, but where this bit is not present the filtered value may be computed in an implementation-dependent manner which differs from the normal rules of linear filtering. The resulting value must be in the range [0,1] and should be proportional to, or a weighted average of, the number of comparison passes or failures.

pattern FORMAT_FEATURE_2_SAMPLED_IMAGE_FILTER_CUBIC_BIT_EXT :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_SAMPLED_IMAGE_FILTER_CUBIC_BIT_EXT specifies that Image can be used with a sampler that has either of magFilter or minFilter set to FILTER_CUBIC_EXT, or be the source image for a blit with filter set to FILTER_CUBIC_EXT. This bit must only be exposed for formats that also support the FORMAT_FEATURE_2_SAMPLED_IMAGE_BIT_KHR. If the format being queried is a depth/stencil format, this only specifies that the depth aspect is cubic filterable.

pattern FORMAT_FEATURE_2_TRANSFER_SRC_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_TRANSFER_SRC_BIT_KHR specifies that an image can be used as a source image for copy commands.

pattern FORMAT_FEATURE_2_TRANSFER_DST_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_TRANSFER_DST_BIT_KHR specifies that an image can be used as a destination image for copy commands and clear commands.

pattern FORMAT_FEATURE_2_SAMPLED_IMAGE_FILTER_MINMAX_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_SAMPLED_IMAGE_FILTER_MINMAX_BIT_KHR specifies Image can be used as a sampled image with a min or max SamplerReductionMode. This bit must only be exposed for formats that also support the FORMAT_FEATURE_2_SAMPLED_IMAGE_BIT_KHR.

pattern FORMAT_FEATURE_2_MIDPOINT_CHROMA_SAMPLES_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_MIDPOINT_CHROMA_SAMPLES_BIT_KHR specifies that an application can define a sampler Y′CBCR conversion using this format as a source, and that an image of this format can be used with a SamplerYcbcrConversionCreateInfo xChromaOffset and/or yChromaOffset of CHROMA_LOCATION_MIDPOINT. Otherwise both xChromaOffset and yChromaOffset must be CHROMA_LOCATION_COSITED_EVEN. If a format does not incorporate chroma downsampling (it is not a “422” or “420” format) but the implementation supports sampler Y′CBCR conversion for this format, the implementation must set FORMAT_FEATURE_2_MIDPOINT_CHROMA_SAMPLES_BIT_KHR.

pattern FORMAT_FEATURE_2_SAMPLED_IMAGE_YCBCR_CONVERSION_LINEAR_FILTER_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_SAMPLED_IMAGE_YCBCR_CONVERSION_LINEAR_FILTER_BIT_KHR specifies that an application can define a sampler Y′CBCR conversion using this format as a source with chromaFilter set to FILTER_LINEAR.

pattern FORMAT_FEATURE_2_SAMPLED_IMAGE_YCBCR_CONVERSION_SEPARATE_RECONSTRUCTION_FILTER_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_SAMPLED_IMAGE_YCBCR_CONVERSION_SEPARATE_RECONSTRUCTION_FILTER_BIT_KHR specifies that the format can have different chroma, min, and mag filters.

pattern FORMAT_FEATURE_2_SAMPLED_IMAGE_YCBCR_CONVERSION_CHROMA_RECONSTRUCTION_EXPLICIT_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_SAMPLED_IMAGE_YCBCR_CONVERSION_CHROMA_RECONSTRUCTION_EXPLICIT_BIT_KHR specifies that reconstruction is explicit, as described in https://www.khronos.org/registry/vulkan/specs/1.2-extensions/html/vkspec.html#textures-chroma-reconstruction. If this bit is not present, reconstruction is implicit by default.

pattern FORMAT_FEATURE_2_SAMPLED_IMAGE_YCBCR_CONVERSION_CHROMA_RECONSTRUCTION_EXPLICIT_FORCEABLE_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_SAMPLED_IMAGE_YCBCR_CONVERSION_CHROMA_RECONSTRUCTION_EXPLICIT_FORCEABLE_BIT_KHR specifies that reconstruction can be forcibly made explicit by setting SamplerYcbcrConversionCreateInfo::forceExplicitReconstruction to TRUE. If the format being queried supports FORMAT_FEATURE_2_SAMPLED_IMAGE_YCBCR_CONVERSION_CHROMA_RECONSTRUCTION_EXPLICIT_BIT_KHR it must also support FORMAT_FEATURE_2_SAMPLED_IMAGE_YCBCR_CONVERSION_CHROMA_RECONSTRUCTION_EXPLICIT_FORCEABLE_BIT_KHR.

pattern FORMAT_FEATURE_2_DISJOINT_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_DISJOINT_BIT_KHR specifies that a multi-planar image can have the IMAGE_CREATE_DISJOINT_BIT set during image creation. An implementation must not set FORMAT_FEATURE_2_DISJOINT_BIT_KHR for single-plane formats.

pattern FORMAT_FEATURE_2_COSITED_CHROMA_SAMPLES_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_COSITED_CHROMA_SAMPLES_BIT_KHR specifies that an application can define a sampler Y′CBCR conversion using this format as a source, and that an image of this format can be used with a SamplerYcbcrConversionCreateInfo xChromaOffset and/or yChromaOffset of CHROMA_LOCATION_COSITED_EVEN. Otherwise both xChromaOffset and yChromaOffset must be CHROMA_LOCATION_MIDPOINT. If neither FORMAT_FEATURE_2_COSITED_CHROMA_SAMPLES_BIT_KHR nor FORMAT_FEATURE_2_MIDPOINT_CHROMA_SAMPLES_BIT_KHR is set, the application must not define a sampler Y′CBCR conversion using this format as a source.

pattern FORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT_KHR specifies that image views created with this format can be used as storage images for read operations without specifying a format.

pattern FORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT_KHR specifies that image views created with this format can be used as storage images for write operations without specifying a format.

pattern FORMAT_FEATURE_2_SAMPLED_IMAGE_DEPTH_COMPARISON_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_SAMPLED_IMAGE_DEPTH_COMPARISON_BIT_KHR specifies that image views created with this format can be used for depth comparison performed by OpImage*Dref instructions.

pattern FORMAT_FEATURE_2_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR specifies that an image view can be used as a fragment shading rate attachment. An implementation must not set this feature for formats with numeric type other than *UINT, or set it as a buffer feature.

pattern FORMAT_FEATURE_2_FRAGMENT_DENSITY_MAP_BIT_EXT :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_FRAGMENT_DENSITY_MAP_BIT_EXT specifies that an image view can be used as a fragment density map attachment.

pattern FORMAT_FEATURE_2_ACCELERATION_STRUCTURE_VERTEX_BUFFER_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_ACCELERATION_STRUCTURE_VERTEX_BUFFER_BIT_KHR specifies that the format can be used as the vertex format when creating an acceleration structure (AccelerationStructureGeometryTrianglesDataKHR::vertexFormat). This format can also be used as the vertex format in host memory when doing host acceleration structure builds.

Instances

Eq FormatFeatureFlagBits2KHR

Defined in Vulkan.Extensions.VK_KHR_acceleration_structure

Methods

(==) :: FormatFeatureFlagBits2KHR -> FormatFeatureFlagBits2KHR -> Bool

(/=) :: FormatFeatureFlagBits2KHR -> FormatFeatureFlagBits2KHR -> Bool

Ord FormatFeatureFlagBits2KHR

Defined in Vulkan.Extensions.VK_KHR_acceleration_structure

Methods

compare :: FormatFeatureFlagBits2KHR -> FormatFeatureFlagBits2KHR -> Ordering

(<) :: FormatFeatureFlagBits2KHR -> FormatFeatureFlagBits2KHR -> Bool

(<=) :: FormatFeatureFlagBits2KHR -> FormatFeatureFlagBits2KHR -> Bool

(>) :: FormatFeatureFlagBits2KHR -> FormatFeatureFlagBits2KHR -> Bool

(>=) :: FormatFeatureFlagBits2KHR -> FormatFeatureFlagBits2KHR -> Bool

max :: FormatFeatureFlagBits2KHR -> FormatFeatureFlagBits2KHR -> FormatFeatureFlagBits2KHR

min :: FormatFeatureFlagBits2KHR -> FormatFeatureFlagBits2KHR -> FormatFeatureFlagBits2KHR

Read FormatFeatureFlagBits2KHR

Defined in Vulkan.Extensions.VK_KHR_acceleration_structure

Methods

readsPrec :: Int -> ReadS FormatFeatureFlagBits2KHR

readList :: ReadS [FormatFeatureFlagBits2KHR]

readPrec :: ReadPrec FormatFeatureFlagBits2KHR

readListPrec :: ReadPrec [FormatFeatureFlagBits2KHR]

Show FormatFeatureFlagBits2KHR

Defined in Vulkan.Extensions.VK_KHR_acceleration_structure

Methods

showsPrec :: Int -> FormatFeatureFlagBits2KHR -> ShowS

show :: FormatFeatureFlagBits2KHR -> String

showList :: [FormatFeatureFlagBits2KHR] -> ShowS

Storable FormatFeatureFlagBits2KHR

Defined in Vulkan.Extensions.VK_KHR_acceleration_structure

Methods

sizeOf :: FormatFeatureFlagBits2KHR -> Int

alignment :: FormatFeatureFlagBits2KHR -> Int

peekElemOff :: Ptr FormatFeatureFlagBits2KHR -> Int -> IO FormatFeatureFlagBits2KHR

pokeElemOff :: Ptr FormatFeatureFlagBits2KHR -> Int -> FormatFeatureFlagBits2KHR -> IO ()

peekByteOff :: Ptr b -> Int -> IO FormatFeatureFlagBits2KHR

pokeByteOff :: Ptr b -> Int -> FormatFeatureFlagBits2KHR -> IO ()

peek :: Ptr FormatFeatureFlagBits2KHR -> IO FormatFeatureFlagBits2KHR

poke :: Ptr FormatFeatureFlagBits2KHR -> FormatFeatureFlagBits2KHR -> IO ()

Bits FormatFeatureFlagBits2KHR

Defined in Vulkan.Extensions.VK_KHR_acceleration_structure

Methods

(.&.) :: FormatFeatureFlagBits2KHR -> FormatFeatureFlagBits2KHR -> FormatFeatureFlagBits2KHR

(.|.) :: FormatFeatureFlagBits2KHR -> FormatFeatureFlagBits2KHR -> FormatFeatureFlagBits2KHR

xor :: FormatFeatureFlagBits2KHR -> FormatFeatureFlagBits2KHR -> FormatFeatureFlagBits2KHR

complement :: FormatFeatureFlagBits2KHR -> FormatFeatureFlagBits2KHR

shift :: FormatFeatureFlagBits2KHR -> Int -> FormatFeatureFlagBits2KHR

rotate :: FormatFeatureFlagBits2KHR -> Int -> FormatFeatureFlagBits2KHR

zeroBits :: FormatFeatureFlagBits2KHR

bit :: Int -> FormatFeatureFlagBits2KHR

setBit :: FormatFeatureFlagBits2KHR -> Int -> FormatFeatureFlagBits2KHR

clearBit :: FormatFeatureFlagBits2KHR -> Int -> FormatFeatureFlagBits2KHR

complementBit :: FormatFeatureFlagBits2KHR -> Int -> FormatFeatureFlagBits2KHR

testBit :: FormatFeatureFlagBits2KHR -> Int -> Bool

bitSizeMaybe :: FormatFeatureFlagBits2KHR -> Maybe Int

bitSize :: FormatFeatureFlagBits2KHR -> Int

isSigned :: FormatFeatureFlagBits2KHR -> Bool

shiftL :: FormatFeatureFlagBits2KHR -> Int -> FormatFeatureFlagBits2KHR

unsafeShiftL :: FormatFeatureFlagBits2KHR -> Int -> FormatFeatureFlagBits2KHR

shiftR :: FormatFeatureFlagBits2KHR -> Int -> FormatFeatureFlagBits2KHR

unsafeShiftR :: FormatFeatureFlagBits2KHR -> Int -> FormatFeatureFlagBits2KHR

rotateL :: FormatFeatureFlagBits2KHR -> Int -> FormatFeatureFlagBits2KHR

rotateR :: FormatFeatureFlagBits2KHR -> Int -> FormatFeatureFlagBits2KHR

popCount :: FormatFeatureFlagBits2KHR -> Int

FiniteBits FormatFeatureFlagBits2KHR

Defined in Vulkan.Extensions.VK_KHR_acceleration_structure

Methods

finiteBitSize :: FormatFeatureFlagBits2KHR -> Int

countLeadingZeros :: FormatFeatureFlagBits2KHR -> Int

countTrailingZeros :: FormatFeatureFlagBits2KHR -> Int

Zero FormatFeatureFlagBits2KHR

Defined in Vulkan.Extensions.VK_KHR_acceleration_structure

Methods

zero :: FormatFeatureFlagBits2KHR

type FormatFeatureFlags2KHR = FormatFeatureFlagBits2KHR

type Flags64 = Word64