portability/README.md

gfx-portability

This is a prototype library implementing Vulkan Portability Initiative using gfx-rs low-level core. See gfx-rs meta issue for backend limitations and further details.

Vulkan CTS coverage

gfx-rs Backend	Total cases	Pass	Fail	Quality warning	Compatibility warning	Not supported	Resource error	Internal error	Timeout	Crash
Vulkan	3589	665	676	0	0	2248	0	0	0	0
DX12	3563	1243	73	0	0	2247	0	0	0	0

Currently crashing on event handling.

Please visit our wiki for CTS hookup instructions. Once everything is set, you can generate the new results by calling make cts.

Check out

git clone --recursive https://github.com/gfx-rs/portability && cd portability

Build

Makefile (Unix)

make

CMake (Window)

Build the Rust library (portability implementation):

cargo build --manifest-path libportability/Cargo.toml --features <vulkan|dx12|metal>

Build the native example:

mkdir build
cd build
cmake ..
cmake --build . --target native_test

Running Samples

LunarG (API-Samples)

After building portability as shown above, grab a copy from https://github.com/LunarG/VulkanSamples. Manually override the VULKAN_LOADER variable and set it to the portability library.

set (VULKAN_LOADER "path/to/portability/library")

Then proceed with the normal build instructions.