456 lines
16 KiB
C++
456 lines
16 KiB
C++
/*
|
|
*
|
|
* Copyright (c) 2015-2016 The Khronos Group Inc.
|
|
* Copyright (c) 2015-2016 Valve Corporation
|
|
* Copyright (c) 2015-2016 LunarG, Inc.
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*
|
|
* Author: Ian Elliot <ian@lunarg.com>
|
|
* Author: Jon Ashburn <jon@lunarg.com>
|
|
*
|
|
*/
|
|
#pragma once
|
|
|
|
#if defined(_WIN32)
|
|
// WinSock2.h must be included *BEFORE* windows.h
|
|
#include <WinSock2.h>
|
|
#endif // _WIN32
|
|
|
|
#include "vulkan/vk_platform.h"
|
|
#include "vulkan/vk_sdk_platform.h"
|
|
|
|
#if defined(__linux__)
|
|
/* Linux-specific common code: */
|
|
|
|
// Headers:
|
|
//#define _GNU_SOURCE 1
|
|
// TBD: Are the contents of the following file used?
|
|
#include <unistd.h>
|
|
// Note: The following file is for dynamic loading:
|
|
#include <dlfcn.h>
|
|
#include <pthread.h>
|
|
#include <assert.h>
|
|
#include <string.h>
|
|
#include <stdbool.h>
|
|
#include <stdlib.h>
|
|
#include <libgen.h>
|
|
|
|
// VK Library Filenames, Paths, etc.:
|
|
#define PATH_SEPERATOR ':'
|
|
#define DIRECTORY_SYMBOL '/'
|
|
|
|
#define VULKAN_ICDCONF_DIR \
|
|
"/" \
|
|
"vulkan" \
|
|
"/" \
|
|
"icd.d"
|
|
#define VULKAN_ICD_DIR \
|
|
"/" \
|
|
"vulkan" \
|
|
"/" \
|
|
"icd"
|
|
#define VULKAN_ELAYERCONF_DIR \
|
|
"/" \
|
|
"vulkan" \
|
|
"/" \
|
|
"explicit_layer.d"
|
|
#define VULKAN_ILAYERCONF_DIR \
|
|
"/" \
|
|
"vulkan" \
|
|
"/" \
|
|
"implicit_layer.d"
|
|
#define VULKAN_LAYER_DIR \
|
|
"/" \
|
|
"vulkan" \
|
|
"/" \
|
|
"layer"
|
|
|
|
#if defined(LOCALPREFIX)
|
|
#define LOCAL_DRIVERS_INFO \
|
|
LOCALPREFIX "/" SYSCONFDIR VULKAN_ICDCONF_DIR ":" LOCALPREFIX \
|
|
"/" DATADIR VULKAN_ICDCONF_DIR ":"
|
|
#define LOCAL_ELAYERS_INFO \
|
|
LOCALPREFIX "/" SYSCONFDIR VULKAN_ELAYERCONF_DIR ":" LOCALPREFIX \
|
|
"/" DATADIR VULKAN_ELAYERCONF_DIR ":"
|
|
#define LOCAL_ILAYERS_INFO \
|
|
LOCALPREFIX "/" SYSCONFDIR VULKAN_ILAYERCONF_DIR ":" LOCALPREFIX \
|
|
"/" DATADIR VULKAN_ILAYERCONF_DIR ":"
|
|
#else
|
|
#define LOCAL_DRIVERS_INFO
|
|
#define LOCAL_ELAYERS_INFO
|
|
#define LOCAL_ILAYERS_INFO
|
|
#endif
|
|
|
|
#define DEFAULT_VK_DRIVERS_INFO \
|
|
LOCAL_DRIVERS_INFO \
|
|
"/" SYSCONFDIR VULKAN_ICDCONF_DIR ":" \
|
|
"/usr/" DATADIR VULKAN_ICDCONF_DIR
|
|
#define DEFAULT_VK_DRIVERS_PATH ""
|
|
#define DEFAULT_VK_ELAYERS_INFO \
|
|
LOCAL_ELAYERS_INFO \
|
|
"/" SYSCONFDIR VULKAN_ELAYERCONF_DIR ":" \
|
|
"/usr/" DATADIR VULKAN_ELAYERCONF_DIR
|
|
#define DEFAULT_VK_ILAYERS_INFO \
|
|
LOCAL_ILAYERS_INFO \
|
|
"/" SYSCONFDIR VULKAN_ILAYERCONF_DIR ":" \
|
|
"/usr/" DATADIR VULKAN_ILAYERCONF_DIR
|
|
#define DEFAULT_VK_LAYERS_PATH ""
|
|
#if !defined(LAYERS_SOURCE_PATH)
|
|
#define LAYERS_SOURCE_PATH NULL
|
|
#endif
|
|
#define LAYERS_PATH_ENV "VK_LAYER_PATH"
|
|
#define HOME_VK_DRIVERS_INFO "/.local/share" VULKAN_ICDCONF_DIR
|
|
#define HOME_VK_ELAYERS_INFO "/.local/share" VULKAN_ELAYERCONF_DIR
|
|
#define HOME_VK_ILAYERS_INFO "/.local/share" VULKAN_ILAYERCONF_DIR
|
|
|
|
// C99:
|
|
#define PRINTF_SIZE_T_SPECIFIER "%zu"
|
|
|
|
// File IO
|
|
static inline bool loader_platform_file_exists(const char *path) {
|
|
if (access(path, F_OK))
|
|
return false;
|
|
else
|
|
return true;
|
|
}
|
|
|
|
static inline bool loader_platform_is_path_absolute(const char *path) {
|
|
if (path[0] == '/')
|
|
return true;
|
|
else
|
|
return false;
|
|
}
|
|
|
|
static inline char *loader_platform_dirname(char *path) {
|
|
return dirname(path);
|
|
}
|
|
|
|
// Environment variables
|
|
|
|
static inline char *loader_getenv(const char *name) { return getenv(name); }
|
|
|
|
static inline void loader_free_getenv(const char *val) {}
|
|
|
|
// Dynamic Loading of libraries:
|
|
typedef void *loader_platform_dl_handle;
|
|
static inline loader_platform_dl_handle
|
|
loader_platform_open_library(const char *libPath) {
|
|
return dlopen(libPath, RTLD_LAZY | RTLD_LOCAL);
|
|
}
|
|
static inline const char *
|
|
loader_platform_open_library_error(const char *libPath) {
|
|
return dlerror();
|
|
}
|
|
static inline void
|
|
loader_platform_close_library(loader_platform_dl_handle library) {
|
|
dlclose(library);
|
|
}
|
|
static inline void *
|
|
loader_platform_get_proc_address(loader_platform_dl_handle library,
|
|
const char *name) {
|
|
assert(library);
|
|
assert(name);
|
|
return dlsym(library, name);
|
|
}
|
|
static inline const char *
|
|
loader_platform_get_proc_address_error(const char *name) {
|
|
return dlerror();
|
|
}
|
|
|
|
// Threads:
|
|
typedef pthread_t loader_platform_thread;
|
|
#define THREAD_LOCAL_DECL __thread
|
|
#define LOADER_PLATFORM_THREAD_ONCE_DECLARATION(var) \
|
|
pthread_once_t var = PTHREAD_ONCE_INIT;
|
|
#define LOADER_PLATFORM_THREAD_ONCE_DEFINITION(var) pthread_once_t var;
|
|
static inline void loader_platform_thread_once(pthread_once_t *ctl,
|
|
void (*func)(void)) {
|
|
assert(func != NULL);
|
|
assert(ctl != NULL);
|
|
pthread_once(ctl, func);
|
|
}
|
|
|
|
// Thread IDs:
|
|
typedef pthread_t loader_platform_thread_id;
|
|
static inline loader_platform_thread_id loader_platform_get_thread_id() {
|
|
return pthread_self();
|
|
}
|
|
|
|
// Thread mutex:
|
|
typedef pthread_mutex_t loader_platform_thread_mutex;
|
|
static inline void
|
|
loader_platform_thread_create_mutex(loader_platform_thread_mutex *pMutex) {
|
|
pthread_mutex_init(pMutex, NULL);
|
|
}
|
|
static inline void
|
|
loader_platform_thread_lock_mutex(loader_platform_thread_mutex *pMutex) {
|
|
pthread_mutex_lock(pMutex);
|
|
}
|
|
static inline void
|
|
loader_platform_thread_unlock_mutex(loader_platform_thread_mutex *pMutex) {
|
|
pthread_mutex_unlock(pMutex);
|
|
}
|
|
static inline void
|
|
loader_platform_thread_delete_mutex(loader_platform_thread_mutex *pMutex) {
|
|
pthread_mutex_destroy(pMutex);
|
|
}
|
|
typedef pthread_cond_t loader_platform_thread_cond;
|
|
static inline void
|
|
loader_platform_thread_init_cond(loader_platform_thread_cond *pCond) {
|
|
pthread_cond_init(pCond, NULL);
|
|
}
|
|
static inline void
|
|
loader_platform_thread_cond_wait(loader_platform_thread_cond *pCond,
|
|
loader_platform_thread_mutex *pMutex) {
|
|
pthread_cond_wait(pCond, pMutex);
|
|
}
|
|
static inline void
|
|
loader_platform_thread_cond_broadcast(loader_platform_thread_cond *pCond) {
|
|
pthread_cond_broadcast(pCond);
|
|
}
|
|
|
|
#define loader_stack_alloc(size) alloca(size)
|
|
|
|
#elif defined(_WIN32) // defined(__linux__)
|
|
/* Windows-specific common code: */
|
|
// WinBase.h defines CreateSemaphore and synchapi.h defines CreateEvent
|
|
// undefine them to avoid conflicts with VkLayerDispatchTable struct members.
|
|
#ifdef CreateSemaphore
|
|
#undef CreateSemaphore
|
|
#endif
|
|
#ifdef CreateEvent
|
|
#undef CreateEvent
|
|
#endif
|
|
#include <assert.h>
|
|
#include <stdio.h>
|
|
#include <string.h>
|
|
#include <io.h>
|
|
#include <stdbool.h>
|
|
#include <shlwapi.h>
|
|
#ifdef __cplusplus
|
|
#include <iostream>
|
|
#include <string>
|
|
using namespace std;
|
|
#endif // __cplusplus
|
|
|
|
// VK Library Filenames, Paths, etc.:
|
|
#define PATH_SEPERATOR ';'
|
|
#define DIRECTORY_SYMBOL '\\'
|
|
#define DEFAULT_VK_REGISTRY_HIVE HKEY_LOCAL_MACHINE
|
|
#define DEFAULT_VK_DRIVERS_INFO "SOFTWARE\\Khronos\\Vulkan\\Drivers"
|
|
// TODO: Are these the correct paths
|
|
#define DEFAULT_VK_DRIVERS_PATH ""
|
|
#define DEFAULT_VK_ELAYERS_INFO "SOFTWARE\\Khronos\\Vulkan\\ExplicitLayers"
|
|
#define DEFAULT_VK_ILAYERS_INFO "SOFTWARE\\Khronos\\Vulkan\\ImplicitLayers"
|
|
#if !defined(DEFAULT_VK_LAYERS_PATH)
|
|
#define DEFAULT_VK_LAYERS_PATH ""
|
|
#endif
|
|
#if !defined(LAYERS_SOURCE_PATH)
|
|
#define LAYERS_SOURCE_PATH NULL
|
|
#endif
|
|
#define LAYERS_PATH_ENV "VK_LAYER_PATH"
|
|
#define HOME_VK_DRIVERS_INFO ""
|
|
#define HOME_VK_ELAYERS_INFO ""
|
|
#define HOME_VK_ILAYERS_INFO ""
|
|
#define PRINTF_SIZE_T_SPECIFIER "%Iu"
|
|
|
|
// File IO
|
|
static bool loader_platform_file_exists(const char *path) {
|
|
if ((_access(path, 0)) == -1)
|
|
return false;
|
|
else
|
|
return true;
|
|
}
|
|
|
|
static bool loader_platform_is_path_absolute(const char *path) {
|
|
return !PathIsRelative(path);
|
|
}
|
|
|
|
// WIN32 runtime doesn't have dirname().
|
|
static inline char *loader_platform_dirname(char *path) {
|
|
char *current, *next;
|
|
|
|
// TODO/TBD: Do we need to deal with the Windows's ":" character?
|
|
|
|
for (current = path; *current != '\0'; current = next) {
|
|
next = strchr(current, DIRECTORY_SYMBOL);
|
|
if (next == NULL) {
|
|
if (current != path)
|
|
*(current - 1) = '\0';
|
|
return path;
|
|
} else {
|
|
// Point one character past the DIRECTORY_SYMBOL:
|
|
next++;
|
|
}
|
|
}
|
|
return path;
|
|
}
|
|
|
|
// WIN32 runtime doesn't have basename().
|
|
// Microsoft also doesn't have basename(). Paths are different on Windows, and
|
|
// so this is just a temporary solution in order to get us compiling, so that we
|
|
// can test some scenarios, and develop the correct solution for Windows.
|
|
// TODO: Develop a better, permanent solution for Windows, to replace this
|
|
// temporary code:
|
|
static char *loader_platform_basename(char *pathname) {
|
|
char *current, *next;
|
|
|
|
// TODO/TBD: Do we need to deal with the Windows's ":" character?
|
|
|
|
for (current = pathname; *current != '\0'; current = next) {
|
|
next = strchr(current, DIRECTORY_SYMBOL);
|
|
if (next == NULL) {
|
|
// No more DIRECTORY_SYMBOL's so return p:
|
|
return current;
|
|
} else {
|
|
// Point one character past the DIRECTORY_SYMBOL:
|
|
next++;
|
|
}
|
|
}
|
|
// We shouldn't get to here, but this makes the compiler happy:
|
|
return current;
|
|
}
|
|
|
|
// Environment variables
|
|
|
|
static inline char *loader_getenv(const char *name) {
|
|
char *retVal;
|
|
DWORD valSize;
|
|
|
|
valSize = GetEnvironmentVariableA(name, NULL, 0);
|
|
|
|
// valSize DOES include the null terminator, so for any set variable
|
|
// will always be at least 1. If it's 0, the variable wasn't set.
|
|
if (valSize == 0)
|
|
return NULL;
|
|
|
|
// TODO; FIXME This should be using any app defined memory allocation
|
|
retVal = (char *)malloc(valSize);
|
|
|
|
GetEnvironmentVariableA(name, retVal, valSize);
|
|
|
|
return retVal;
|
|
}
|
|
|
|
static inline void loader_free_getenv(const char *val) { free((void *)val); }
|
|
|
|
// Dynamic Loading:
|
|
typedef HMODULE loader_platform_dl_handle;
|
|
static loader_platform_dl_handle
|
|
loader_platform_open_library(const char *libPath) {
|
|
return LoadLibrary(libPath);
|
|
}
|
|
static char *loader_platform_open_library_error(const char *libPath) {
|
|
static char errorMsg[120];
|
|
snprintf(errorMsg, 119, "Failed to open dynamic library \"%s\"", libPath);
|
|
return errorMsg;
|
|
}
|
|
static void loader_platform_close_library(loader_platform_dl_handle library) {
|
|
FreeLibrary(library);
|
|
}
|
|
static void *loader_platform_get_proc_address(loader_platform_dl_handle library,
|
|
const char *name) {
|
|
assert(library);
|
|
assert(name);
|
|
return GetProcAddress(library, name);
|
|
}
|
|
static char *loader_platform_get_proc_address_error(const char *name) {
|
|
static char errorMsg[120];
|
|
snprintf(errorMsg, 119, "Failed to find function \"%s\" in dynamic library",
|
|
name);
|
|
return errorMsg;
|
|
}
|
|
|
|
// Threads:
|
|
typedef HANDLE loader_platform_thread;
|
|
#define THREAD_LOCAL_DECL __declspec(thread)
|
|
#define LOADER_PLATFORM_THREAD_ONCE_DECLARATION(var) \
|
|
INIT_ONCE var = INIT_ONCE_STATIC_INIT;
|
|
#define LOADER_PLATFORM_THREAD_ONCE_DEFINITION(var) INIT_ONCE var;
|
|
static BOOL CALLBACK
|
|
InitFuncWrapper(PINIT_ONCE InitOnce, PVOID Parameter, PVOID *Context) {
|
|
void (*func)(void) = (void (*)(void))Parameter;
|
|
func();
|
|
return TRUE;
|
|
}
|
|
|
|
static void loader_platform_thread_once(void *ctl, void (*func)(void)) {
|
|
assert(func != NULL);
|
|
assert(ctl != NULL);
|
|
InitOnceExecuteOnce((PINIT_ONCE)ctl, InitFuncWrapper, func, NULL);
|
|
}
|
|
|
|
// Thread IDs:
|
|
typedef DWORD loader_platform_thread_id;
|
|
static loader_platform_thread_id loader_platform_get_thread_id() {
|
|
return GetCurrentThreadId();
|
|
}
|
|
|
|
// Thread mutex:
|
|
typedef CRITICAL_SECTION loader_platform_thread_mutex;
|
|
static void
|
|
loader_platform_thread_create_mutex(loader_platform_thread_mutex *pMutex) {
|
|
InitializeCriticalSection(pMutex);
|
|
}
|
|
static void
|
|
loader_platform_thread_lock_mutex(loader_platform_thread_mutex *pMutex) {
|
|
EnterCriticalSection(pMutex);
|
|
}
|
|
static void
|
|
loader_platform_thread_unlock_mutex(loader_platform_thread_mutex *pMutex) {
|
|
LeaveCriticalSection(pMutex);
|
|
}
|
|
static void
|
|
loader_platform_thread_delete_mutex(loader_platform_thread_mutex *pMutex) {
|
|
DeleteCriticalSection(pMutex);
|
|
}
|
|
typedef CONDITION_VARIABLE loader_platform_thread_cond;
|
|
static void
|
|
loader_platform_thread_init_cond(loader_platform_thread_cond *pCond) {
|
|
InitializeConditionVariable(pCond);
|
|
}
|
|
static void
|
|
loader_platform_thread_cond_wait(loader_platform_thread_cond *pCond,
|
|
loader_platform_thread_mutex *pMutex) {
|
|
SleepConditionVariableCS(pCond, pMutex, INFINITE);
|
|
}
|
|
static void
|
|
loader_platform_thread_cond_broadcast(loader_platform_thread_cond *pCond) {
|
|
WakeAllConditionVariable(pCond);
|
|
}
|
|
|
|
// Windows Registry:
|
|
char *loader_get_registry_string(const HKEY hive, const LPCTSTR sub_key,
|
|
const char *value);
|
|
|
|
#define loader_stack_alloc(size) _alloca(size)
|
|
#else // defined(_WIN32)
|
|
|
|
#error The "loader_platform.h" file must be modified for this OS.
|
|
|
|
// NOTE: In order to support another OS, an #elif needs to be added (above the
|
|
// "#else // defined(_WIN32)") for that OS, and OS-specific versions of the
|
|
// contents of this file must be created.
|
|
|
|
// NOTE: Other OS-specific changes are also needed for this OS. Search for
|
|
// files with "WIN32" in it, as a quick way to find files that must be changed.
|
|
|
|
#endif // defined(_WIN32)
|
|
|
|
// returns true if the given string appears to be a relative or absolute
|
|
// path, as opposed to a bare filename.
|
|
static inline bool loader_platform_is_path(const char *path) {
|
|
return strchr(path, DIRECTORY_SYMBOL) != NULL;
|
|
}
|