Package org.lwjgl.vulkan

Class VALVEMutableDescriptorType

java.lang.Object

org.lwjgl.vulkan.VALVEMutableDescriptorType

public final class VALVEMutableDescriptorType
extends java.lang.Object

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.

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

• D3D support

Contact

• Joshua Ashton Joshua-Ashton
• Hans-Kristian Arntzen HansKristian-Work

Other Extension Metadata

Last Modified Date

2020-12-02

IP Status

No known IP claims.

Contributors

• Joshua Ashton, Valve
• Hans-Kristian Arntzen, Valve

Field Summary

Fields

Modifier and Type	Field	Description
static int	VK_DESCRIPTOR_POOL_CREATE_HOST_ONLY_BIT_VALVE	Extends VkDescriptorPoolCreateFlagBits.
static int	VK_DESCRIPTOR_SET_LAYOUT_CREATE_HOST_ONLY_POOL_BIT_VALVE	Extends VkDescriptorSetLayoutCreateFlagBits.
static int	VK_DESCRIPTOR_TYPE_MUTABLE_VALVE	Extends VkDescriptorType.
static int	VK_STRUCTURE_TYPE_MUTABLE_DESCRIPTOR_TYPE_CREATE_INFO_VALVE VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MUTABLE_DESCRIPTOR_TYPE_FEATURES_VALVE	Extends VkStructureType.
static java.lang.String	VK_VALVE_MUTABLE_DESCRIPTOR_TYPE_EXTENSION_NAME	The extension name.
static int	VK_VALVE_MUTABLE_DESCRIPTOR_TYPE_SPEC_VERSION	The extension specification version.

Method Summary

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

VK_VALVE_MUTABLE_DESCRIPTOR_TYPE_SPEC_VERSION

The extension specification version.

VK_VALVE_MUTABLE_DESCRIPTOR_TYPE_EXTENSION_NAME

The extension name.

VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MUTABLE_DESCRIPTOR_TYPE_FEATURES_VALVE, VK_STRUCTURE_TYPE_MUTABLE_DESCRIPTOR_TYPE_CREATE_INFO_VALVE

Extends VkStructureType.

Enum values:

• STRUCTURE_TYPE_PHYSICAL_DEVICE_MUTABLE_DESCRIPTOR_TYPE_FEATURES_VALVE
• STRUCTURE_TYPE_MUTABLE_DESCRIPTOR_TYPE_CREATE_INFO_VALVE

VK_DESCRIPTOR_TYPE_MUTABLE_VALVE

Extends VkDescriptorType.

VK_DESCRIPTOR_POOL_CREATE_HOST_ONLY_BIT_VALVE

Extends VkDescriptorPoolCreateFlagBits.

VK_DESCRIPTOR_SET_LAYOUT_CREATE_HOST_ONLY_POOL_BIT_VALVE

Extends VkDescriptorSetLayoutCreateFlagBits.