LWJGL 3.3.3 · org.lwjgl.util.vma

Contains bindings to VMA, an easy to integrate Vulkan memory allocation library.

Problem

Memory allocation and resource (buffer and image) creation in Vulkan is difficult (comparing to older graphics API-s, like D3D11 or OpenGL) for several reasons:

It requires a lot of boilerplate code, just like everything else in Vulkan, because it is a low-level and high-performance API.
There is additional level of indirection: VkDeviceMemory is allocated separately from creating VkBuffer/VkImage and they must be bound together. The binding cannot be changed later - resource must be recreated.
Driver must be queried for supported memory heaps and memory types. Different IHVs provide different types of it.
It is recommended practice to allocate bigger chunks of memory and assign parts of them to particular resources.

Features

This library can help game developers to manage memory allocations and resource creation by offering some higher-level functions. Features of the library are divided into several layers, low level to high level:

Functions that help to choose correct and optimal memory type based on intended usage of the memory.
- Required or preferred traits of the memory are expressed using higher-level description comparing to Vulkan flags.
Functions that allocate memory blocks, reserve and return parts of them (`VkDeviceMemory` + offset + size) to the user.
- Library keeps track of allocated memory blocks, used and unused ranges inside them, finds best matching unused ranges for new allocations, takes all the rules of alignment and buffer/image granularity into consideration.
Functions that can create an image/buffer, allocate memory for it and bind them together - all in one call.

Additional features:

Thread-safety: Library is designed to be used by multithreaded code.
Configuration: Fill optional members of CreateInfo structure to provide custom CPU memory allocator and other parameters.
Customization: Predefine appropriate macros to provide your own implementation of all external facilities used by the library, from assert, mutex, and atomic, to vector and linked list.
Support memory mapping, reference-counted internally. Support for persistently mapped memory: Just allocate with appropriate flag and you get access to mapped pointer.
Custom memory pools: Create a pool with desired parameters (e.g. fixed or limited maximum size) and allocate memory out of it.
Support for VK_KHR_dedicated_allocation extension: Enable it and it will be used automatically by the library.
Defragmentation: Call one function and let the library move data around to free some memory blocks and make your allocations better compacted.
Lost allocations: Allocate memory with appropriate flags and let the library remove allocations that are not used for many frames to make room for new ones.
Statistics: Obtain detailed statistics about the amount of memory used, unused, number of allocated blocks, number of allocations etc. - globally, per memory heap, and per memory type.
Debug annotations: Associate string with name or opaque pointer to your own data with every allocation.
JSON dump: Obtain a string in JSON format with detailed map of internal state, including list of allocations and gaps between them.

Modifier and Type	Interface and Description
public interface	VmaAllocateDeviceMemoryFunctionI Instances of this interface may be set to the `VmaDeviceMemoryCallbacks` struct.
public interface	VmaCheckDefragmentationBreakFunctionI Instances of this interface may be set to the `VmaDefragmentationInfo` struct.
public interface	VmaFreeDeviceMemoryFunctionI Instances of this interface may be set to the `VmaDeviceMemoryCallbacks` struct.

Class Summary

Modifier and Type	Class and Description
pack-priv class	LibVma Initializes the vma shared library.
public class	Vma The Vulkan Memory Allocator.
public abstract class	VmaAllocateDeviceMemoryFunction Instances of this class may be set to the `VmaDeviceMemoryCallbacks` struct.
public class	VmaAllocationCreateInfo Parameters of new `VmaAllocation`.
public class	VmaAllocationInfo Parameters of `VmaAllocation` objects, that can be retrieved using function `GetAllocationInfo`.
public class	VmaAllocatorCreateInfo Description of an Allocator to be created.
public class	VmaAllocatorInfo Information about existing `VmaAllocator` object.
public class	VmaBudget Statistics of current memory usage and available budget for a specific memory heap.
public abstract class	VmaCheckDefragmentationBreakFunction Instances of this class may be set to the `VmaDefragmentationInfo` struct.
public class	VmaDefragmentationInfo Parameters for defragmentation.
public class	VmaDefragmentationMove Single move of an allocation to be done for defragmentation.
public class	VmaDefragmentationPassMoveInfo Parameters for incremental defragmentation steps.
public class	VmaDefragmentationStats Statistics returned for defragmentation process in function `EndDefragmentation`.
public class	VmaDetailedStatistics More detailed statistics than `VmaStatistics`.
public class	VmaDeviceMemoryCallbacks Set of callbacks that the library will call for `vkAllocateMemory` and `vkFreeMemory`.
public abstract class	VmaFreeDeviceMemoryFunction Instances of this class may be set to the `VmaDeviceMemoryCallbacks` struct.
public class	VmaPoolCreateInfo Describes parameter of created `VmaPool`.
public class	VmaStatistics Calculated statistics of memory usage e.g. in a specific memory type, heap, custom pool, or total.
public class	VmaTotalStatistics General statistics from current state of the Allocator - total memory usage across all memory heaps and types.
public class	VmaVirtualAllocationCreateInfo Parameters of created virtual allocation to be passed to `VirtualAllocate`.
public class	VmaVirtualAllocationInfo Parameters of an existing virtual allocation, returned by `GetVirtualAllocationInfo`.
public class	VmaVirtualBlockCreateInfo Parameters of created `VmaVirtualBlock` object to be passed to `CreateVirtualBlock`.
public class	VmaVulkanFunctions Pointers to some Vulkan functions - a subset used by the library.

Package org.lwjgl.util.vma

Problem

Features

Interface Summary

Class Summary