aboutsummaryrefslogtreecommitdiffstats
path: root/include
diff options
context:
space:
mode:
authorDavid Robillard <d@drobilla.net>2023-01-14 15:21:36 -0500
committerDavid Robillard <d@drobilla.net>2023-01-14 16:18:27 -0500
commit64131038a4f0c3e3f5f5b95e083f0320a68de058 (patch)
tree1a94a4e1811495d746a16c038be0d1e0e345f622 /include
parente8dc1d219f4b461f29e11ad8fe0e463c6dfdb08b (diff)
downloadpugl-64131038a4f0c3e3f5f5b95e083f0320a68de058.tar.gz
pugl-64131038a4f0c3e3f5f5b95e083f0320a68de058.tar.bz2
pugl-64131038a4f0c3e3f5f5b95e083f0320a68de058.zip
Allow applications to specify the Vulkan library path
I don't know if vendoring the Vulkan library is appropriate, but regardless, this allows applications to set the name to whatever they want, or specify an absolute path, just in case the standard value baked into Pugl isn't the right one in some situation.
Diffstat (limited to 'include')
-rw-r--r--include/pugl/vulkan.h11
1 files changed, 10 insertions, 1 deletions
diff --git a/include/pugl/vulkan.h b/include/pugl/vulkan.h
index 0ca7941..cc138df 100644
--- a/include/pugl/vulkan.h
+++ b/include/pugl/vulkan.h
@@ -58,11 +58,20 @@ typedef struct PuglVulkanLoaderImpl PuglVulkanLoader;
This dynamically loads the Vulkan library and gets the load functions from
it.
+ @param world The world the returned loader is a part of.
+
+ @param libraryName The name of the Vulkan library to load, or null.
+ Typically, this is left unset, which will load the standard Vulkan library
+ for the current platform. It can be set to an alternative name, or an
+ absolute path, to support special packaging scenarios or unusual system
+ configurations. This name is passed directly to the underlying platform
+ library loading function (`dlopen` or `LoadLibrary`).
+
@return A new Vulkan loader, or null on failure.
*/
PUGL_API
PuglVulkanLoader*
-puglNewVulkanLoader(PuglWorld* world);
+puglNewVulkanLoader(PuglWorld* world, const char* libraryName);
/**
Free a loader created with puglNewVulkanLoader().