MayaFlux 0.5.0
Digital-First Multimedia Processing Framework
Loading...
Searching...
No Matches

◆ create_logical_device()

bool MayaFlux::Core::VKDevice::create_logical_device ( vk::Instance  instance,
const GraphicsBackendInfo backend_info 
)
private

Create the logical device and retrieve queue handles.

Parameters
instanceVulkan instance
backend_infoGraphics backend configuration
Returns
true if logical device creation succeeded

Definition at line 625 of file VKDevice.cpp.

626{
627 if (!m_queue_families.graphics_family.has_value()) {
629 std::source_location::current(),
630 "No graphics queue family found!");
631 }
632
633 std::set<uint32_t> unique_queue_families;
634 unique_queue_families.insert(m_queue_families.graphics_family.value());
635
636 if (m_queue_families.compute_family.has_value()) {
637 unique_queue_families.insert(m_queue_families.compute_family.value());
638 }
639
641 unique_queue_families.insert(m_queue_families.transfer_family.value());
642 }
643
644 for (uint32_t f = 0; f < QueueFamilyIndices::MAX_TRACKED_FAMILIES; ++f) {
646 unique_queue_families.insert(f);
647 }
648
649 std::vector<vk::DeviceQueueCreateInfo> queue_create_infos;
650 float queue_priority = 1.0F;
651
652 for (uint32_t queue_family : unique_queue_families) {
653 vk::DeviceQueueCreateInfo queue_create_info {};
654 queue_create_info.queueFamilyIndex = queue_family;
655 queue_create_info.queueCount = 1;
656 queue_create_info.pQueuePriorities = &queue_priority;
657 queue_create_infos.push_back(queue_create_info);
658 }
659
660 vk::PhysicalDeviceFeatures device_features {};
661 device_features.samplerAnisotropy = backend_info.required_features.sampler_anisotropy;
662 device_features.geometryShader = backend_info.required_features.geometry_shaders;
663 device_features.tessellationShader = backend_info.required_features.tessellation_shaders;
664 device_features.multiViewport = backend_info.required_features.multi_viewport;
665 device_features.fillModeNonSolid = backend_info.required_features.fill_mode_non_solid;
666
667 std::vector<const char*> device_extensions = { VK_KHR_SWAPCHAIN_EXTENSION_NAME };
668
669 auto supported_extensions = m_physical_device.enumerateDeviceExtensionProperties();
670
671 auto is_supported = [&supported_extensions](std::string_view name) {
672 return std::ranges::any_of(supported_extensions, [name](const auto& ext) {
673 return name == ext.extensionName.data();
674 });
675 };
676
677#ifdef MAYAFLUX_PLATFORM_MACOS
678 if (is_supported("VK_KHR_portability_subset")) {
679 device_extensions.push_back("VK_KHR_portability_subset");
680 }
681
682 auto feature_chain = vk::StructureChain {
683 vk::PhysicalDeviceFeatures2 {},
684 vk::PhysicalDeviceVulkan13Features {},
685 vk::PhysicalDeviceVulkan12Features {}
686 };
687
688#else
690 device_extensions.push_back(VK_EXT_MESH_SHADER_EXTENSION_NAME);
691 }
692
693 auto feature_chain = vk::StructureChain {
694 vk::PhysicalDeviceFeatures2 {},
695 vk::PhysicalDeviceVulkan13Features {},
696 vk::PhysicalDeviceVulkan12Features {},
697 vk::PhysicalDeviceMeshShaderFeaturesEXT {}
698 };
699
701 feature_chain.unlink<vk::PhysicalDeviceMeshShaderFeaturesEXT>();
702 } else {
703 feature_chain.get<vk::PhysicalDeviceMeshShaderFeaturesEXT>().taskShader = VK_TRUE;
704 feature_chain.get<vk::PhysicalDeviceMeshShaderFeaturesEXT>().meshShader = VK_TRUE;
705 }
706#endif
707
708 feature_chain.get<vk::PhysicalDeviceFeatures2>().features = device_features;
709 feature_chain.get<vk::PhysicalDeviceVulkan13Features>().dynamicRendering = VK_TRUE;
710 feature_chain.get<vk::PhysicalDeviceVulkan13Features>().synchronization2 = VK_TRUE;
711 feature_chain.get<vk::PhysicalDeviceVulkan12Features>().bufferDeviceAddress = VK_TRUE;
712
713 std::vector<std::string> missing_required;
714
715 for (const auto& ext : backend_info.required_extensions) {
716 if (is_supported(ext)) {
717 device_extensions.push_back(ext.c_str());
718 } else {
719 missing_required.push_back(ext);
720 }
721 }
722
723 if (!missing_required.empty()) {
724 std::string names;
725 for (const auto& ext : missing_required) {
726 if (!names.empty())
727 names += ", ";
728 names += ext;
729 }
730
732 std::source_location::current(),
733 "Device '{}' does not support required extension(s): {}",
734 m_device_name, names);
735 }
736
737 for (const auto& ext : backend_info.optional_extensions) {
738 if (is_supported(ext)) {
739 device_extensions.push_back(ext.c_str());
740 } else {
742 "Device '{}' does not support optional extension '{}'; skipping",
743 m_device_name, ext);
744 }
745 }
746
747 vk::DeviceCreateInfo create_info {};
748 create_info.queueCreateInfoCount = static_cast<uint32_t>(queue_create_infos.size());
749 create_info.pQueueCreateInfos = queue_create_infos.data();
750 create_info.pNext = &feature_chain.get<vk::PhysicalDeviceFeatures2>();
751 create_info.enabledExtensionCount = static_cast<uint32_t>(device_extensions.size());
752 create_info.ppEnabledExtensionNames = device_extensions.data();
753
754 try {
755 m_logical_device = m_physical_device.createDevice(create_info);
756 VULKAN_HPP_DEFAULT_DISPATCHER.init(m_logical_device);
757
758 } catch (const std::exception& e) {
760 std::source_location::current(),
761 "Failed to create logical device: {}", e.what());
762 }
763
765
766 if (backend_info.enable_compute_queue && m_queue_families.compute_family.has_value()) {
768 } else {
770 }
771
772 if (backend_info.enable_transfer_queue && m_queue_families.transfer_family.has_value()) {
774 } else {
776 }
777
778 for (uint32_t f = 0; f < QueueFamilyIndices::MAX_TRACKED_FAMILIES; ++f) {
780 m_present_queues[f] = m_logical_device.getQueue(f, 0);
781 }
782
783 return true;
784}
#define MF_WARN(comp, ctx,...)
std::string name
Definition VKDevice.cpp:143
bool m_supports_mesh_shaders
Whether the device supports mesh shaders.
Definition VKDevice.hpp:209
vk::PhysicalDevice m_physical_device
Selected physical device (GPU)
Definition VKDevice.hpp:172
vk::Queue m_compute_queue
Compute queue handle.
Definition VKDevice.hpp:176
vk::Queue m_transfer_queue
Transfer queue handle.
Definition VKDevice.hpp:177
vk::Device m_logical_device
Logical device handle.
Definition VKDevice.hpp:173
std::unordered_map< uint32_t, vk::Queue > m_present_queues
One queue per presentation-capable family.
Definition VKDevice.hpp:206
std::string m_device_name
Selected device name, cached for logging.
Definition VKDevice.hpp:207
vk::Queue m_graphics_queue
Graphics queue handle.
Definition VKDevice.hpp:175
QueueFamilyIndices m_queue_families
Indices of required queue families.
Definition VKDevice.hpp:179
@ GraphicsBackend
Graphics/visual rendering backend (Vulkan, OpenGL)
void error_rethrow(Component component, Context context, std::source_location location=std::source_location::current(), std::string_view additional_context="")
Catch and log an exception, then rethrow it.
@ Core
Core engine, backend, subsystems.
static constexpr uint32_t MAX_TRACKED_FAMILIES
Width of present_family_mask.
Definition VKDevice.hpp:18
bool can_present(uint32_t index) const
Whether family index can present.
Definition VKDevice.hpp:33
std::optional< uint32_t > transfer_family
Definition VKDevice.hpp:22
std::optional< uint32_t > graphics_family
Definition VKDevice.hpp:20
std::optional< uint32_t > compute_family
Definition VKDevice.hpp:21

References MayaFlux::Core::QueueFamilyIndices::can_present(), MayaFlux::Core::QueueFamilyIndices::compute_family, MayaFlux::Journal::Core, MayaFlux::Core::GraphicsBackendInfo::enable_compute_queue, MayaFlux::Core::GraphicsBackendInfo::enable_transfer_queue, MayaFlux::Core::GraphicsBackendInfo::fill_mode_non_solid, MayaFlux::Core::GraphicsBackendInfo::geometry_shaders, MayaFlux::Core::QueueFamilyIndices::graphics_family, MayaFlux::Journal::GraphicsBackend, m_compute_queue, m_device_name, m_graphics_queue, m_logical_device, m_physical_device, m_present_queues, m_queue_families, m_supports_mesh_shaders, m_transfer_queue, MayaFlux::Core::QueueFamilyIndices::MAX_TRACKED_FAMILIES, MF_WARN, MayaFlux::Core::GraphicsBackendInfo::multi_viewport, name, MayaFlux::Core::GraphicsBackendInfo::optional_extensions, MayaFlux::Core::GraphicsBackendInfo::required_extensions, MayaFlux::Core::GraphicsBackendInfo::required_features, MayaFlux::Core::GraphicsBackendInfo::sampler_anisotropy, MayaFlux::Core::GraphicsBackendInfo::tessellation_shaders, and MayaFlux::Core::QueueFamilyIndices::transfer_family.

Referenced by initialize().

+ Here is the call graph for this function:
+ Here is the caller graph for this function: