Baike.dev
All toolsOnline toolsAI codingTrendingOpen sourceNewsSubmit
Log in
< Back to tools
A

Ashes

> 编程语言
Open source

Drop-in replacement for Vulkan shared library, for older hardware compatibility

398 stars0 likes1 views
WebsiteGitHub

About

Drop-in replacement for Vulkan shared library, for older hardware compatibility

Ashes

Ashes is a drop-in replacement or ICD to Vulkan.
It allows writing Vulkan code, and selecting the rendering API that will be used.
It also comes with ashespp, a C++ wrapper for Vulkan.
To build it, you can use CMake.

Renderers available

  • Vulkan: Ashes is a passthrough, when using Vulkan rendering API, and it has no additional cost if dynamic loader is used.
  • OpenGL: From OpenGL 3.3 to OpenGL 4.6 (Core profile), it can be used directly as an ICD.
  • Direct3D 11: From feature level 11.0.

Supported platforms

  • Vulkan Renderer: Windows, Linux, MacOS.
  • OpenGL Renderer: Windows, Linux.
  • Direct3D11 Renderer: Windows.
  • XBox Renderer: XBox.

How to use it

Three workflows are possible:

ICD mode

Just set the environment variable VK_ICD_FILENAMES to one of the jsons in Ashes' install dir, and you're done.

Drop-in replacement mode

You load Ashes' shared library instead of Vulkan's, and you're done.
The API selection will be done on first call of vkGetInstanceProcAddr (for dynamic loader), or on first Vulkan API call (for static loader).

Manual mode

You can ask for the list of loaded plugins, through a call to the function int ashEnumeratePlugins( uint32_t * count , AshPluginDescription * plugins );.
It works as Vulkan ones : if plugins is set to NULL, count will then contain the number of loaded plugins.

API

The following API is available, in ashes.h:

…

From this, you can retrieve the supported rendering APIs, check the features they support, activate the one you want/can use.

Here is a small example, to select the rendering API from a command-line option:

…

Building Ashes from source

Ashes relies on CMake as project generator. The easiest way to build it is to use the presets already defined:

  • dev-msvc: Visual Studio build, you need to provide the necessary libraries.
  • dev-ninja-debug, dev-ninja-release]: Ninja build, you need to provide the necessary libraries.
  • dev-vcpkg-msvc: Visual Studio build, using vcpkg to fetch the dependencies.
  • dev-vcpkg-ninja-debug, dev-vcpkg-ninja-release]: Ninja build, using vcpkg to fetch the dependencies.

Contact

You can reach me on the Discord server dedicated to my projects: DragonJoker's Lair

Validation

Ashes is validated using Sascha Willems' Vulkan examples repository.
I've forked it, to be able to test the drivers.

Test applications

These applications are used to validate the basic functionalities of the ashespp library.

Device creation

Most basic example, initialises the logical device.

Swapchain creation

Another simple test, checking that swapchain creation succeeds.

Vertex layout

Tests vertex layouts, by displaying a coloured rectangle.

Staging buffer

Tests transfers to VRAM using staging buffers.

Texture 1D

Tests texture 1D load and display.

Texture 2D

Tests texture 2D load and display.

Texture 3D

Demonstrates load and display of a 3D texture.

Texture Cube

Loads a cube texture and displays it as a skybox.

Texture Buffer

Tests texture buffer load and display.

Compressed Texture 2D

Tests loading a texture 2D, compressed in either BC3, ASTC 8x8 or ETC2, depending on support by the rendering API.

Compressed Texture 2D Array

Tests loading a texture 2D array, compressed in either BC3, ASTC 8x8 or ETC2, depending on support by the rendering API.

Texture 2D Mipmaps

Tests loading a texture 2D and its mipmap levels from a file.

Texture 2D Mipmaps Generation

Tests loading a texture 2D from a file, and generating its mipmaps from level 0.

Uniform Buffers

Tests the usage of uniform buffers.

Push Constants

Demonstrates the use of push constants, by displaying two cubes with different colour modifiers, stored in push constants.

Render to Cube

Tests render to cube, by taking an equirectangular texture, and loading it into a skybox.

Frame Buffer

Tests frame buffers, and index buffers too.

Spinning cube

Tests depth buffer, depth test, and multiple uniform buffers.

Instantiation

Tests hardware instantiation, by rendering 1'000'000 cubes.

Compute Pipeline

Tests Compute pipeline, by processing the output of the PushConstants sample to add a graphical effect.

Dynamic Uniform Buffers

Takes the push constant test case and uses dynamic buffer descriptor instead of multiple descriptors.

Specialisation Constants

Tests the specialisation constants in Vulkan (matching them with uniforms in OpenGL renderers).

SPIR-V Specialisation Constants

Tests the specialisation constants in Vulkan and OpenGL renderers (as long as they support SPIRV shaders).

Bloom

Bloom implementation using downscale through mipmaps.

Sample applications

Sample apps to implement

  • Compute particle system.

These applications use the library in a more complex way, closer to what would be done within an engine.

Object Loading

Loads an object, with textures, and displays it.

Lighting

Applies lights to the previously loaded object.

Normal Mapping

Applies normal mapping.

Deferred Rendering

Deferred rendering implementation for opaque objects

Billboards

Billboards sample.

Issues· 12 open

View all issuesOpen on GitHub

No open issues yet, or sync has not completed.

> Tags

C++cpp17direct3d11openglvulkan

No comments yet. Be the first to share.

> Details

PublishedAug 1, 2026
UpdatedSep 17, 2026
Category编程语言
PricingOpen source

> Related tools

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言