This is a README file for Anvil, a framework for Vulkan™. The README is organized as a FAQ.
Toolchain | Status |
---|---|
Linux (clang/gcc) build status | |
Windows (VS15/VS17) build status: |
MIT. See LICENSE.txt
.
Anvil is a framework for Vulkan v1.0 and v1.1, which we have been using internally for quite some time now, in order to develop various Vulkan applications. This guarantees that vast majority of the functionality exposed by the library is regularly tested.
The general idea we started from was to have a cross-platform tool, which would reduce the amount of time required to write portable Vulkan-based apps from scratch. We would then find ourselves adding new features & extending the existing codebase with new wrappers every now and then.
This eventually led to the library we have decided to release to the public.
Anvil was designed with the following goals in mind:
Anvil is not the right choice for developers who do not have a reasonable understanding of how Vulkan works. Its goal is not to provide a glBegin/glEnd-like level of abstraction, but rather to give a sensible environment, in which you can rapidly prototype Vulkan applications.
Currently, Anvil has been confirmed to build and work correctly under:
In order to build Anvil, you will need the following software:
To build Anvil on Linux, additional packages should be installed:
Anvil has not been designed with AMD hardware architecture in mind, but it is going to provide interface-level support for any extensions we may decide to release in the future.
As such, it should (and has been verified to) work on any Windows Vulkan implementation and on AMDGPU-PRO Vulkan implementation on Linux.
Anvil provides full support for functionality exposed in Vulkan 1.0 and Vulkan 1.1. We also try to do our best to keep it up to date with any extensions our Vulkan implementations expose.
We are planning to keep adding new features in the future.
Anvil comes with several example applications, including OutOfOrderRasterization, which renders 10k teapots on screen. It uses various Anvil wrappers, so you can use it to get a better understanding of how various parts of the library can be used.
...and its Vulkan-related code only takes ~45kbytes!
OutOfOrderRasterization and the other example applications are located in the
examples
directory.
Please observe the "Issues" tab for more details.
Various developers within AMD.
Please feel free to open an issue in Anvil's GitHub project.