288 lines
11 KiB
C++
288 lines
11 KiB
C++
/**************************************************************************/
|
|
/* openxr_debug_utils_extension.cpp */
|
|
/**************************************************************************/
|
|
/* This file is part of: */
|
|
/* GODOT ENGINE */
|
|
/* https://godotengine.org */
|
|
/**************************************************************************/
|
|
/* Copyright (c) 2014-present Godot Engine contributors (see AUTHORS.md). */
|
|
/* Copyright (c) 2007-2014 Juan Linietsky, Ariel Manzur. */
|
|
/* */
|
|
/* Permission is hereby granted, free of charge, to any person obtaining */
|
|
/* a copy of this software and associated documentation files (the */
|
|
/* "Software"), to deal in the Software without restriction, including */
|
|
/* without limitation the rights to use, copy, modify, merge, publish, */
|
|
/* distribute, sublicense, and/or sell copies of the Software, and to */
|
|
/* permit persons to whom the Software is furnished to do so, subject to */
|
|
/* the following conditions: */
|
|
/* */
|
|
/* The above copyright notice and this permission notice shall be */
|
|
/* included in all copies or substantial portions of the Software. */
|
|
/* */
|
|
/* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */
|
|
/* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */
|
|
/* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. */
|
|
/* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */
|
|
/* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */
|
|
/* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */
|
|
/* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
|
|
/**************************************************************************/
|
|
|
|
#include "openxr_debug_utils_extension.h"
|
|
|
|
#include "../openxr_api.h"
|
|
#include "core/config/project_settings.h"
|
|
#include "core/string/print_string.h"
|
|
|
|
#include <openxr/openxr.h>
|
|
|
|
OpenXRDebugUtilsExtension *OpenXRDebugUtilsExtension::singleton = nullptr;
|
|
|
|
OpenXRDebugUtilsExtension *OpenXRDebugUtilsExtension::get_singleton() {
|
|
return singleton;
|
|
}
|
|
|
|
OpenXRDebugUtilsExtension::OpenXRDebugUtilsExtension() {
|
|
singleton = this;
|
|
}
|
|
|
|
OpenXRDebugUtilsExtension::~OpenXRDebugUtilsExtension() {
|
|
singleton = nullptr;
|
|
}
|
|
|
|
HashMap<String, bool *> OpenXRDebugUtilsExtension::get_requested_extensions() {
|
|
HashMap<String, bool *> request_extensions;
|
|
|
|
request_extensions[XR_EXT_DEBUG_UTILS_EXTENSION_NAME] = &debug_utils_ext;
|
|
|
|
return request_extensions;
|
|
}
|
|
|
|
void OpenXRDebugUtilsExtension::on_instance_created(const XrInstance p_instance) {
|
|
if (debug_utils_ext) {
|
|
EXT_INIT_XR_FUNC(xrCreateDebugUtilsMessengerEXT);
|
|
EXT_INIT_XR_FUNC(xrDestroyDebugUtilsMessengerEXT);
|
|
EXT_INIT_XR_FUNC(xrSetDebugUtilsObjectNameEXT);
|
|
EXT_INIT_XR_FUNC(xrSessionBeginDebugUtilsLabelRegionEXT);
|
|
EXT_INIT_XR_FUNC(xrSessionEndDebugUtilsLabelRegionEXT);
|
|
EXT_INIT_XR_FUNC(xrSessionInsertDebugUtilsLabelEXT);
|
|
|
|
debug_utils_ext = xrCreateDebugUtilsMessengerEXT_ptr && xrDestroyDebugUtilsMessengerEXT_ptr && xrSetDebugUtilsObjectNameEXT_ptr && xrSessionBeginDebugUtilsLabelRegionEXT_ptr && xrSessionEndDebugUtilsLabelRegionEXT_ptr && xrSessionInsertDebugUtilsLabelEXT_ptr;
|
|
} else {
|
|
WARN_PRINT("OpenXR: The debug utils extension is not available on this runtime. Debug logging is not enabled!");
|
|
}
|
|
|
|
// On successful init, setup our default messenger.
|
|
if (debug_utils_ext) {
|
|
int max_severity = GLOBAL_GET("xr/openxr/extensions/debug_utils");
|
|
int types = GLOBAL_GET("xr/openxr/extensions/debug_message_types");
|
|
|
|
XrDebugUtilsMessageSeverityFlagsEXT message_severities = 0;
|
|
|
|
if (max_severity >= 1) {
|
|
message_severities |= XR_DEBUG_UTILS_MESSAGE_SEVERITY_ERROR_BIT_EXT;
|
|
}
|
|
if (max_severity >= 2) {
|
|
message_severities |= XR_DEBUG_UTILS_MESSAGE_SEVERITY_WARNING_BIT_EXT;
|
|
}
|
|
if (max_severity >= 3) {
|
|
message_severities |= XR_DEBUG_UTILS_MESSAGE_SEVERITY_INFO_BIT_EXT;
|
|
}
|
|
if (max_severity >= 4) {
|
|
message_severities |= XR_DEBUG_UTILS_MESSAGE_SEVERITY_VERBOSE_BIT_EXT;
|
|
}
|
|
|
|
XrDebugUtilsMessageTypeFlagsEXT message_types = 0;
|
|
|
|
// These should match up but just to be safe and future proof...
|
|
if (types & 1) {
|
|
message_types |= XR_DEBUG_UTILS_MESSAGE_TYPE_GENERAL_BIT_EXT;
|
|
}
|
|
if (types & 2) {
|
|
message_types |= XR_DEBUG_UTILS_MESSAGE_TYPE_VALIDATION_BIT_EXT;
|
|
}
|
|
if (types & 4) {
|
|
message_types |= XR_DEBUG_UTILS_MESSAGE_TYPE_PERFORMANCE_BIT_EXT;
|
|
}
|
|
if (types & 8) {
|
|
message_types |= XR_DEBUG_UTILS_MESSAGE_TYPE_CONFORMANCE_BIT_EXT;
|
|
}
|
|
|
|
XrDebugUtilsMessengerCreateInfoEXT callback_info = {
|
|
XR_TYPE_DEBUG_UTILS_MESSENGER_CREATE_INFO_EXT, // type
|
|
nullptr, // next
|
|
message_severities, // messageSeverities
|
|
message_types, // messageTypes
|
|
&OpenXRDebugUtilsExtension::_debug_callback, // userCallback
|
|
nullptr, // userData
|
|
};
|
|
|
|
XrResult result = xrCreateDebugUtilsMessengerEXT(p_instance, &callback_info, &default_messenger);
|
|
if (XR_FAILED(result)) {
|
|
ERR_PRINT("OpenXR: Failed to create debug callback [" + OpenXRAPI::get_singleton()->get_error_string(result) + "]");
|
|
}
|
|
|
|
set_object_name(XR_OBJECT_TYPE_INSTANCE, uint64_t(p_instance), "Main Godot OpenXR Instance");
|
|
}
|
|
}
|
|
|
|
void OpenXRDebugUtilsExtension::on_instance_destroyed() {
|
|
if (default_messenger != XR_NULL_HANDLE) {
|
|
XrResult result = xrDestroyDebugUtilsMessengerEXT(default_messenger);
|
|
if (XR_FAILED(result)) {
|
|
ERR_PRINT("OpenXR: Failed to destroy debug callback [" + OpenXRAPI::get_singleton()->get_error_string(result) + "]");
|
|
}
|
|
|
|
default_messenger = XR_NULL_HANDLE;
|
|
}
|
|
|
|
xrCreateDebugUtilsMessengerEXT_ptr = nullptr;
|
|
xrDestroyDebugUtilsMessengerEXT_ptr = nullptr;
|
|
xrSetDebugUtilsObjectNameEXT_ptr = nullptr;
|
|
xrSessionBeginDebugUtilsLabelRegionEXT_ptr = nullptr;
|
|
xrSessionEndDebugUtilsLabelRegionEXT_ptr = nullptr;
|
|
xrSessionInsertDebugUtilsLabelEXT_ptr = nullptr;
|
|
debug_utils_ext = false;
|
|
}
|
|
|
|
bool OpenXRDebugUtilsExtension::get_active() {
|
|
return debug_utils_ext;
|
|
}
|
|
|
|
void OpenXRDebugUtilsExtension::set_object_name(XrObjectType p_object_type, uint64_t p_object_handle, const char *p_object_name) {
|
|
ERR_FAIL_COND(!debug_utils_ext);
|
|
ERR_FAIL_NULL(xrSetDebugUtilsObjectNameEXT_ptr);
|
|
|
|
const XrDebugUtilsObjectNameInfoEXT space_name_info = {
|
|
XR_TYPE_DEBUG_UTILS_OBJECT_NAME_INFO_EXT, // type
|
|
nullptr, // next
|
|
p_object_type, // objectType
|
|
p_object_handle, // objectHandle
|
|
p_object_name, // objectName
|
|
};
|
|
|
|
XrResult result = xrSetDebugUtilsObjectNameEXT_ptr(OpenXRAPI::get_singleton()->get_instance(), &space_name_info);
|
|
if (XR_FAILED(result)) {
|
|
ERR_PRINT("OpenXR: Failed to set object name [" + OpenXRAPI::get_singleton()->get_error_string(result) + "]");
|
|
}
|
|
}
|
|
|
|
void OpenXRDebugUtilsExtension::begin_debug_label_region(const char *p_label_name) {
|
|
ERR_FAIL_COND(!debug_utils_ext);
|
|
ERR_FAIL_NULL(xrSessionBeginDebugUtilsLabelRegionEXT_ptr);
|
|
|
|
const XrDebugUtilsLabelEXT session_active_region_label = {
|
|
XR_TYPE_DEBUG_UTILS_LABEL_EXT, // type
|
|
NULL, // next
|
|
p_label_name, // labelName
|
|
};
|
|
|
|
XrResult result = xrSessionBeginDebugUtilsLabelRegionEXT_ptr(OpenXRAPI::get_singleton()->get_session(), &session_active_region_label);
|
|
if (XR_FAILED(result)) {
|
|
ERR_PRINT("OpenXR: Failed to begin label region [" + OpenXRAPI::get_singleton()->get_error_string(result) + "]");
|
|
}
|
|
}
|
|
|
|
void OpenXRDebugUtilsExtension::end_debug_label_region() {
|
|
ERR_FAIL_COND(!debug_utils_ext);
|
|
ERR_FAIL_NULL(xrSessionEndDebugUtilsLabelRegionEXT_ptr);
|
|
|
|
XrResult result = xrSessionEndDebugUtilsLabelRegionEXT_ptr(OpenXRAPI::get_singleton()->get_session());
|
|
if (XR_FAILED(result)) {
|
|
ERR_PRINT("OpenXR: Failed to end label region [" + OpenXRAPI::get_singleton()->get_error_string(result) + "]");
|
|
}
|
|
}
|
|
|
|
void OpenXRDebugUtilsExtension::insert_debug_label(const char *p_label_name) {
|
|
ERR_FAIL_COND(!debug_utils_ext);
|
|
ERR_FAIL_NULL(xrSessionInsertDebugUtilsLabelEXT_ptr);
|
|
|
|
const XrDebugUtilsLabelEXT session_active_region_label = {
|
|
XR_TYPE_DEBUG_UTILS_LABEL_EXT, // type
|
|
NULL, // next
|
|
p_label_name, // labelName
|
|
};
|
|
|
|
XrResult result = xrSessionInsertDebugUtilsLabelEXT_ptr(OpenXRAPI::get_singleton()->get_session(), &session_active_region_label);
|
|
if (XR_FAILED(result)) {
|
|
ERR_PRINT("OpenXR: Failed to insert label [" + OpenXRAPI::get_singleton()->get_error_string(result) + "]");
|
|
}
|
|
}
|
|
|
|
XrBool32 XRAPI_PTR OpenXRDebugUtilsExtension::_debug_callback(XrDebugUtilsMessageSeverityFlagsEXT p_message_severity, XrDebugUtilsMessageTypeFlagsEXT p_message_types, const XrDebugUtilsMessengerCallbackDataEXT *p_callback_data, void *p_user_data) {
|
|
OpenXRDebugUtilsExtension *debug_utils = OpenXRDebugUtilsExtension::get_singleton();
|
|
|
|
if (debug_utils) {
|
|
return debug_utils->debug_callback(p_message_severity, p_message_types, p_callback_data, p_user_data);
|
|
}
|
|
|
|
return XR_FALSE;
|
|
}
|
|
|
|
XrBool32 OpenXRDebugUtilsExtension::debug_callback(XrDebugUtilsMessageSeverityFlagsEXT p_message_severity, XrDebugUtilsMessageTypeFlagsEXT p_message_types, const XrDebugUtilsMessengerCallbackDataEXT *p_callback_data, void *p_user_data) {
|
|
String msg;
|
|
|
|
ERR_FAIL_NULL_V(p_callback_data, XR_FALSE);
|
|
|
|
if (p_message_types == XR_DEBUG_UTILS_MESSAGE_TYPE_GENERAL_BIT_EXT) {
|
|
msg = ", type: General";
|
|
} else if (p_message_types == XR_DEBUG_UTILS_MESSAGE_TYPE_VALIDATION_BIT_EXT) {
|
|
msg = ", type: Validation";
|
|
} else if (p_message_types == XR_DEBUG_UTILS_MESSAGE_TYPE_PERFORMANCE_BIT_EXT) {
|
|
msg = ", type: Performance";
|
|
} else if (p_message_types == XR_DEBUG_UTILS_MESSAGE_TYPE_CONFORMANCE_BIT_EXT) {
|
|
msg = ", type: Conformance";
|
|
} else {
|
|
msg = ", type: Unknown (" + String::num_uint64(p_message_types) + ")";
|
|
}
|
|
|
|
if (p_callback_data->functionName) {
|
|
msg += ", function Name: " + String(p_callback_data->functionName);
|
|
}
|
|
if (p_callback_data->messageId) {
|
|
msg += "\nMessage ID: " + String(p_callback_data->messageId);
|
|
}
|
|
if (p_callback_data->message) {
|
|
msg += "\nMessage: " + String(p_callback_data->message);
|
|
}
|
|
|
|
if (p_callback_data->objectCount > 0) {
|
|
String objects;
|
|
|
|
for (uint32_t i = 0; i < p_callback_data->objectCount; i++) {
|
|
if (!objects.is_empty()) {
|
|
objects += ", ";
|
|
}
|
|
objects += p_callback_data->objects[i].objectName;
|
|
}
|
|
|
|
msg += "\nObjects: " + objects;
|
|
}
|
|
|
|
if (p_callback_data->sessionLabelCount > 0) {
|
|
String labels;
|
|
|
|
for (uint32_t i = 0; i < p_callback_data->sessionLabelCount; i++) {
|
|
if (!labels.is_empty()) {
|
|
labels += ", ";
|
|
}
|
|
labels += p_callback_data->sessionLabels[i].labelName;
|
|
}
|
|
|
|
msg += "\nLabels: " + labels;
|
|
}
|
|
|
|
if (p_message_severity == XR_DEBUG_UTILS_MESSAGE_SEVERITY_ERROR_BIT_EXT) {
|
|
ERR_PRINT("OpenXR: Severity: Error" + msg);
|
|
} else if (p_message_severity == XR_DEBUG_UTILS_MESSAGE_SEVERITY_WARNING_BIT_EXT) {
|
|
WARN_PRINT("OpenXR: Severity: Warning" + msg);
|
|
} else if (p_message_severity == XR_DEBUG_UTILS_MESSAGE_SEVERITY_INFO_BIT_EXT) {
|
|
print_line("OpenXR: Severity: Info" + msg);
|
|
} else if (p_message_severity == XR_DEBUG_UTILS_MESSAGE_SEVERITY_VERBOSE_BIT_EXT) {
|
|
// This is a bit double because we won't output this unless verbose messaging in Godot is on.
|
|
print_verbose("OpenXR: Severity: Verbose" + msg);
|
|
}
|
|
|
|
return XR_FALSE;
|
|
}
|