/*
* Copyright 2016 The Android Open Source Project
*
* 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.
*/
#ifndef LIBVULKAN_DEBUG_REPORT_H
#define LIBVULKAN_DEBUG_REPORT_H 1
#include <stdarg.h>
#include <shared_mutex>
#include <vulkan/vulkan.h>
namespace vulkan {
namespace driver {
// clang-format off
VKAPI_ATTR VkResult CreateDebugReportCallbackEXT(VkInstance instance, const VkDebugReportCallbackCreateInfoEXT* pCreateInfo, const VkAllocationCallbacks* pAllocator, VkDebugReportCallbackEXT* pCallback);
VKAPI_ATTR void DestroyDebugReportCallbackEXT(VkInstance instance, VkDebugReportCallbackEXT callback, const VkAllocationCallbacks* pAllocator);
VKAPI_ATTR void DebugReportMessageEXT(VkInstance instance, VkDebugReportFlagsEXT flags, VkDebugReportObjectTypeEXT objectType, uint64_t object, size_t location, int32_t messageCode, const char* pLayerPrefix, const char* pMessage);
// clang-format on
class DebugReportCallbackList {
private:
// forward declaration
struct Node;
public:
DebugReportCallbackList()
: head_{nullptr, 0, nullptr, nullptr, VK_NULL_HANDLE} {}
DebugReportCallbackList(const DebugReportCallbackList&) = delete;
DebugReportCallbackList& operator=(const DebugReportCallbackList&) = delete;
~DebugReportCallbackList() = default;
Node* AddCallback(const VkDebugReportCallbackCreateInfoEXT& info,
VkDebugReportCallbackEXT driver_handle,
const VkAllocationCallbacks& allocator);
void RemoveCallback(Node* node, const VkAllocationCallbacks& allocator);
void Message(VkDebugReportFlagsEXT flags,
VkDebugReportObjectTypeEXT object_type,
uint64_t object,
size_t location,
int32_t message_code,
const char* layer_prefix,
const char* message) const;
static Node* FromHandle(VkDebugReportCallbackEXT handle) {
return reinterpret_cast<Node*>(uintptr_t(handle));
}
static VkDebugReportCallbackEXT GetHandle(const Node* node) {
return VkDebugReportCallbackEXT(reinterpret_cast<uintptr_t>(node));
}
static VkDebugReportCallbackEXT GetDriverHandle(const Node* node) {
return node->driver_handle;
}
private:
struct Node {
Node* next;
VkDebugReportFlagsEXT flags;
PFN_vkDebugReportCallbackEXT callback;
void* user_data;
VkDebugReportCallbackEXT driver_handle;
};
// TODO(jessehall): replace with std::shared_mutex when available in libc++
mutable std::shared_timed_mutex rwmutex_;
Node head_;
};
class DebugReportLogger {
public:
DebugReportLogger(const VkInstanceCreateInfo& info)
: instance_pnext_(info.pNext), callbacks_(nullptr) {}
DebugReportLogger(const DebugReportCallbackList& callbacks)
: instance_pnext_(nullptr), callbacks_(&callbacks) {}
void Message(VkDebugReportFlagsEXT flags,
VkDebugReportObjectTypeEXT object_type,
uint64_t object,
size_t location,
int32_t message_code,
const char* layer_prefix,
const char* message) const;
#define DEBUG_REPORT_LOGGER_PRINTF(fmt, args) \
__attribute__((format(printf, (fmt) + 1, (args) + 1)))
template <typename ObjectType>
void Info(ObjectType object, const char* format, ...) const
DEBUG_REPORT_LOGGER_PRINTF(2, 3) {
va_list ap;
va_start(ap, format);
PrintV(VK_DEBUG_REPORT_INFORMATION_BIT_EXT, GetObjectType(object),
GetObjectUInt64(object), format, ap);
va_end(ap);
}
template <typename ObjectType>
void Warn(ObjectType object, const char* format, ...) const
DEBUG_REPORT_LOGGER_PRINTF(2, 3) {
va_list ap;
va_start(ap, format);
PrintV(VK_DEBUG_REPORT_WARNING_BIT_EXT, GetObjectType(object),
GetObjectUInt64(object), format, ap);
va_end(ap);
}
template <typename ObjectType>
void Err(ObjectType object, const char* format, ...) const
DEBUG_REPORT_LOGGER_PRINTF(2, 3) {
va_list ap;
va_start(ap, format);
PrintV(VK_DEBUG_REPORT_ERROR_BIT_EXT, GetObjectType(object),
GetObjectUInt64(object), format, ap);
va_end(ap);
}
private:
template <typename ObjectType>
static VkDebugReportObjectTypeEXT GetObjectType(ObjectType) {
if (std::is_same<ObjectType, VkInstance>::value)
return VK_DEBUG_REPORT_OBJECT_TYPE_INSTANCE_EXT;
else if (std::is_same<ObjectType, VkPhysicalDevice>::value)
return VK_DEBUG_REPORT_OBJECT_TYPE_PHYSICAL_DEVICE_EXT;
else if (std::is_same<ObjectType, VkDevice>::value)
return VK_DEBUG_REPORT_OBJECT_TYPE_DEVICE_EXT;
else
return VK_DEBUG_REPORT_OBJECT_TYPE_UNKNOWN_EXT;
}
template <typename ObjectType>
static uint64_t GetObjectUInt64(ObjectType object) {
return uint64_t(object);
}
#define DEBUG_REPORT_LOGGER_VPRINTF(fmt) \
__attribute__((format(printf, (fmt) + 1, 0)))
void PrintV(VkDebugReportFlagsEXT flags,
VkDebugReportObjectTypeEXT object_type,
uint64_t object,
const char* format,
va_list ap) const DEBUG_REPORT_LOGGER_VPRINTF(4);
const void* const instance_pnext_;
const DebugReportCallbackList* const callbacks_;
};
} // namespace driver
} // namespace vulkan
#endif // LIBVULKAN_DEBUG_REPORT_H