Skip to content

Latest commit

 

History

History
93 lines (63 loc) · 7.53 KB

development_tools.adoc

File metadata and controls

93 lines (63 loc) · 7.53 KB
Raw

Development Tools

The Vulkan ecosystem consists of many tools for development. This is not a full list and this is offered as a good starting point for many developers. Please continue to do your own research and search for other tools as the development ecosystem is much larger than what can reasonably fit on a single Markdown page.

Khronos hosts Vulkan Samples, a collection of code and tutorials that demonstrates API usage and explains the implementation of performance best practices.

LunarG is privately sponsored to develop and maintain Vulkan ecosystem components and is currently the curator for the Vulkan Loader and Vulkan Validation Layers Khronos Group repositories. In addition, LunarG delivers the Vulkan SDK and develops other key tools such as the Vulkan Configurator and GFXReconstruct.

Vulkan Layers

Layers are optional components that augment the Vulkan system. They can intercept, evaluate, and modify existing Vulkan functions on their way from the application down to the hardware. Layers are implemented as libraries that can be enabled and configured using Vulkan Configurator.

Khronos Layers

  • VK_LAYER_KHRONOS_validation, the Khronos Validation Layer. It is every developer’s first layer of defense when debugging their Vulkan application and this is the reason it is at the top of this list. Read the Validation Overview chapter for more details. The validation layer included multiple features:

    • Synchronization Validation: Identify resource access conflicts due to missing or incorrect synchronization operations between actions (Draw, Copy, Dispatch, Blit) reading or writing the same regions of memory.

    • GPU-Assisted Validation: Instrument shader code to perform run-time checks for error conditions produced during shader execution.

    • Shader printf: Debug shader code by “printing” any values of interest to the debug callback or stdout.

    • Best Practices Warnings: Highlights potential performance issues, questionable usage patterns, common mistakes.

Vulkan SDK layers

Besides the Khronos Layers, the Vulkan SDK included additional useful platform independent layers.

  • VK_LAYER_LUNARG_api_dump, a layer to log Vulkan API calls. The API dump layer prints API calls, parameters, and values to the identified output stream.

  • VK_LAYER_LUNARG_gfxreconstruct, a layer for capturing frames created with Vulkan. This layer is a part of GFXReconstruct, a software for capturing and replaying Vulkan API calls. Full Android support is also available at https://github.com/LunarG/gfxreconstruct

  • VK_LAYER_LUNARG_device_simulation, a layer to test Vulkan applications portability. The device simulation layer can be used to test whether a Vulkan application would run on a Vulkan device with lower capabilities.

  • VK_LAYER_LUNARG_screenshot, a screenshot layer. Captures the rendered image of a Vulkan application to a viewable image.

  • VK_LAYER_LUNARG_monitor, a framerate monitor layer. Display the Vulkan application FPS in the window title bar to give a hint about the performance.

Vulkan Extension Layer

The Vulkan Extension Layer is a collection of layers that implement extensions that are not available everywhere. By default, these layers will disable themselves if the underlying driver provides the extension.

Vulkan Third-party layers

There are also other publicly available layers that can be used to help in development.

  • VK_LAYER_IMG_powervr_perf_doc, the PowerVR PerfDoc layer. Checks Vulkan applications for best practices on Imagination Technologies PowerVR devices.

  • VK_LAYER_adreno, the Vulkan Adreno Layer. Checks Vulkan applications for best practices on Qualcomm Adreno devices.

Debugging

Debugging something running on a GPU can be incredibly hard, luckily there are tools out there to help.

The following tools help debug crashes.

Profiling

With anything related to a GPU it is best to not assume and profile when possible. Here is a list of known profilers to aid in your development.