Require a tutorial demonstrate how to integrate this driver to Vulkan applications

[shrinktofit]

I have successfully ran the LunarG/VulkanSmples according to readme. Next I wish to use it in my vulkan application but I don't know how to. I use lunarG SDK and it by default load my graphic card's vulkan driver.

[kvark]

Here are the steps:

1. build libportability_icd, e.g. cd libportability_icd && cargo build --features metal
2. make sure to have a good ICD definition. We have a few in-repo, e.g. portability-win-debug, and we want those for all configuration in the end. If there isn't one for your platform/config, just copy an existing one and modify the path, if needed.
3. run your app with VULKAN_ICD_FILENAMES=<path_to_your_ICD.json>

[shrinktofit]

Here are the steps:

1. build libportability_icd, e.g. cd libportability_icd && cargo build --features metal
2. make sure to have a good ICD definition. We have a few in-repo, e.g. portability-win-debug, and we want those for all configuration in the end. If there isn't one for your platform/config, just copy an existing one and modify the path, if needed.
3. run your app with VULKAN_ICD_FILENAMES=<path_to_your_ICD.json>

@kvark I modified metal to vulkan and VULKAN_ICD_FILENAMES to VK_ICD_FILENAMES

My steps:

• cargo build --manifest-path libportability/Cargo.toml --features vulkan
• cd libportability_icd && cargo build --features vulkan
• setup the enviroment variable VK_ICD_FILENAMES=<path-to-the-portability-win-debug.json>(I use windows 10 so I didn't modify that file)

I ran my application, it successfully load the portability_icd.dll. But a stackoverflow is produced during call vkCreateInstance, I trace the call stack and I found in LunarG SDK's loader/loader.c file, the vkCreateInstance's loader_create_instance_chain() invocation line is continuously called:

[grovesNL]

@shrinktofit I think there is an open issue about loading portability with --features vulkan at the moment (LunarG/VulkanSamples#162) that needs to be resolved.

Are you trying to test portability for use with DirectX 12 or something else? You could try --features dx12 instead (if you have it installed).

[shrinktofit]

I think I misunderstood the feature option...

It represent "which backend is choosen to implement the vulkan", not "do you want to implement vulkan or metal or dx12", right? Hah...

[grovesNL]

That's right 😄

[kvark]

@shrinktofit would you want to try out dx12 as @grovesNL suggested? Otherwise the issue can be closed.