进击的 Vulkan 移动开发之 Instance & Device & Queue

简介: 针对每个组件进行学习讲解并配上相关的示例代码,首先是 Instance、Device 和 Queue 组件。

作者:星陨

在 Vulkan 的系列文章中出现过如下的图片:

image.png

这张图片很详细的概括了 Vulkan 中的重要组件以及它们的工作流程,接下来的文章中会针对每个组件进行学习讲解并配上相关的示例代码,首先是 Instance、Device 和 Queue 组件。

Instance 组件

在开始创建 Device 等组件之前,需要创建一个 VkInstance 对象。

通过 vkCreateInstance 方法创建 VKInstance 对象,以下是函数原型,在 <vulkan.h> 头文件中。

// 声明的函数指针的形式
typedef VkResult (VKAPI_PTR *PFN_vkCreateInstance)
(const VkInstanceCreateInfo* pCreateInfo, // 提供创建的信息
const VkAllocationCallbacks* pAllocator, // 创建时的回调函数
VkInstance* pInstance);                // 创建的实例

<vulkan.h> 的头文件把函数通过 typedef 关键字声明成了函数指针的形式,可能会有点难找。

在 Vulkan 的 API 中有一些固定的 调用套路 。
1.要创建某个对象,先提供一个包含创建信息的对象。
2.创建时通过传递引用的方式来传参。

接下来看看这个套路是如何应用在 VKInstance 对象上的。

在 vkCreateInstance 函数中看到有个名为 VkInstanceCreateInfo 类型的参数,这就是包含了 VKInstance 要创建的信息。

它的参数信息有点多:

typedef struct VkInstanceCreateInfo {
    VkStructureType             sType;  // 一般为方法对应的类型
    const void*                 pNext; // 一般为 null 就好了
    VkInstanceCreateFlags       flags;  // 留着以后用的,设为 0 就好了
    const VkApplicationInfo*    pApplicationInfo; // 对应新的一个结构体 VkApplicationInfo
    uint32_t                    enabledLayerCount; // layer 和 extension 用于调试和拓展
    const char* const*          ppEnabledLayerNames;
    uint32_t                    enabledExtensionCount;
    const char* const*          ppEnabledExtensionNames;
} VkInstanceCreateInfo;

除了还需要创建一个 VkApplicationInfo 对象,还可以设置 Layer 和 Extension 。

其中:Layer 是用来错误校验、调试输出的。为了提供性能,其中的方法之一就是减少驱动进行状态、错误校验,而 Vulkan 就把这一层单独抽出来了。

image.png

Layer 在整个架构中的位置如上图,Vulkan API 直接和驱动对话,而 Layer 处于应用和 Vulkan API 之间,供开发者进行调试。

另外,Extension 就是 Vulkan 支持的拓展,最典型的就是 Vulkan 的跨平台渲染显示,就是通过拓展来完成的,比如在 Android、Windows 上使用 Vulkan 都需要使用不同的拓展才可以把内容显示到屏幕上。

关于 Layer 和 Extension 后续再细说。

接着回到 VkApplicationInfo 结构体,也是创建 Instance 的必要参数之一。

typedef struct VkApplicationInfo {
    VkStructureType    sType;
    const void*        pNext;
    const char*        pApplicationName;
    uint32_t           applicationVersion;
    const char*        pEngineName;
    uint32_t           engineVersion;
    uint32_t           apiVersion;
} VkApplicationInfo;

它的参数释义就比较容易理解了,设置应用的名称、版本号等,有了它们就可以创建 Instance 对象了,代码可以参考 这里 。

具体的代码如下

VkApplicationInfo app_info = {};
    
    app_info.apiVersion = VK_API_VERSION_1_0;
    app_info.applicationVersion = 1;
    app_info.engineVersion = 1;
    app_info.pNext = nullptr;
    app_info.sType = VK_STRUCTURE_TYPE_APPLICATION_INFO;
    app_info.pEngineName = APPLICATION_NAME;
    app_info.pApplicationName = APPLICATION_NAME;

    VkInstanceCreateInfo instance_info = {};
    // type 就是结构体的类型
    instance_info.sType = VK_STRUCTURE_TYPE_INSTANCE_CREATE_INFO;
    instance_info.pNext = nullptr;
    instance_info.pApplicationInfo = &app_info;
    instance_info.flags = 0;
    // Extension and Layer 暂时不用,可空
    instance_info.enabledExtensionCount = 0;
    instance_info.ppEnabledExtensionNames = nullptr;
    instance_info.ppEnabledLayerNames = nullptr;
    instance_info.enabledLayerCount = 0;

    VkResult result = vkCreateInstance(&instance_info, nullptr, &instance);

当每调用一个创建函数后,返回的类型都是 VkResult ,只要 VkResult 大于 0 ,那么执行就是成功的。

另外还有个参数是 VkAllocationCallbacks,表示函数调用时的回调,需要传递一个函数指针,在后面的各种调用中都会看到它的身影,如果有用到可以传参,一般为 nullptr 就好了。

关于每个结构体,它每个参数的具体释义,靠死记硬背是肯定不行的,参考 vkspec.pdf 书籍,里面有对每个参数、结构体的详细释义。

Device 组件

有了 Instance 组件,就可以创建 Device 组件了,按照调用的套路,肯定还会有一个 VkDeviceCreateInfo 的结构体表示 Device 的创建信息。

而 Device 具体指的是逻辑上的设备,可以说是对物理设备的一个逻辑上的封装,而物理设备就是 VkPhysicalDevice 对象。

在某些情况下,可能会具有多个物理设备,如下图所示,因此要先枚举一下所有的物理设备:
image.png

LOGI("enumerate gpu device");
    uint32_t gpu_size = 0;
    // 第一次调用只为了获得个数
    VkResult res = vkEnumeratePhysicalDevices(instance, &gpu_size, nullptr);

在 vkEnumeratePhysicalDevices 方法中,传入的第二个参数为 gpu 的个数,第三个参数为 null,这样的一次调用会返回 gpu 的个数到 gpu_size 变量。

vector<VkPhysicalDevice> gpus;
    gpus.resize(gpu_size);
    // vector.data() 方法转换成指针类型
    // 第二次调用获得所有的数据
    res = vkEnumeratePhysicalDevices(instance, &gpu_size, gpus.data());

当再一次调用 vkEnumeratePhysicalDevices 函数时,第三个参数不为 null,而是相应的 VkPhysicalDevice 容器,那么 gpus 会填充 gpu_size 个的 VkPhysicalDevice 对象。

这也算是 Vulkan API 调用的一个 固定套路 了,调用两次来获得数据,在后面的代码中也会经常看到这种方式。

有了 VkPhysicalDevice 对象之后,可以查询 VkPhysicalDevice 上的一些属性,以下函数都可以查询相关信息:

  • vkGetPhysicalDeviceQueueFamilyProperties
  • vkGetPhysicalDeviceMemoryProperties
  • vkGetPhysicalDeviceProperties
  • vkGetPhysicalDeviceImageFormatProperties
  • vkGetPhysicalDeviceFormatProperties

在这里需要用到的属性是 QueueFamilyProperties ,获得该属性的方法调用方式和获得 VkPhysicalDevice 数据方式一样,也是一个两次调用。

如果有设备有多个 GPU,那么这里取第一个来获取它的相关属性:

// 第一次调用,获得个数
    uint32_t queue_family_count = 0;
    vkGetPhysicalDeviceQueueFamilyProperties(gpus[0], &queue_family_count, nullptr);
    assert(queue_family_count != 0);
    
    // 第二次调用,获得实际数据
    vector<VkQueueFamilyProperties> queue_family_props;
    queue_family_props.resize(queue_family_count);
    vkGetPhysicalDeviceQueueFamilyProperties(gpus[0], &queue_family_count, queue_family_props.data());
    assert(queue_family_count != 0);

QueueFamilyProperties 的结构体含义如下:

typedef struct VkQueueFamilyProperties {
    VkQueueFlags    queueFlags;      // 标识位:表示 Queue 的功能
    uint32_t        queueCount;         
    uint32_t        timestampValidBits;
    VkExtent3D      minImageTransferGranularity;
} VkQueueFamilyProperties;

其中:queueFlags 表示该 Queue 的能力,有的 Queue 是用来渲染图像的,这个和我们的使用最为密切,还有的 Queue 是用来计算的。

具体的 Flag 标识如下:

typedef enum VkQueueFlagBits {
    VK_QUEUE_GRAPHICS_BIT = 0x00000001,         // 图像相关
    VK_QUEUE_COMPUTE_BIT = 0x00000002,          // 计算相关
    VK_QUEUE_TRANSFER_BIT = 0x00000004,
    VK_QUEUE_SPARSE_BINDING_BIT = 0x00000008,
    VK_QUEUE_FLAG_BITS_MAX_ENUM = 0x7FFFFFFF
} VkQueueFlagBits;
typedef VkFlags VkQueueFlags;

一般来说,我们用的是 queueFlags 为 VK_QUEUE_GRAPHICS_BIT 标识位的 Queue 。

那么 Queue 究竟是什么?

物理设备可能会有多个 Queue,不同的 Queue 对应不同的特性。

在文章最开始的图中可以看到,Command-buffer 是提交到了 Queue ,Queue 再提交给 Device 去执行。Queue 可以看成是应用程序和物理设备沟通的桥梁,我们在 Queue 上提交命令,然后再交由 GPU 去执行。

回到本小节的内容,创建 Device 组件,它的函数指针形式如下:

// 创建 Device 的函数指针
typedef VkResult (VKAPI_PTR *PFN_vkCreateDevice)
(VkPhysicalDevice physicalDevice,       // 物理设备
const VkDeviceCreateInfo* pCreateInfo,  // 调用套路里面的 CreateInfo
const VkAllocationCallbacks* pAllocator,
VkDevice* pDevice);                   // 要创建的 Device 类

创建一个 Device 对象,不仅需要指定具体的物理设备 VkPhysicalDevice,另外还需要该物理设备上的 Queue 相关信息。

在 VkDeviceCreateInfo 结构体中需要一个参数是 VkDeviceQueueCreateInfo ,它的创建如下:

// 创建 Queue 所需的相关信息
    VkDeviceQueueCreateInfo queue_info = {};
    // 找到属性为 VK_QUEUE_GRAPHICS_BIT 的索引
    bool found = false; 
    for (unsigned int i = 0; i < queue_family_count; ++i) {
        if (queue_family_props[i].queueFlags & VK_QUEUE_GRAPHICS_BIT) {
            queue_info.queueFamilyIndex = i;
            found = true;
            break;
        }
    }

    float queue_priorities[1] = {0.0};
    // 结构体的类型
    queue_info.sType = VK_STRUCTURE_TYPE_DEVICE_QUEUE_CREATE_INFO;
    queue_info.pNext = nullptr;
    queue_info.queueCount = 1;
    // Queue 的优先级
    queue_info.pQueuePriorities = queue_priorities;

接下来就可以完成 Queue 的创建:

// 创建 Device 所需的相关信息类
    VkDeviceCreateInfo device_info = {};

    device_info.sType = VK_STRUCTURE_TYPE_DEVICE_CREATE_INFO;
    device_info.pNext = nullptr;
    // Device 所需的 Queue 相关信息
    device_info.queueCreateInfoCount = 1;   // Queue 个数
    device_info.pQueueCreateInfos = &queue_info;    // Queue 相关信息
    // Layer 和 Extension 暂时为空,不影响运行,后续再补上
    device_info.enabledExtensionCount = 0;
    device_info.ppEnabledExtensionNames = NULL;
    device_info.enabledLayerCount = 0;
    device_info.ppEnabledLayerNames = NULL;
    device_info.pEnabledFeatures = NULL;
    
    res = vkCreateDevice(gpus[0], &device_info, nullptr, &device);

Queue 组件

完成了 `Device` 创建之后,`Queue` 的创建也简单多了,直接调用如下函数就好了:

typedef void (VKAPI_PTR *PFN_vkGetDeviceQueue)
(VkDevice device,   // 创建的 Device 对象
uint32_t queueFamilyIndex, // queueFlags 为 VK_QUEUE_GRAPHICS_BIT 的索引
uint32_t queueIndex,        
VkQueue* pQueue);       // 要创建的 Queue

// 代码示例
vkGetDeviceQueue(info.device, info.graphics_queue_family_index, 0, &info.queue);

组件销毁

完成了 Instance、Device、Queue 组件的创建之后,还有一件要做的事情就是释放它们,销毁组件。

按照先进后出的方式进行销毁,Instance 最先创建反而最后销毁,和 Device 相关联的 Queue 当 Device 销毁了,Queue 也随之销毁了。

// 销毁 Device
    vkDestroyDevice(info.device, nullptr);
    // 销毁 Instance
    vkDestroyInstance(info.instance, nullptr);

参考

这里有一些不错的参考地址和书籍:
https://www.zhihu.com/people/snowfox-68/activities

https://www.zhihu.com/people/chen-yong-59-86/posts

也可以参考我的项目实践代码:

https://github.com/glumes/vulkan_tutorial

以上是个人的学习经验,仅供参考,有讲的不对之处,欢迎指出,也可以加我微信一起交流学习: ezglumes (备注博客).

总结

敲一遍上述的代码,会发现 Vulkan 在 API 调用上还是有迹可循的,重点是要理解了每个参数的含义,多结合官方的文档来学习、实践、

Vulkan 系列文章

「视频云技术」你最值得关注的音视频技术公众号,每周推送来自阿里云一线的实践技术文章,在这里与音视频领域一流工程师交流切磋。

阿里云社区.png

相关实践学习
在云上部署ChatGLM2-6B大模型(GPU版)
ChatGLM2-6B是由智谱AI及清华KEG实验室于2023年6月发布的中英双语对话开源大模型。通过本实验,可以学习如何配置AIGC开发环境,如何部署ChatGLM2-6B大模型。
相关文章
|
缓存 移动开发 图形学
进击的 Vulkan 移动开发(二)之谈谈对渲染流程的理解
都说 OpenGL 、Vulkan 是用来绘制二维、三维图形的,那么这个绘制渲染的流程到底是怎么样的呢?这里,谈谈我自己对它的理解。
1052 0
进击的 Vulkan 移动开发(二)之谈谈对渲染流程的理解
|
移动开发 API 图形学
进击的 Vulkan 移动开发之 SwapChain
在之前的文章中,讲到了 Command-Buffer 提交给 Queue 去执行,也提到了 Vulkan 实现跨平台机制,是有一些拓展的,这里就讲讲 Vulkan 窗口系统的拓展(Vulkan Window System Integration WSI),如下图所示:
1694 0
进击的 Vulkan 移动开发之 SwapChain
|
移动开发 异构计算 索引
进击的 Vulkan 移动开发之 Command Buffer
此篇文章继续学习 Vulkan 中的组件:Command-Buffer 。
1204 0
进击的 Vulkan 移动开发之 Command Buffer
|
开发框架 Dart Android开发
移动应用开发中的创新之路:探索跨平台解决方案
【9月更文挑战第21天】在移动应用的海洋中,开发者们面临着一个不断变化的挑战——如何在多个操作系统上提供无缝的用户体验。本文将探讨跨平台开发的魅力与挑战,并深入分析Flutter框架如何成为现代开发者的利器。我们将通过实际代码示例,揭示Flutter简化开发流程、提高生产效率的秘密。从Dart语言的基础到热重载的便捷性,本文旨在为读者提供一次全面而深刻的跨平台开发之旅。
|
C# Android开发 虚拟化
C# 一分钟浅谈:MAUI 跨平台移动应用开发
.NET MAUI 是 Microsoft 推出的跨平台框架,支持 Windows、macOS、iOS 和 Android。本文从基础概念入手,探讨 MAUI 的常见问题、易错点及解决方案,并通过代码示例详细说明。涵盖平台特定代码、XAML 语法、数据绑定、性能优化和调试技巧等内容,帮助开发者更好地掌握 .NET MAUI。
1704 55
|
开发框架 前端开发 Android开发
移动应用开发中的跨平台策略与实践
【9月更文挑战第34天】本文将深入探讨移动应用开发的跨平台策略,包括对React Native、Flutter和Xamarin等流行框架的比较。文章还将分享一些实用的跨平台开发技巧和最佳实践,帮助开发者在多个平台上高效地构建和维护应用。无论你是初学者还是有经验的开发者,这篇文章都会为你提供有价值的见解和指导。
|
开发框架 数据安全/隐私保护 开发者
Flutter 是一款强大的跨平台移动应用开发框架,本文深入探讨了其布局与样式设计
Flutter 是一款强大的跨平台移动应用开发框架,本文深入探讨了其布局与样式设计,涵盖布局基础、常用组件、样式设计、实战应用、响应式布局及性能优化等方面,助力开发者打造精美用户界面。
553 7
|
开发框架 Dart 前端开发
Flutter 是谷歌推出的一款高效跨平台移动应用开发框架,使用 Dart 语言,具备快速开发、跨平台支持、高性能、热重载及美观界面等特点。
Flutter 是谷歌推出的一款高效跨平台移动应用开发框架,使用 Dart 语言,具备快速开发、跨平台支持、高性能、热重载及美观界面等特点。本文从 Flutter 简介、特点、开发环境搭建、应用架构、组件详解、路由管理、状态管理、与原生代码交互、性能优化、应用发布与部署及未来趋势等方面,全面解析 Flutter 技术,助你掌握这一前沿开发工具。
1531 8
|
人工智能 开发框架 前端开发
移动应用开发的未来:探索跨平台框架与AI的融合
随着智能手机的普及和移动技术的飞速发展,移动应用已成为我们日常生活的一部分。本文将探讨移动应用开发的最新趋势,特别是跨平台开发框架的兴起和人工智能技术的结合如何塑造未来移动应用的发展方向。我们将从React Native和Flutter等流行框架谈起,分析它们如何简化开发流程、降低成本并提高应用性能。同时,本文也将深入讨论人工智能如何在用户体验、安全性和个性化服务方面为移动应用带来革命性的变化。最后,我们将展望未来移动应用开发的新机遇和挑战。
470 27
|
前端开发 Android开发 开发者
移动应用开发的未来:探索跨平台解决方案##
在移动开发的海洋中,跨平台框架如同一艘能够穿梭于iOS和Android两大操作系统之间的航船。本文将探讨这艘航船的构造—从它的起源、它的引擎(技术架构),到它能抵达的岸边(应用场景)。我们将启航,一探究竟如何在波涛汹涌的市场中找到自己的航线。 ##
344 3