/* Copyright (c) 2015-2017 The Khronos Group Inc.
|
* Copyright (c) 2015-2017 Valve Corporation
|
* Copyright (c) 2015-2017 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: Mark Lobodzinski <mark@lunarg.com>
|
* Author: Courtney Goeltzenleuchter <courtney@LunarG.com>
|
* Author: Dave Houlton <daveh@lunarg.com>
|
*/
|
|
#pragma once
|
#include <stdbool.h>
|
#include <string>
|
#include <vector>
|
#include <set>
|
#include "vk_format_utils.h"
|
#include "vk_layer_logging.h"
|
|
#ifndef WIN32
|
#include <strings.h> // For ffs()
|
#else
|
#include <intrin.h> // For __lzcnt()
|
#endif
|
|
#ifdef __cplusplus
|
// Traits objects to allow string_join to operate on collections of const char *
|
template <typename String>
|
struct StringJoinSizeTrait {
|
static size_t size(const String &str) { return str.size(); }
|
};
|
|
template <>
|
struct StringJoinSizeTrait<const char *> {
|
static size_t size(const char *str) {
|
if (!str) return 0;
|
return strlen(str);
|
}
|
};
|
// Similar to perl/python join
|
// * String must support size, reserve, append, and be default constructable
|
// * StringCollection must support size, const forward iteration, and store
|
// strings compatible with String::append
|
// * Accessor trait can be set if default accessors (compatible with string
|
// and const char *) don't support size(StringCollection::value_type &)
|
//
|
// Return type based on sep type
|
template <typename String = std::string, typename StringCollection = std::vector<String>,
|
typename Accessor = StringJoinSizeTrait<typename StringCollection::value_type>>
|
static inline String string_join(const String &sep, const StringCollection &strings) {
|
String joined;
|
const size_t count = strings.size();
|
if (!count) return joined;
|
|
// Prereserved storage, s.t. we will execute in linear time (avoids reallocation copies)
|
size_t reserve = (count - 1) * sep.size();
|
for (const auto &str : strings) {
|
reserve += Accessor::size(str); // abstracted to allow const char * type in StringCollection
|
}
|
joined.reserve(reserve + 1);
|
|
// Seps only occur *between* strings entries, so first is special
|
auto current = strings.cbegin();
|
joined.append(*current);
|
++current;
|
for (; current != strings.cend(); ++current) {
|
joined.append(sep);
|
joined.append(*current);
|
}
|
return joined;
|
}
|
|
// Requires StringCollection::value_type has a const char * constructor and is compatible the string_join::String above
|
template <typename StringCollection = std::vector<std::string>, typename SepString = std::string>
|
static inline SepString string_join(const char *sep, const StringCollection &strings) {
|
return string_join<SepString, StringCollection>(SepString(sep), strings);
|
}
|
|
// Perl/Python style join operation for general types using stream semantics
|
// Note: won't be as fast as string_join above, but simpler to use (and code)
|
// Note: Modifiable reference doesn't match the google style but does match std style for stream handling and algorithms
|
template <typename Stream, typename String, typename ForwardIt>
|
Stream &stream_join(Stream &stream, const String &sep, ForwardIt first, ForwardIt last) {
|
if (first != last) {
|
stream << *first;
|
++first;
|
while (first != last) {
|
stream << sep << *first;
|
++first;
|
}
|
}
|
return stream;
|
}
|
|
// stream_join For whole collections with forward iterators
|
template <typename Stream, typename String, typename Collection>
|
Stream &stream_join(Stream &stream, const String &sep, const Collection &values) {
|
return stream_join(stream, sep, values.cbegin(), values.cend());
|
}
|
|
typedef void *dispatch_key;
|
static inline dispatch_key get_dispatch_key(const void *object) { return (dispatch_key) * (VkLayerDispatchTable **)object; }
|
|
VK_LAYER_EXPORT VkLayerInstanceCreateInfo *get_chain_info(const VkInstanceCreateInfo *pCreateInfo, VkLayerFunction func);
|
VK_LAYER_EXPORT VkLayerDeviceCreateInfo *get_chain_info(const VkDeviceCreateInfo *pCreateInfo, VkLayerFunction func);
|
|
static inline bool IsPowerOfTwo(unsigned x) { return x && !(x & (x - 1)); }
|
|
extern "C" {
|
#endif
|
|
#define VK_LAYER_API_VERSION VK_MAKE_VERSION(1, 0, VK_HEADER_VERSION)
|
|
typedef enum VkStringErrorFlagBits {
|
VK_STRING_ERROR_NONE = 0x00000000,
|
VK_STRING_ERROR_LENGTH = 0x00000001,
|
VK_STRING_ERROR_BAD_DATA = 0x00000002,
|
} VkStringErrorFlagBits;
|
typedef VkFlags VkStringErrorFlags;
|
|
VK_LAYER_EXPORT void layer_debug_report_actions(debug_report_data *report_data,
|
std::vector<VkDebugReportCallbackEXT> &logging_callback,
|
const VkAllocationCallbacks *pAllocator, const char *layer_identifier);
|
|
VK_LAYER_EXPORT void layer_debug_messenger_actions(debug_report_data *report_data,
|
std::vector<VkDebugUtilsMessengerEXT> &logging_messenger,
|
const VkAllocationCallbacks *pAllocator, const char *layer_identifier);
|
|
VK_LAYER_EXPORT VkStringErrorFlags vk_string_validate(const int max_length, const char *char_array);
|
VK_LAYER_EXPORT bool white_list(const char *item, const std::set<std::string> &whitelist);
|
|
static inline int u_ffs(int val) {
|
#ifdef WIN32
|
unsigned long bit_pos = 0;
|
if (_BitScanForward(&bit_pos, val) != 0) {
|
bit_pos += 1;
|
}
|
return bit_pos;
|
#else
|
return ffs(val);
|
#endif
|
}
|
|
#ifdef __cplusplus
|
}
|
#endif
|
