mirror/VulkanMemoryAllocator
1
0
Fork 0
mirror of https://github.com/GPUOpen-LibrariesAndSDKs/VulkanMemoryAllocator.git synced 2024-11-22 15:04:34 +00:00
Code Issues Packages Projects Releases Wiki Activity
fd4ee1d5aa
VulkanMemoryAllocator/tools/VmaDumpVis
History
Adam Sawicki f451b94158 Fixed vmaBuildVirtualBlockStatsString, vmaFreeVirtualBlockStatsString to also be inside #if VMA_STATS_STRING_ENABLED 
Updated copyright headers for to year 2022.

Change by @medranSolus
2022-01-21 12:56:18 +01:00
..
README_files VmaDumpVis: Improved coloring based on new Usage parameter dumped in JSON. 2018-05-18 17:46:19 +02:00
README.md Standardized line endings to LF 2021-09-30 12:03:35 +02:00
Sample.json Standardized line endings to LF 2021-09-30 12:03:35 +02:00
VmaDumpVis.py Fixed vmaBuildVirtualBlockStatsString, vmaFreeVirtualBlockStatsString to also be inside #if VMA_STATS_STRING_ENABLED 2022-01-21 12:56:18 +01:00

README.md

VMA Dump Vis

Vulkan Memory Allocator Dump Visualization. It is an auxiliary tool that can visualize internal state of Vulkan Memory Allocator library on a picture. It is a Python script that must be launched from command line with appropriate parameters.

Requirements

  • Python 3 installed
  • Pillow - Python Imaging Library (Fork) installed

Usage

python VmaDumpVis.py -o OUTPUT_FILE INPUT_FILE
  • INPUT_FILE - path to source file to be read, containing dump of internal state of the VMA library in JSON format (encoding: UTF-8), generated using vmaBuildStatsString() function.
  • OUTPUT_FILE - path to destination file to be written that will contain generated image. Image format is automatically recognized based on file extension. List of supported formats can be found here and includes: BMP, GIF, JPEG, PNG, TGA.

You can also use typical options:

  • -h - to see help on command line syntax
  • -v - to see program version number

Example output

Example output

Legend

  • Free space Light gray without border - a space in Vulkan device memory block unused by any allocation.
  • Buffer 1 Buffer with usage containing INDIRECT_BUFFER, VERTEX_BUFFER, or INDEX_BUFFER.
  • Buffer 2 Buffer with usage containing STORAGE_BUFFER or STORAGE_TEXEL_BUFFER.
  • Buffer 3 Buffer with usage containing UNIFORM_BUFFER or UNIFORM_TEXEL_BUFFER.
  • Buffer 4 Other buffer.
  • Image 1 Image with OPTIMAL tiling and usage containing DEPTH_STENCIL_ATTACHMENT.
  • Image 2 Image with OPTIMAL tiling and usage containing INPUT_ATTACHMENT, TRANSIENT_ATTACHMENT, or COLOR_ATTACHMENT.
  • Image 3 Image with OPTIMAL tiling and usage containing SAMPLED.
  • Image 4 Other image with OPTIMAL tiling.
  • Image Linear Image with LINEAR tiling.
  • Image Unknown Image with tiling unknown to the allocator.
  • Unknown Allocation of unknown type.
  • Details Black bar - one or more allocations of any kind too small to be visualized as filled rectangles.