2019-06-22 18:34:26 +02:00
|
|
|
/*************************************************************************/
|
|
|
|
/* vulkan_context.h */
|
|
|
|
/*************************************************************************/
|
|
|
|
/* This file is part of: */
|
|
|
|
/* GODOT ENGINE */
|
|
|
|
/* https://godotengine.org */
|
|
|
|
/*************************************************************************/
|
2022-01-03 21:27:34 +01:00
|
|
|
/* Copyright (c) 2007-2022 Juan Linietsky, Ariel Manzur. */
|
|
|
|
/* Copyright (c) 2014-2022 Godot Engine contributors (cf. AUTHORS.md). */
|
2019-06-22 18:34:26 +02:00
|
|
|
/* */
|
|
|
|
/* 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. */
|
|
|
|
/*************************************************************************/
|
|
|
|
|
2019-06-07 18:07:57 +02:00
|
|
|
#ifndef VULKAN_CONTEXT_H
|
|
|
|
#define VULKAN_CONTEXT_H
|
|
|
|
|
2020-11-07 23:33:38 +01:00
|
|
|
#include "core/error/error_list.h"
|
2020-04-19 01:30:57 +02:00
|
|
|
#include "core/os/mutex.h"
|
2020-11-07 23:33:38 +01:00
|
|
|
#include "core/string/ustring.h"
|
|
|
|
#include "core/templates/map.h"
|
|
|
|
#include "core/templates/rid_owner.h"
|
2020-03-04 02:51:12 +01:00
|
|
|
#include "servers/display_server.h"
|
2021-12-10 17:01:51 +01:00
|
|
|
#include "servers/rendering/rendering_device.h"
|
2020-10-27 16:00:15 +01:00
|
|
|
|
2021-08-12 13:24:54 +02:00
|
|
|
#ifdef USE_VOLK
|
|
|
|
#include <volk.h>
|
|
|
|
#else
|
2019-06-07 18:07:57 +02:00
|
|
|
#include <vulkan/vulkan.h>
|
2021-08-12 13:24:54 +02:00
|
|
|
#endif
|
2019-06-07 18:07:57 +02:00
|
|
|
|
|
|
|
class VulkanContext {
|
2021-03-22 11:04:55 +01:00
|
|
|
public:
|
|
|
|
struct SubgroupCapabilities {
|
|
|
|
uint32_t size;
|
|
|
|
VkShaderStageFlags supportedStages;
|
|
|
|
VkSubgroupFeatureFlags supportedOperations;
|
|
|
|
VkBool32 quadOperationsInAllStages;
|
|
|
|
|
|
|
|
uint32_t supported_stages_flags_rd() const;
|
|
|
|
String supported_stages_desc() const;
|
|
|
|
uint32_t supported_operations_flags_rd() const;
|
|
|
|
String supported_operations_desc() const;
|
|
|
|
};
|
|
|
|
|
2021-05-04 07:30:21 +02:00
|
|
|
struct MultiviewCapabilities {
|
|
|
|
bool is_supported;
|
2021-05-07 15:19:04 +02:00
|
|
|
bool geometry_shader_is_supported;
|
|
|
|
bool tessellation_shader_is_supported;
|
|
|
|
uint32_t max_view_count;
|
|
|
|
uint32_t max_instance_count;
|
2021-05-04 07:30:21 +02:00
|
|
|
};
|
|
|
|
|
2021-11-23 22:16:03 +01:00
|
|
|
struct ShaderCapabilities {
|
|
|
|
bool shader_float16_is_supported;
|
|
|
|
};
|
|
|
|
|
|
|
|
struct StorageBufferCapabilities {
|
|
|
|
bool storage_buffer_16_bit_access_is_supported;
|
|
|
|
};
|
|
|
|
|
2021-03-22 11:04:55 +01:00
|
|
|
private:
|
2019-06-07 18:07:57 +02:00
|
|
|
enum {
|
|
|
|
MAX_EXTENSIONS = 128,
|
|
|
|
MAX_LAYERS = 64,
|
|
|
|
FRAME_LAG = 2
|
|
|
|
};
|
|
|
|
|
2020-11-23 17:38:46 +01:00
|
|
|
VkInstance inst = VK_NULL_HANDLE;
|
|
|
|
VkPhysicalDevice gpu = VK_NULL_HANDLE;
|
2019-06-07 18:07:57 +02:00
|
|
|
VkPhysicalDeviceProperties gpu_props;
|
2020-11-23 17:38:46 +01:00
|
|
|
uint32_t queue_family_count = 0;
|
2020-10-27 16:00:15 +01:00
|
|
|
VkQueueFamilyProperties *queue_props = nullptr;
|
2020-11-23 17:38:46 +01:00
|
|
|
VkDevice device = VK_NULL_HANDLE;
|
2020-07-13 18:24:04 +02:00
|
|
|
bool device_initialized = false;
|
|
|
|
bool inst_initialized = false;
|
2019-06-07 18:07:57 +02:00
|
|
|
|
2021-03-22 11:04:55 +01:00
|
|
|
// Vulkan 1.0 doesn't return version info so we assume this by default until we know otherwise
|
|
|
|
uint32_t vulkan_major = 1;
|
|
|
|
uint32_t vulkan_minor = 0;
|
2021-09-14 18:30:24 +02:00
|
|
|
uint32_t vulkan_patch = 0;
|
2021-03-22 11:04:55 +01:00
|
|
|
SubgroupCapabilities subgroup_capabilities;
|
2021-05-04 07:30:21 +02:00
|
|
|
MultiviewCapabilities multiview_capabilities;
|
2021-11-23 22:16:03 +01:00
|
|
|
ShaderCapabilities shader_capabilities;
|
|
|
|
StorageBufferCapabilities storage_buffer_capabilities;
|
2021-03-22 11:04:55 +01:00
|
|
|
|
2021-02-02 20:51:36 +01:00
|
|
|
String device_vendor;
|
|
|
|
String device_name;
|
2021-12-10 17:01:51 +01:00
|
|
|
VkPhysicalDeviceType device_type;
|
2021-02-02 20:51:36 +01:00
|
|
|
String pipeline_cache_id;
|
|
|
|
uint32_t device_api_version = 0;
|
|
|
|
|
2020-10-27 16:00:15 +01:00
|
|
|
bool buffers_prepared = false;
|
|
|
|
|
|
|
|
// Present queue.
|
|
|
|
bool queues_initialized = false;
|
2020-11-23 17:38:46 +01:00
|
|
|
uint32_t graphics_queue_family_index = 0;
|
|
|
|
uint32_t present_queue_family_index = 0;
|
|
|
|
bool separate_present_queue = false;
|
|
|
|
VkQueue graphics_queue = VK_NULL_HANDLE;
|
|
|
|
VkQueue present_queue = VK_NULL_HANDLE;
|
2019-06-07 18:07:57 +02:00
|
|
|
VkColorSpaceKHR color_space;
|
|
|
|
VkFormat format;
|
|
|
|
VkSemaphore draw_complete_semaphores[FRAME_LAG];
|
|
|
|
VkSemaphore image_ownership_semaphores[FRAME_LAG];
|
2020-11-23 17:38:46 +01:00
|
|
|
int frame_index = 0;
|
2019-06-07 18:07:57 +02:00
|
|
|
VkFence fences[FRAME_LAG];
|
|
|
|
VkPhysicalDeviceMemoryProperties memory_properties;
|
2019-07-21 16:31:30 +02:00
|
|
|
VkPhysicalDeviceFeatures physical_device_features;
|
2019-06-07 18:07:57 +02:00
|
|
|
|
|
|
|
typedef struct {
|
|
|
|
VkImage image;
|
|
|
|
VkCommandBuffer graphics_to_present_cmd;
|
|
|
|
VkImageView view;
|
|
|
|
VkFramebuffer framebuffer;
|
|
|
|
} SwapchainImageResources;
|
|
|
|
|
2019-06-24 21:13:06 +02:00
|
|
|
struct Window {
|
2020-06-03 10:45:44 +02:00
|
|
|
VkSurfaceKHR surface = VK_NULL_HANDLE;
|
|
|
|
VkSwapchainKHR swapchain = VK_NULL_HANDLE;
|
|
|
|
SwapchainImageResources *swapchain_image_resources = VK_NULL_HANDLE;
|
|
|
|
VkPresentModeKHR presentMode = VK_PRESENT_MODE_FIFO_KHR;
|
2021-06-28 22:43:10 +02:00
|
|
|
VkSemaphore image_acquired_semaphores[FRAME_LAG];
|
|
|
|
bool semaphore_acquired = false;
|
2020-06-03 10:45:44 +02:00
|
|
|
uint32_t current_buffer = 0;
|
|
|
|
int width = 0;
|
|
|
|
int height = 0;
|
2021-06-19 17:44:59 +02:00
|
|
|
DisplayServer::VSyncMode vsync_mode = DisplayServer::VSYNC_ENABLED;
|
2020-11-23 17:38:46 +01:00
|
|
|
VkCommandPool present_cmd_pool = VK_NULL_HANDLE; // For separate present queue.
|
2020-06-03 10:45:44 +02:00
|
|
|
VkRenderPass render_pass = VK_NULL_HANDLE;
|
2019-06-24 21:13:06 +02:00
|
|
|
};
|
|
|
|
|
2020-04-19 01:30:57 +02:00
|
|
|
struct LocalDevice {
|
|
|
|
bool waiting = false;
|
2020-11-23 17:38:46 +01:00
|
|
|
VkDevice device = VK_NULL_HANDLE;
|
|
|
|
VkQueue queue = VK_NULL_HANDLE;
|
2020-04-19 01:30:57 +02:00
|
|
|
};
|
|
|
|
|
|
|
|
RID_Owner<LocalDevice, true> local_device_owner;
|
|
|
|
|
2020-03-04 02:51:12 +01:00
|
|
|
Map<DisplayServer::WindowID, Window> windows;
|
2020-10-27 16:00:15 +01:00
|
|
|
uint32_t swapchainImageCount = 0;
|
2019-06-07 18:07:57 +02:00
|
|
|
|
2020-10-27 16:00:15 +01:00
|
|
|
// Commands.
|
2019-06-07 18:07:57 +02:00
|
|
|
|
2020-11-23 17:38:46 +01:00
|
|
|
bool prepared = false;
|
2019-06-07 18:07:57 +02:00
|
|
|
|
2020-10-27 16:00:15 +01:00
|
|
|
Vector<VkCommandBuffer> command_buffer_queue;
|
|
|
|
int command_buffer_count = 1;
|
|
|
|
|
|
|
|
// Extensions.
|
|
|
|
|
|
|
|
bool VK_KHR_incremental_present_enabled = true;
|
|
|
|
bool VK_GOOGLE_display_timing_enabled = true;
|
|
|
|
uint32_t enabled_extension_count = 0;
|
2019-06-07 18:07:57 +02:00
|
|
|
const char *extension_names[MAX_EXTENSIONS];
|
2021-01-24 07:21:54 +01:00
|
|
|
bool enabled_debug_utils = false;
|
2020-10-27 16:00:15 +01:00
|
|
|
|
2021-03-22 18:38:25 +01:00
|
|
|
/**
|
|
|
|
* True if VK_EXT_debug_report extension is used. VK_EXT_debug_report is deprecated but it is
|
|
|
|
* still used if VK_EXT_debug_utils is not available.
|
|
|
|
*/
|
|
|
|
bool enabled_debug_report = false;
|
|
|
|
|
2019-06-07 18:07:57 +02:00
|
|
|
PFN_vkCreateDebugUtilsMessengerEXT CreateDebugUtilsMessengerEXT;
|
|
|
|
PFN_vkDestroyDebugUtilsMessengerEXT DestroyDebugUtilsMessengerEXT;
|
|
|
|
PFN_vkSubmitDebugUtilsMessageEXT SubmitDebugUtilsMessageEXT;
|
|
|
|
PFN_vkCmdBeginDebugUtilsLabelEXT CmdBeginDebugUtilsLabelEXT;
|
|
|
|
PFN_vkCmdEndDebugUtilsLabelEXT CmdEndDebugUtilsLabelEXT;
|
|
|
|
PFN_vkCmdInsertDebugUtilsLabelEXT CmdInsertDebugUtilsLabelEXT;
|
|
|
|
PFN_vkSetDebugUtilsObjectNameEXT SetDebugUtilsObjectNameEXT;
|
2021-03-22 18:38:25 +01:00
|
|
|
PFN_vkCreateDebugReportCallbackEXT CreateDebugReportCallbackEXT;
|
|
|
|
PFN_vkDebugReportMessageEXT DebugReportMessageEXT;
|
|
|
|
PFN_vkDestroyDebugReportCallbackEXT DestroyDebugReportCallbackEXT;
|
2019-06-07 18:07:57 +02:00
|
|
|
PFN_vkGetPhysicalDeviceSurfaceSupportKHR fpGetPhysicalDeviceSurfaceSupportKHR;
|
|
|
|
PFN_vkGetPhysicalDeviceSurfaceCapabilitiesKHR fpGetPhysicalDeviceSurfaceCapabilitiesKHR;
|
|
|
|
PFN_vkGetPhysicalDeviceSurfaceFormatsKHR fpGetPhysicalDeviceSurfaceFormatsKHR;
|
|
|
|
PFN_vkGetPhysicalDeviceSurfacePresentModesKHR fpGetPhysicalDeviceSurfacePresentModesKHR;
|
|
|
|
PFN_vkCreateSwapchainKHR fpCreateSwapchainKHR;
|
|
|
|
PFN_vkDestroySwapchainKHR fpDestroySwapchainKHR;
|
|
|
|
PFN_vkGetSwapchainImagesKHR fpGetSwapchainImagesKHR;
|
|
|
|
PFN_vkAcquireNextImageKHR fpAcquireNextImageKHR;
|
|
|
|
PFN_vkQueuePresentKHR fpQueuePresentKHR;
|
|
|
|
PFN_vkGetRefreshCycleDurationGOOGLE fpGetRefreshCycleDurationGOOGLE;
|
|
|
|
PFN_vkGetPastPresentationTimingGOOGLE fpGetPastPresentationTimingGOOGLE;
|
|
|
|
|
2020-11-23 17:38:46 +01:00
|
|
|
VkDebugUtilsMessengerEXT dbg_messenger = VK_NULL_HANDLE;
|
2021-03-22 18:38:25 +01:00
|
|
|
VkDebugReportCallbackEXT dbg_debug_report = VK_NULL_HANDLE;
|
2019-06-07 18:07:57 +02:00
|
|
|
|
2021-03-22 11:04:55 +01:00
|
|
|
Error _obtain_vulkan_version();
|
2019-06-07 18:07:57 +02:00
|
|
|
Error _initialize_extensions();
|
2021-03-22 11:04:55 +01:00
|
|
|
Error _check_capabilities();
|
2019-06-07 18:07:57 +02:00
|
|
|
|
2021-03-22 18:38:25 +01:00
|
|
|
VkBool32 _check_layers(uint32_t check_count, const char *const *check_names, uint32_t layer_count, VkLayerProperties *layers);
|
2020-10-27 16:00:15 +01:00
|
|
|
static VKAPI_ATTR VkBool32 VKAPI_CALL _debug_messenger_callback(
|
|
|
|
VkDebugUtilsMessageSeverityFlagBitsEXT messageSeverity,
|
2019-06-07 18:07:57 +02:00
|
|
|
VkDebugUtilsMessageTypeFlagsEXT messageType,
|
|
|
|
const VkDebugUtilsMessengerCallbackDataEXT *pCallbackData,
|
|
|
|
void *pUserData);
|
|
|
|
|
2021-03-22 18:38:25 +01:00
|
|
|
static VKAPI_ATTR VkBool32 VKAPI_CALL _debug_report_callback(
|
|
|
|
VkDebugReportFlagsEXT flags,
|
|
|
|
VkDebugReportObjectTypeEXT objectType,
|
|
|
|
uint64_t object,
|
|
|
|
size_t location,
|
|
|
|
int32_t messageCode,
|
|
|
|
const char *pLayerPrefix,
|
|
|
|
const char *pMessage,
|
|
|
|
void *pUserData);
|
|
|
|
|
2019-06-07 18:07:57 +02:00
|
|
|
Error _create_physical_device();
|
2019-06-24 21:13:06 +02:00
|
|
|
|
2021-06-28 22:43:10 +02:00
|
|
|
Error _initialize_queues(VkSurfaceKHR p_surface);
|
2019-06-24 21:13:06 +02:00
|
|
|
|
2019-06-07 18:07:57 +02:00
|
|
|
Error _create_device();
|
|
|
|
|
2019-06-24 21:13:06 +02:00
|
|
|
Error _clean_up_swap_chain(Window *window);
|
|
|
|
|
|
|
|
Error _update_swap_chain(Window *window);
|
2019-06-07 18:07:57 +02:00
|
|
|
|
2019-06-24 21:13:06 +02:00
|
|
|
Error _create_swap_chain();
|
|
|
|
Error _create_semaphores();
|
2019-06-07 18:07:57 +02:00
|
|
|
|
|
|
|
protected:
|
|
|
|
virtual const char *_get_platform_surface_extension() const = 0;
|
2020-10-27 16:00:15 +01:00
|
|
|
|
2021-06-19 17:44:59 +02:00
|
|
|
virtual Error _window_create(DisplayServer::WindowID p_window_id, DisplayServer::VSyncMode p_vsync_mode, VkSurfaceKHR p_surface, int p_width, int p_height);
|
2019-06-24 21:13:06 +02:00
|
|
|
|
2021-03-22 18:38:25 +01:00
|
|
|
virtual bool _use_validation_layers();
|
|
|
|
|
|
|
|
Error _get_preferred_validation_layers(uint32_t *count, const char *const **names);
|
|
|
|
|
2019-06-07 18:07:57 +02:00
|
|
|
public:
|
2021-03-22 11:04:55 +01:00
|
|
|
uint32_t get_vulkan_major() const { return vulkan_major; };
|
|
|
|
uint32_t get_vulkan_minor() const { return vulkan_minor; };
|
|
|
|
SubgroupCapabilities get_subgroup_capabilities() const { return subgroup_capabilities; };
|
2021-05-04 07:30:21 +02:00
|
|
|
MultiviewCapabilities get_multiview_capabilities() const { return multiview_capabilities; };
|
2021-11-23 22:16:03 +01:00
|
|
|
ShaderCapabilities get_shader_capabilities() const { return shader_capabilities; };
|
|
|
|
StorageBufferCapabilities get_storage_buffer_capabilities() const { return storage_buffer_capabilities; };
|
2021-03-22 11:04:55 +01:00
|
|
|
|
2019-06-07 18:07:57 +02:00
|
|
|
VkDevice get_device();
|
|
|
|
VkPhysicalDevice get_physical_device();
|
2021-08-13 00:02:20 +02:00
|
|
|
VkInstance get_instance() { return inst; }
|
2019-06-24 21:13:06 +02:00
|
|
|
int get_swapchain_image_count() const;
|
2021-08-29 04:52:19 +02:00
|
|
|
VkQueue get_graphics_queue() const;
|
|
|
|
uint32_t get_graphics_queue_family_index() const;
|
2019-06-07 18:07:57 +02:00
|
|
|
|
2020-03-04 02:51:12 +01:00
|
|
|
void window_resize(DisplayServer::WindowID p_window_id, int p_width, int p_height);
|
|
|
|
int window_get_width(DisplayServer::WindowID p_window = 0);
|
|
|
|
int window_get_height(DisplayServer::WindowID p_window = 0);
|
|
|
|
void window_destroy(DisplayServer::WindowID p_window_id);
|
|
|
|
VkFramebuffer window_get_framebuffer(DisplayServer::WindowID p_window = 0);
|
|
|
|
VkRenderPass window_get_render_pass(DisplayServer::WindowID p_window = 0);
|
2019-06-07 18:07:57 +02:00
|
|
|
|
2020-04-19 01:30:57 +02:00
|
|
|
RID local_device_create();
|
|
|
|
VkDevice local_device_get_vk_device(RID p_local_device);
|
|
|
|
void local_device_push_command_buffers(RID p_local_device, const VkCommandBuffer *p_buffers, int p_count);
|
|
|
|
void local_device_sync(RID p_local_device);
|
|
|
|
void local_device_free(RID p_local_device);
|
|
|
|
|
2019-06-07 18:07:57 +02:00
|
|
|
VkFormat get_screen_format() const;
|
|
|
|
VkPhysicalDeviceLimits get_device_limits() const;
|
|
|
|
|
|
|
|
void set_setup_buffer(const VkCommandBuffer &pCommandBuffer);
|
|
|
|
void append_command_buffer(const VkCommandBuffer &pCommandBuffer);
|
|
|
|
void resize_notify();
|
|
|
|
void flush(bool p_flush_setup = false, bool p_flush_pending = false);
|
2019-06-24 21:13:06 +02:00
|
|
|
Error prepare_buffers();
|
2019-06-07 18:07:57 +02:00
|
|
|
Error swap_buffers();
|
2019-06-24 21:13:06 +02:00
|
|
|
Error initialize();
|
2019-06-22 18:34:26 +02:00
|
|
|
|
2021-01-24 07:21:54 +01:00
|
|
|
void command_begin_label(VkCommandBuffer p_command_buffer, String p_label_name, const Color p_color);
|
|
|
|
void command_insert_label(VkCommandBuffer p_command_buffer, String p_label_name, const Color p_color);
|
|
|
|
void command_end_label(VkCommandBuffer p_command_buffer);
|
|
|
|
void set_object_name(VkObjectType p_object_type, uint64_t p_object_handle, String p_object_name);
|
|
|
|
|
2021-02-02 20:51:36 +01:00
|
|
|
String get_device_vendor_name() const;
|
|
|
|
String get_device_name() const;
|
2021-12-10 17:01:51 +01:00
|
|
|
RenderingDevice::DeviceType get_device_type() const;
|
2021-02-02 20:51:36 +01:00
|
|
|
String get_device_pipeline_cache_uuid() const;
|
|
|
|
|
2021-06-19 17:44:59 +02:00
|
|
|
void set_vsync_mode(DisplayServer::WindowID p_window, DisplayServer::VSyncMode p_mode);
|
|
|
|
DisplayServer::VSyncMode get_vsync_mode(DisplayServer::WindowID p_window = 0) const;
|
|
|
|
|
2019-06-07 18:07:57 +02:00
|
|
|
VulkanContext();
|
2019-06-22 18:34:26 +02:00
|
|
|
virtual ~VulkanContext();
|
2019-06-07 18:07:57 +02:00
|
|
|
};
|
|
|
|
|
|
|
|
#endif // VULKAN_DEVICE_H
|