Vulkan Tutorial 07 Window surface
操作系统:Windows8.1
显卡:Nivida GTX965M
开发工具:Visual Studio 2017
到目前为止,我们了解到Vulkan是一个与平台特性无关联的API集合。它不能直接与窗口系统进行交互。为了将渲染结果呈现到屏幕,需要建立Vulkan与窗体系统之间的连接,我们需要使用WSI(窗体系统集成)扩展。在本小节中,我们将讨论第一个,即VK_KHR_surface。它暴露了VkSurfaceKHR,它代表surface的一个抽象类型,用以呈现渲染图像使用。我们程序中将要使用到的surface是由我们已经引入的GLFW扩展及其打开的相关窗体支持的。简单来说surface就是Vulkan与窗体系统的连接桥梁。
VK_KHR_surface扩展是一个instance级扩展,我们目前为止已经启用过它,它包含在glfwGetRequiredInstanceExtensions返回的列表中。该列表还包括将在接下来几小节中使用的一些其他WSI扩展。
需要在instance创建之后立即创建窗体surface,因为它会影响物理设备的选择。之所以在本小节将surface创建逻辑纳入讨论范围,是因为窗体surface对于渲染、呈现方式是一个比较大的课题,如果过早的在创建物理设备加入这部分内容,会混淆基本的物理设备设置工作。另外窗体surface本身对于Vulkan也是非强制的。Vulkan允许这样做,不需要同OpenGL一样必须要创建窗体surface。
Window surface creation
现在开始着手创建窗体surface,在类成员debugCallback下加入成员变量surface。
VkSurfaceKHR surface;
虽然VkSurfaceKHR对象及其用法与平台无关联,但创建过程需要依赖具体的窗体系统的细节。比如,在Windows平台中,它需要WIndows上的HWND和HMODULE句柄。因此针对特定平台提供相应的扩展,在Windows上为VK_KHR_win32_surface,它自动包含在glfwGetRequiredInstanceExtensions列表中。
我们将会演示如何使用特定平台的扩展来创建Windows上的surface桥,但是不会在教程中实际使用它。使用GLFW这样的库避免了编写没有任何意义的跨平台相关代码。GLFW实际上通过glfwCreateWindowSurface很好的处理了平台差异性。当然了,比较理想是在依赖它们帮助我们完成具体工作之前,了解一下背后的实现是有帮助的。
因为一个窗体surface是一个Vulkan对象,它需要填充VkWin32SurfaceCreateInfoKHR结构体,这里有两个比较重要的参数:hwnd和hinstance。如果熟悉windows下开发应该知道,这些是窗口和进程的句柄。
VkWin32SurfaceCreateInfoKHR createInfo; createInfo.sType = VK_STRUCTURE_TYPE_WIN32_SURFACE_CREATE_INFO_KHR; createInfo.hwnd = glfwGetWin32Window(window); createInfo.hinstance = GetModuleHandle(nullptr);
glfwGetWin32Window函数用于从GLFW窗体对象获取原始的HWND。GetModuleHandle函数返回当前进程的HINSTANCE句柄。
填充完结构体之后,可以利用vkCreateWin32SurfaceKHR创建surface桥,和之前获取创建、销毁DebugReportCallEXT一样,这里同样需要通过instance获取创建surface用到的函数。这里涉及到的参数分别为instance, surface创建的信息,自定义分配器和最终保存surface的句柄变量。
auto CreateWin32SurfaceKHR = (PFN_vkCreateWin32SurfaceKHR) vkGetInstanceProcAddr(instance, "vkCreateWin32SurfaceKHR"); if (!CreateWin32SurfaceKHR || CreateWin32SurfaceKHR(instance, &createInfo, nullptr, &surface) != VK_SUCCESS) { throw std::runtime_error("failed to create window surface!"); }
该过程与其他平台类似,比如Linux,使用X11界面窗体系统,可以通过vkCreateXcbSurfaceKHR函数建立连接。
glfwCreateWindowSurface函数根据不同平台的差异性,在实现细节上会有所不同。我们现在将其整合到我们的程序中。从initVulkan中添加一个函数createSurface,安排在createInstnace和setupDebugCallback函数之后。
void initVulkan() { createInstance(); setupDebugCallback(); createSurface(); pickPhysicalDevice(); createLogicalDevice(); } void createSurface() { }
GLFW没有使用结构体,而是选择非常直接的参数传递来调用函数。
void createSurface() { if (glfwCreateWindowSurface(instance, window, nullptr, &surface) != VK_SUCCESS) { throw std::runtime_error("failed to create window surface!"); } }
参数是VkInstance,GLFW窗体的指针,自定义分配器和用于存储VkSurfaceKHR变量的指针。对于不同平台统一返回VkResult。GLFW没有提供专用的函数销毁surface,但是可以简单的通过Vulkan原始的API完成:
void cleanup() { ... vkDestroySurfaceKHR(instance, surface, nullptr); vkDestroyInstance(instance, nullptr); ... }
最后请确保surface的清理是在instance销毁之前完成。
Querying for presentation support
虽然Vulkan的实现支持窗体集成功能,但是并不意味着系统中的每一个物理设备都支持它。因此,我们需要扩展isDeviceSuitable函数,确保设备可以将图像呈现到我们创建的surface。由于presentation是一个队列的特性功能,因此解决问题的方法就是找到支持presentation的队列簇,最终获取队列满足surface创建的需要。
实际情况是,支持graphics命令的的队列簇和支持presentation命令的队列簇可能不是同一个簇。因此,我们需要修改QueueFamilyIndices结构体,以支持差异化的存储。
struct QueueFamilyIndices { int graphicsFamily = -1; int presentFamily = -1; bool isComplete() { return graphicsFamily >= 0 && presentFamily >= 0; } };
接下来,我们修改findQueueFamilies函数来查找具备presentation功能的队列簇。函数中用于检查的核心代码是vkGetPhysicalDeviceSurfaceSupportKHR,它将物理设备、队列簇索引和surface作为参数。在VK_QUEUE_GRAPHICS_BIT相同的循环体中添加函数的调用:
VkBool32 presentSupport = false; vkGetPhysicalDeviceSurfaceSupportKHR(device, i, surface, &presentSupport);
然后之需要检查布尔值并存储presentation队列簇的索引:
if (queueFamily.queueCount > 0 && presentSupport) { indices.presentFamily = i; }
需要注意的是,为了支持graphics和presentation功能,我们实际环境中得到的可能是同一个队列簇,也可能不同,为此在我们的程序数据结构及选择逻辑中,将按照均来自不同的队列簇分别处理,这样便可以统一处理以上两种情况。除此之外,出于性能的考虑,我们也可以通过添加逻辑明确的指定物理设备所使用的graphics和presentation功能来自同一个队列簇。
Creating the presentation queue
剩下的事情是修改逻辑设备创建过程,在于创建presentation队列并获取VkQueue的句柄。添加保存队列句柄的成员变量:
VkQueue presentQueue;
接下来,我们需要多个VkDeviceQueueCreateInfo结构来创建不同功能的队列。一个优雅的方式是针对不同功能的队列簇创建一个set集合确保队列簇的唯一性:
#include <set> ... QueueFamilyIndices indices = findQueueFamilies(physicalDevice); std::vector<VkDeviceQueueCreateInfo> queueCreateInfos; std::set<int> uniqueQueueFamilies = {indices.graphicsFamily, indices.presentFamily}; float queuePriority = 1.0f; for (int queueFamily : uniqueQueueFamilies) { VkDeviceQueueCreateInfo queueCreateInfo = {}; queueCreateInfo.sType = VK_STRUCTURE_TYPE_DEVICE_QUEUE_CREATE_INFO; queueCreateInfo.queueFamilyIndex = queueFamily; queueCreateInfo.queueCount = 1; queueCreateInfo.pQueuePriorities = &queuePriority; queueCreateInfos.push_back(queueCreateInfo); }
同时还要修改VkDeviceCreateInfo指向队列集合:
createInfo.queueCreateInfoCount = static_cast<uint32_t>(queueCreateInfos.size());
createInfo.pQueueCreateInfos = queueCreateInfos.data();
如果队列簇相同,那么我们之需要传递一次索引。最后,添加一个调用检索队列句柄:
vkGetDeviceQueue(device, indices.presentFamily, 0, &presentQueue);
在这个例子中,队列簇是相同的,两个句柄可能会有相同的值。在下一个章节中我们会看看交换链,以及它们如何使我们能够将图像呈现给surface。
获取工程代码 GitHub checkout