vulkan-3.8.1: Bindings to the Vulkan graphics API.
Safe HaskellNone
LanguageHaskell2010

Vulkan.Extensions.VK_VALVE_mutable_descriptor_type

Description

Name

VK_VALVE_mutable_descriptor_type - device extension

VK_VALVE_mutable_descriptor_type

Name String
VK_VALVE_mutable_descriptor_type
Extension Type
Device extension
Registered Extension Number
352
Revision
1
Extension and Version Dependencies
  • Requires Vulkan 1.0
  • Requires VK_KHR_maintenance3
Special Use
Contact

Other Extension Metadata

Last Modified Date
2020-12-02
IP Status
No known IP claims.
Contributors
  • Joshua Ashton, Valve
  • Hans-Kristian Arntzen, Valve

Description

This extension allows applications to reduce descriptor memory footprint by allowing a descriptor to be able to mutate to a given list of descriptor types depending on which descriptor types are written into, or copied into a descriptor set.

The main use case this extension intends to address is descriptor indexing with DESCRIPTOR_BINDING_VARIABLE_DESCRIPTOR_COUNT_BIT where the descriptor types are completely generic, as this means applications can allocate one large descriptor set, rather than having one large descriptor set per descriptor type, which significantly bloats descriptor memory usage and causes performance issues.

This extension also adds a mechanism to declare that a descriptor pool, and therefore the descriptor sets that are allocated from it, reside only in host memory; as such these descriptors can only be updated/copied, but not bound.

These features together allow much more efficient emulation of the raw D3D12 binding model. This extension is primarily intended to be useful for API layering efforts.

New Structures

New Enum Constants

Version History

  • Revision 1, 2020-12-01 (Joshua Ashton, Hans-Kristian Arntzen)

    • Initial specification, squashed from public draft.

See Also

MutableDescriptorTypeCreateInfoVALVE, MutableDescriptorTypeListVALVE, PhysicalDeviceMutableDescriptorTypeFeaturesVALVE

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

data PhysicalDeviceMutableDescriptorTypeFeaturesVALVE Source #

VkPhysicalDeviceMutableDescriptorTypeFeaturesVALVE - Structure describing whether the mutable descriptor type is supported

Members

The members of the PhysicalDeviceMutableDescriptorTypeFeaturesVALVE structure describe the following features:

Description

Valid Usage (Implicit)

See Also

Bool32, StructureType

Instances

Instances details
Eq PhysicalDeviceMutableDescriptorTypeFeaturesVALVE Source # 
Instance details

Defined in Vulkan.Extensions.VK_VALVE_mutable_descriptor_type

Show PhysicalDeviceMutableDescriptorTypeFeaturesVALVE Source # 
Instance details

Defined in Vulkan.Extensions.VK_VALVE_mutable_descriptor_type

Storable PhysicalDeviceMutableDescriptorTypeFeaturesVALVE Source # 
Instance details

Defined in Vulkan.Extensions.VK_VALVE_mutable_descriptor_type

FromCStruct PhysicalDeviceMutableDescriptorTypeFeaturesVALVE Source # 
Instance details

Defined in Vulkan.Extensions.VK_VALVE_mutable_descriptor_type

ToCStruct PhysicalDeviceMutableDescriptorTypeFeaturesVALVE Source # 
Instance details

Defined in Vulkan.Extensions.VK_VALVE_mutable_descriptor_type

Zero PhysicalDeviceMutableDescriptorTypeFeaturesVALVE Source # 
Instance details

Defined in Vulkan.Extensions.VK_VALVE_mutable_descriptor_type

data MutableDescriptorTypeListVALVE Source #

VkMutableDescriptorTypeListVALVE - Structure describing descriptor types that a given descriptor may mutate to

Valid Usage

Valid Usage (Implicit)

  • If descriptorTypeCount is not 0, pDescriptorTypes must be a valid pointer to an array of descriptorTypeCount valid DescriptorType values

See Also

DescriptorType, MutableDescriptorTypeCreateInfoVALVE

Constructors

MutableDescriptorTypeListVALVE 

Fields

data MutableDescriptorTypeCreateInfoVALVE Source #

VkMutableDescriptorTypeCreateInfoVALVE - Structure describing the list of possible active descriptor types for mutable type descriptors

Description

If mutableDescriptorTypeListCount is zero or if this structure is not included in the pNext chain, the MutableDescriptorTypeListVALVE for each element is considered to be zero or NULL for each member. Otherwise, the descriptor set layout binding at DescriptorSetLayoutCreateInfo::pBindings[i] uses the descriptor type lists in MutableDescriptorTypeCreateInfoVALVE::pMutableDescriptorTypeLists[i].

Valid Usage (Implicit)

  • If mutableDescriptorTypeListCount is not 0, pMutableDescriptorTypeLists must be a valid pointer to an array of mutableDescriptorTypeListCount valid MutableDescriptorTypeListVALVE structures

See Also

MutableDescriptorTypeListVALVE, StructureType

Constructors

MutableDescriptorTypeCreateInfoVALVE 

Fields

type VALVE_MUTABLE_DESCRIPTOR_TYPE_EXTENSION_NAME = "VK_VALVE_mutable_descriptor_type" Source #