Vulkan demo入门教程三：逻辑设备、队列与交换链

Vulkan 嵌入式开发实战逻辑设备、队列与交换链 (Swapchain)系列回顾[第一步] 我们创建了VkInstance并加载了扩展。[第二步] 我们绕过了窗口系统直接通过VK_KHR_display枚举了物理设备、选择了 HDMI 接口并创建了直连Surface。本章目标有了“画布”Surface我们需要“画笔”和“颜料”。本文将完成以下核心任务选择队列族 (Queue Families)找到能画图 (Graphics) 和能上屏 (Present) 的硬件队列。创建逻辑设备 (Logical Device)从物理 GPU 中切分出一部分资源供程序使用。创建交换链 (Swapchain)管理前后端缓冲实现双缓冲/三缓冲机制防止画面撕裂。本文主要是基于Direct Display (VK_KHR_display)扩展详解在嵌入式 Linux环境下如何从零构建 Vulkan 渲染环境。与桌面窗口系统不同直连模式要求开发者显式管理物理显示属性分辨率、刷新率任何参数不匹配都将导致初始化失败。第一步初始化队列族 (Queue Families)Vulkan 的硬件架构是异构的。GPU 内部包含不同的硬件单元引擎分别处理图形渲染、计算、视频解码和显示输出。我们需要查询物理设备支持的队列族并筛选出满足需求的队列。Graphics Queue: 执行绘图命令Draw Calls。Present Queue: 将渲染完成的图像提交至显示控制器。直连模式关键点即使没有窗口系统vkGetPhysicalDeviceSurfaceSupportKHR依然有效。它用于验证某个队列族是否支持向特定的VkDisplayModeKHR(Surface) 进行呈现。若队列不支持 Present后续的vkQueuePresentKHR必败。#includevector#includecstdio#includevulkan/vulkan.h// 假设这些是类成员变量VkPhysicalDevice mPhysicalDevice;VkSurfaceKHR mSurface;// 在直连模式下Surface 对应一个 Display ModeboolmOnScreentrue;std::vectorVkQueueFamilyPropertiesmQueueFamilies;std::vectoruint32_tmGraphicsQueueFamilies;std::vectoruint32_tmPresentQueueFamilies;uint32_tmGraphicsQueueFamilyUINT32_MAX;uint32_tmPresentQueueFamilyUINT32_MAX;intVkEngine::initQueueFamilies(){uint32_tqueueFamilyCount0;// 1. 获取队列族数量vkGetPhysicalDeviceQueueFamilyProperties(mPhysicalDevice,queueFamilyCount,nullptr);if(queueFamilyCount0){printf(错误: 未找到任何队列族!\n);return-1;}mQueueFamilies.resize(queueFamilyCount);// 2. 获取队列族详细信息vkGetPhysicalDeviceQueueFamilyProperties(mPhysicalDevice,queueFamilyCount,mQueueFamilies.data());printf(物理设备支持 %u 个队列族.\n,queueFamilyCount);// 3. 筛选支持 Graphics 的队列uint32_ti0;for(constautoqueueFamily:mQueueFamilies){if(queueFamily.queueFlagsVK_QUEUE_GRAPHICS_BIT){mGraphicsQueueFamilies.push_back(i);}else{printf(队列族 %u 不支持图形渲染 (Graphics).\n,i);}i;}if(mGraphicsQueueFamilies.empty()){printf(致命错误: 没有找到任何支持图形渲染的队列族!\n);return-1;}// 策略优先选择第一个支持 Graphics 的队列族mGraphicsQueueFamilymGraphicsQueueFamilies[0];printf(选定图形队列族索引: %u\n,mGraphicsQueueFamily);// 4. 筛选支持 Present 的队列 (仅在屏幕渲染模式下需要)if(mOnScreen){for(i0;imQueueFamilies.size();i){VkBool32 presentSupportVK_FALSE;// 核心检查验证该队列族是否支持向当前 Surface (Display Mode) 呈现vkGetPhysicalDeviceSurfaceSupportKHR(mPhysicalDevice,i,mSurface,presentSupport);if(presentSupportVK_TRUE){mPresentQueueFamilies.push_back(i);}else{printf(队列族 %u 不支持呈现 (Present) 到当前 Surface.\n,i);}}if(mPresentQueueFamilies.empty()){printf(致命错误: 没有找到任何支持呈现的队列族!\n);return-1;}// 策略选择第一个支持 Present 的队列族// 优化若 Graphics 和 Present 索引相同可复用同一队列减少同步开销mPresentQueueFamilymPresentQueueFamilies[0];printf(选定呈现队列族索引: %u\n,mPresentQueueFamily);}return0;}第二步创建逻辑设备 (Logical Device)物理设备代表真实硬件应用程序通过逻辑设备 (VkDevice)与之交互。创建逻辑设备时必须显式声明使用的队列族及其优先级。启用的设备特性 (Features)。启用的设备扩展 (Extensions)例如VK_KHR_swapchain。VkDevice mDevice;VkQueue mGraphicsQueue;VkQueue mPresentQueue;std::vectorVkExtensionPropertiesmDeviceExtensionProperties;// 需提前查询获取intVkEngine::createLogicalDevice(){VkDeviceCreateInfo createInfo{};createInfo.sTypeVK_STRUCTURE_TYPE_DEVICE_CREATE_INFO;// (1) 配置队列创建信息std::vectorVkDeviceQueueCreateInfoqueueCreateInfos;floatqueuePriority1.0f;// 优先级范围 0.0 ~ 1.0// (1-1) 配置图形队列VkDeviceQueueCreateInfo graphicsQueueCreateInfo{};graphicsQueueCreateInfo.sTypeVK_STRUCTURE_TYPE_DEVICE_QUEUE_CREATE_INFO;graphicsQueueCreateInfo.queueFamilyIndexmGraphicsQueueFamily;graphicsQueueCreateInfo.queueCount1;graphicsQueueCreateInfo.pQueuePrioritiesqueuePriority;queueCreateInfos.push_back(graphicsQueueCreateInfo);// (1-2) 配置呈现队列// 注意若图形队列与呈现队列索引相同Vulkan 驱动会自动去重但显式分开写更清晰if(mGraphicsQueueFamily!mPresentQueueFamily){VkDeviceQueueCreateInfo presentQueueCreateInfo{};presentQueueCreateInfo.sTypeVK_STRUCTURE_TYPE_DEVICE_QUEUE_CREATE_INFO;presentQueueCreateInfo.queueFamilyIndexmPresentQueueFamily;presentQueueCreateInfo.queueCount1;presentQueueCreateInfo.pQueuePrioritiesqueuePriority;queueCreateInfos.push_back(presentQueueCreateInfo);}createInfo.queueCreateInfoCountstatic_castuint32_t(queueCreateInfos.size());createInfo.pQueueCreateInfosqueueCreateInfos.data();// (2) 设置设备特性 (Features)// 默认全关闭。如需多重采样、几何着色器等需在此处显式开启VkPhysicalDeviceFeatures deviceFeatures{};createInfo.pEnabledFeaturesdeviceFeatures;// (3) 启用所需的设备扩展std::vectorconstchar*extensions;if(mOnScreen){extensions.push_back(VK_KHR_SWAPCHAIN_EXTENSION_NAME);}// (3-1) 运行时验证扩展支持 (防御性编程)for(constautoextension:extensions){boolcheckSupportfalse;for(constautophydevExt:mDeviceExtensionProperties){if(strcmp(phydevExt.extensionName,extension)0){checkSupporttrue;break;}}if(!checkSupport){printf(错误: 物理设备不支持必需的扩展%s\n,extension);return-1;}}createInfo.enabledExtensionCountstatic_castuint32_t(extensions.size());createInfo.ppEnabledExtensionNamesextensions.data();// 已废弃的验证层字段 (现代 Vulkan 推荐在 Instance 层处理)createInfo.enabledLayerCount0;// (4) 创建逻辑设备if(vkCreateDevice(mPhysicalDevice,createInfo,nullptr,mDevice)!VK_SUCCESS){printf(致命错误: 无法创建逻辑设备!\n);return-1;}printf(逻辑设备创建成功.\n);// (5) 从逻辑设备获取队列句柄// 即使两个队列来自同一个家族获取到的 VkQueue 句柄也是独立的逻辑对象vkGetDeviceQueue(mDevice,mGraphicsQueueFamily,0,mGraphicsQueue);vkGetDeviceQueue(mDevice,mPresentQueueFamily,0,mPresentQueue);printf(图形队列和呈现队列获取成功.\n);return0;}第三步创建交换链 (Swapchain)交换链是图像缓冲区的集合。我们在其中一个缓冲区渲染然后将其“呈现”到屏幕并切换到下一个缓冲区。直连模式的核心约束imageExtent(分辨率) 必须严格匹配选定的VkDisplayModeKHR的visibleRegion不可随意设定。VkSwapchainKHR mSwapChain;VkFormat mImageFormat;VkExtent2D mExtent;std::vectorVkImagemImages;std::vectorVkImageViewmImageViews;VkSurfaceFormatKHR mSurfaceFormat;// 假设 mSurfaceFormats, mSurfacePresentModes, mSurfaceCapabilities, mSelectDisplayModeProperty 已在前序步骤获取intVkEngine::createSwapchain(){VkSwapchainCreateInfoKHR createInfo{};createInfo.sTypeVK_STRUCTURE_TYPE_SWAPCHAIN_CREATE_INFO_KHR;createInfo.surfacemSurface;// (1) 选择图像格式// 策略首选 B8G8R8A8 SRGB若不支持则回退到第一个可用格式VkSurfaceFormatKHR chosenFormat;boolformatFoundfalse;VkSurfaceFormatKHR preferredFormat;preferredFormat.formatVK_FORMAT_B8G8R8A8_SRGB;preferredFormat.colorSpaceVK_COLOR_SPACE_SRGB_NONLINEAR_KHR;for(constautoavailableFormat:mSurfaceFormats){if(availableFormat.formatpreferredFormat.formatavailableFormat.colorSpacepreferredFormat.colorSpace){chosenFormatavailableFormat;formatFoundtrue;break;}}if(!formatFound){printf(警告: 首选格式不可用使用默认可用格式.\n);chosenFormatmSurfaceFormats[0];}mImageFormatchosenFormat.format;createInfo.imageFormatchosenFormat.format;createInfo.imageColorSpacechosenFormat.colorSpace;printf(选定 Swapchain 格式: %d, 颜色空间: %d\n,chosenFormat.format,chosenFormat.colorSpace);// (2) 选择呈现模式 (Present Mode)// FIFO (垂直同步) 是最广泛支持且无撕裂的模式VkPresentModeKHR chosenPresentModeVK_PRESENT_MODE_FIFO_KHR;boolmodeFoundfalse;for(constautoavailableMode:mSurfacePresentModes){if(availableModechosenPresentMode){modeFoundtrue;break;}}if(!modeFound){// 理论上 FIFO 是必须支持的若缺失则表明驱动实现有问题printf(致命错误: 不支持 VK_PRESENT_MODE_FIFO_KHR!\n);return-1;}createInfo.presentModechosenPresentMode;// (3) 设置分辨率 (Extent) - 直连模式关键// 必须使用 DisplayMode 定义的分辨率不能像窗口模式那样自由调整VkExtent2D extentmSelectDisplayModeProperty.parameters.visibleRegion;// 双重检查确保分辨率在 Surface 能力范围内if(extent.widthmSurfaceCapabilities.minImageExtent.width||extent.widthmSurfaceCapabilities.maxImageExtent.width||extent.heightmSurfaceCapabilities.minImageExtent.height||extent.heightmSurfaceCapabilities.maxImageExtent.height){printf(错误: 选定的分辨率超出 Surface 支持范围!\n);return-1;}mExtentextent;createInfo.imageExtentextent;printf(设定 Swapchain 分辨率: %ux%u\n,extent.width,extent.height);// (4) 设置图像数量 (缓冲区长度的深度)// 通常设为 3 (三重缓冲)需遵守 min/max 限制uint32_timageCount3;if(mSurfaceCapabilities.maxImageCount0imageCountmSurfaceCapabilities.maxImageCount){imageCountmSurfaceCapabilities.maxImageCount;}if(imageCountmSurfaceCapabilities.minImageCount){imageCountmSurfaceCapabilities.minImageCount;}createInfo.minImageCountimageCount;printf(设定 Swapchain 图像数量: %u\n,imageCount);// (5) 其他配置createInfo.imageArrayLayers1;// 单图层除非是 VR 应用createInfo.imageUsageVK_IMAGE_USAGE_COLOR_ATTACHMENT_BIT;// 作为颜色附件渲染// (6) 队列共享模式uint32_tqueueFamilyIndices[]{mGraphicsQueueFamily,mPresentQueueFamily};if(mGraphicsQueueFamily!mPresentQueueFamily){// 队列不同必须设为 CONCURRENT避免所有权转移开销createInfo.imageSharingModeVK_SHARING_MODE_CONCURRENT;createInfo.queueFamilyIndexCount2;createInfo.pQueueFamilyIndicesqueueFamilyIndices;}else{// 队列相同Exclusive 模式性能略优createInfo.imageSharingModeVK_SHARING_MODE_EXCLUSIVE;}// (7) 变换 (Transform)// 直连屏幕通常不需要旋转使用 IDENTITYcreateInfo.preTransformVK_SURFACE_TRANSFORM_IDENTITY_BIT_KHR;if(!(mSurfaceCapabilities.supportedTransformscreateInfo.preTransform)){// 若不支持 Identity回退到当前变换createInfo.preTransformmSurfaceCapabilities.currentTransform;}// (8) Alpha 混合与裁剪createInfo.compositeAlphaVK_COMPOSITE_ALPHA_OPAQUE_BIT_KHR;// 不透明createInfo.clippedVK_TRUE;// 忽略被遮挡像素的性能优化createInfo.oldSwapchainVK_NULL_HANDLE;// (9) 创建 Swapchainif(vkCreateSwapchainKHR(mDevice,createInfo,nullptr,mSwapChain)!VK_SUCCESS){printf(致命错误: 无法创建 Swapchain!\n);return-1;}printf(Swapchain 创建成功!\n);// (10) 获取 Swapchain 中的图像句柄// 注意此处仅获取 VkImage 句柄后续需手动创建 VkImageViewuint32_trealImageCount;vkGetSwapchainImagesKHR(mDevice,mSwapChain,realImageCount,nullptr);mImages.resize(realImageCount);vkGetSwapchainImagesKHR(mDevice,mSwapChain,realImageCount,mImages.data());printf(成功获取 %u 个 Swapchain 图像.\n,realImageCount);return0;}第四步资源清理 (Cleanup)Vulkan 要求显式管理所有资源。当程序退出或需要重建交换链如显示模式切换时必须按依赖关系的反向顺序销毁资源。// 假设成员变量std::vectorVkFramebuffermFramebuffers;VkPipeline mGraphicsPipeline;VkPipelineLayout mPipelineLayout;VkRenderPass mRenderPass;// 同步对象 (semaphores, fences) 假设已有 cleanSyncObjects() 函数voidcleanSyncObjects();voidVkEngine::cleanupSwapChain(){// 1. 等待设备空闲确保没有正在使用的资源vkDeviceWaitIdle(mDevice);// 2. 清理同步对象cleanSyncObjects();// 3. 销毁帧缓冲区 (依赖 ImageView)for(autoframebuffer:mFramebuffers){vkDestroyFramebuffer(mDevice,framebuffer,nullptr);}mFramebuffers.clear();// 4. 销毁管线相关 (依赖 RenderPass 和 PipelineLayout)vkDestroyPipeline(mDevice,mGraphicsPipeline,nullptr);vkDestroyPipelineLayout(mDevice,mPipelineLayout,nullptr);vkDestroyRenderPass(mDevice,mRenderPass,nullptr);// 5. 销毁图像视图 (ImageView)// 注意不要销毁 mImages 本身它们由 Swapchain 统一管理for(autoimageView:mImageViews){vkDestroyImageView(mDevice,imageView,nullptr);}mImageViews.clear();mImages.clear();// 仅清空句柄列表// 6. 销毁 Swapchainif(mSwapChain!VK_NULL_HANDLE){vkDestroySwapchainKHR(mDevice,mSwapChain,nullptr);mSwapChainVK_NULL_HANDLE;}// 注意mSurface 通常在销毁 Instance 前或整个引擎析构时统一销毁// 若是因分辨率变化重建 SwapchainSurface 应保持不变}关键技术点解析1. 队列族的复用与共享模式同队列族(GraphicsPresent)imageSharingMode设为VK_SHARING_MODE_EXCLUSIVE。优势无需额外的所有权转移操作性能最优。异队列族(Graphics!Present)imageSharingMode必须设为VK_SHARING_MODE_CONCURRENT。必须在pQueueFamilyIndices中传入两个队列索引。风险若设为EXCLUSIVE在vkQueuePresent时会因图像所有权未从 Graphics 队列转移到 Present 队列而报错。2. 直连模式的分辨率铁律在桌面窗口系统中currentExtent可由用户动态调整。但在嵌入式直连模式下imageExtent必须等于VkDisplayModePropertiesKHR::parameters.visibleRegion。任何偏差即使是一个像素都可能导致vkCreateSwapchainKHR返回VK_ERROR_INITIALIZATION_FAILED或导致黑屏。3. 格式回退策略嵌入式 GPU 的格式支持差异巨大。稳健策略优先尝试VK_FORMAT_B8G8R8A8_SRGB。兜底方案若首选不可用直接使用mSurfaceFormats[0]。强行指定 unsupported 格式是导致初始化失败的常见原因。下一步预告至此我们已完成 Vulkan 初始化的核心基础设施✅ 逻辑设备 (VkDevice)✅ 队列句柄 (VkQueue)✅ 交换链 (VkSwapchain) 及底层图像资源 (VkImage)接下来的内容将进入渲染管线构建阶段ImageView 创建如何将VkImage包装为着色器可读的视图。Render Pass 定义描述附件的加载/存储操作及子依赖关系。Graphics Pipeline 构建整合 Shader、顶点输入、光栅化状态等打造不可变的渲染状态对象。