Create Device

Author: karnkaul

guide/src/SUMMARY.md

@@ -13,3 +13,4 @@
   - [Vulkan Instance](initialization/instance.md)
   - [Vulkan Surface](initialization/surface.md)
   - [Vulkan Physical Device](initialization/gpu.md)
+  - [Vulkan Device](initialization/device.md)

guide/src/initialization/device.md

@@ -0,0 +1,59 @@
+# Vulkan Device
+
+A [Vulkan Device](https://registry.khronos.org/vulkan/specs/latest/man/html/VkDevice.html) is a logical instance of a Physical Device, and will the primary interface for everything Vulkan now onwards. [Vulkan Queues](https://registry.khronos.org/vulkan/specs/latest/man/html/VkQueue.html) are owned by the Device, we will need one from the queue family stored in the `Gpu`, to submit recorded command buffers. We also need to explicitly declare all features we want to use, eg [Dynamic Rendering](https://registry.khronos.org/vulkan/specs/latest/man/html/VK_KHR_dynamic_rendering.html) and [Synchronization2](https://registry.khronos.org/vulkan/specs/latest/man/html/VK_KHR_synchronization2.html).
+
+Setup a `vk::QueueCreateInfo` object:
+
+```cpp
+	auto queue_ci = vk::DeviceQueueCreateInfo{};
+	// since we use only one queue, it has the entire priority range, ie, 1.0
+	static constexpr auto queue_priorities_v = std::array{1.0f};
+	queue_ci.setQueueFamilyIndex(m_gpu.queue_family)
+		.setQueueCount(1)
+		.setQueuePriorities(queue_priorities_v);
+```
+
+Setup the core device features:
+
+```cpp
+	auto enabled_features = vk::PhysicalDeviceFeatures{};
+	enabled_features.fillModeNonSolid = m_gpu.features.fillModeNonSolid;
+	enabled_features.wideLines = m_gpu.features.wideLines;
+	enabled_features.samplerAnisotropy = m_gpu.features.samplerAnisotropy;
+	enabled_features.sampleRateShading = m_gpu.features.sampleRateShading;
+```
+
+Setup the additional features, using `setPNext()` to chain them:
+
+```cpp
+	auto sync_feature = vk::PhysicalDeviceSynchronization2Features{vk::True};
+	auto dynamic_rendering_feature =
+		vk::PhysicalDeviceDynamicRenderingFeatures{vk::True};
+	sync_feature.setPNext(&dynamic_rendering_feature);
+```
+
+Setup a `vk::DeviceCreateInfo` object:
+
+```cpp
+	auto device_ci = vk::DeviceCreateInfo{};
+	static constexpr auto extensions_v =
+		std::array{VK_KHR_SWAPCHAIN_EXTENSION_NAME};
+	device_ci.setPEnabledExtensionNames(extensions_v)
+		.setQueueCreateInfos(queue_ci)
+		.setPEnabledFeatures(&enabled_features)
+		.setPNext(&sync_feature);
+```
+
+Declare a `vk::UniqueDevice` member after `m_gpu`, create it, and initialize the dispatcher against it:
+
+```cpp
+	m_device = m_gpu.device.createDeviceUnique(device_ci);
+	VULKAN_HPP_DEFAULT_DISPATCHER.init(*m_device);
+```
+
+Declare a `vk::Queue` member (order doesn't matter since it's just a handle, the actual Queue is owned by the Device) and initialize it:
+
+```cpp
+	static constexpr std::uint32_t queue_index_v{0};
+	m_queue = m_device->getQueue(m_gpu.queue_family, queue_index_v);
+```

src/app.cpp

@@ -9,6 +9,7 @@ void App::run() {
 	create_instance();
 	create_surface();
 	select_gpu();
+	create_device();
 
 	main_loop();
 }
@@ -46,6 +47,41 @@ void App::select_gpu() {
 				 std::string_view{m_gpu.properties.deviceName});
 }
 
+void App::create_device() {
+	auto queue_ci = vk::DeviceQueueCreateInfo{};
+	// since we use only one queue, it has the entire priority range, ie, 1.0
+	static constexpr auto queue_priorities_v = std::array{1.0f};
+	queue_ci.setQueueFamilyIndex(m_gpu.queue_family)
+		.setQueueCount(1)
+		.setQueuePriorities(queue_priorities_v);
+
+	auto enabled_features = vk::PhysicalDeviceFeatures{};
+	enabled_features.fillModeNonSolid = m_gpu.features.fillModeNonSolid;
+	enabled_features.wideLines = m_gpu.features.wideLines;
+	enabled_features.samplerAnisotropy = m_gpu.features.samplerAnisotropy;
+	enabled_features.sampleRateShading = m_gpu.features.sampleRateShading;
+
+	auto sync_feature = vk::PhysicalDeviceSynchronization2Features{vk::True};
+	auto dynamic_rendering_feature =
+		vk::PhysicalDeviceDynamicRenderingFeatures{vk::True};
+	sync_feature.setPNext(&dynamic_rendering_feature);
+
+	auto device_ci = vk::DeviceCreateInfo{};
+	static constexpr auto extensions_v =
+		std::array{VK_KHR_SWAPCHAIN_EXTENSION_NAME};
+	device_ci.setPEnabledExtensionNames(extensions_v)
+		.setQueueCreateInfos(queue_ci)
+		.setPEnabledFeatures(&enabled_features)
+		.setPNext(&sync_feature);
+
+	m_device = m_gpu.device.createDeviceUnique(device_ci);
+	VULKAN_HPP_DEFAULT_DISPATCHER.init(*m_device);
+	static constexpr std::uint32_t queue_index_v{0};
+	m_queue = m_device->getQueue(m_gpu.queue_family, queue_index_v);
+
+	// m_device_block.get() = *m_device;
+}
+
 void App::main_loop() {
 	while (glfwWindowShouldClose(m_window.get()) == GLFW_FALSE) {
 		glfwPollEvents();

src/app.hpp

@@ -13,12 +13,15 @@ class App {
 	void create_instance();
 	void create_surface();
 	void select_gpu();
+	void create_device();
 
 	void main_loop();
 
 	glfw::Window m_window{};
 	vk::UniqueInstance m_instance{};
 	vk::UniqueSurfaceKHR m_surface{};
 	Gpu m_gpu{};
+	vk::UniqueDevice m_device{};
+	vk::Queue m_queue{};
 };
 } // namespace lvk