VK_EXT_host_image_copy 详解:不用暂存缓冲的图像上传

经典的 Vulkan 图像上传是个三步仪式:staging buffer → vkCmdCopyBufferToImage → 布局转换,全部都在队列上的命令缓冲里做。 VK_EXT_host_image_copy(Vulkan 1.4 核心)开了一扇主机端的门: vkCopyMemoryToImageEXT 把像素从 CPU 内存直接写进图像——不用暂存、 不用命令缓冲、不用队列提交。

经典路径 vs. 主机路径

paths.txt
classic:  cpu buf → staging VkBuffer → cmd copy → image (queue submit!)
host:     cpu buf ──────────────────► image     (immediate)
upload.cpp
// 1. Image needs the HOST_TRANSFER flag at creation:
vk::ImageCreateInfo ici{};
ici.format = vk::Format::eR8G8B8A8Unorm;
ici.extent = {w, h, 1};
ici.usage  = vk::ImageUsageFlagBits::eSampled
           | vk::ImageUsageFlagBits::eHostTransferEXT;
ici.initialLayout = vk::ImageLayout::eUndefined;
// … vkCreateImage, bind memory, then:

// 2. Transition once via host — vkTransitionImageLayoutEXT:
vk::HostImageLayoutTransitionInfoEXT tr{};
tr.image      = img;
tr.oldLayout  = vk::ImageLayout::eUndefined;
tr.newLayout  = vk::ImageLayout::eShaderReadOnlyOptimal;
tr.subresourceRange = {vk::ImageAspectFlagBits::eColor, 0, 1, 0, 1};
dev.transitionImageLayoutEXT(1, &tr);

// 3. Copy pixels — synchronous, host-visible side:
vk::MemoryToImageCopyEXT cpy{};
cpy.pHostPointer           = pixels.data();
cpy.memoryRowLength        = w * 4;   // bytes per row, 0 = tight
cpy.imageSubresource       = {vk::ImageAspectFlagBits::eColor, 0, 0, 1};
cpy.imageExtent            = {w, h, 1};
dev.copyMemoryToImageEXT(vk::CopyMemoryToImageInfoEXT{
    vk::CopyMemoryToImageFlagBitsEXT::eNoInternalFormatConversion,
    img, vk::ImageLayout::eShaderReadOnlyOptimal, 1, &cpy});

vkCopyImageToMemoryEXT 是镜像方向——把图像读回 CPU, 不用回读缓冲和 fence 那一套舞步。

为什么要用它

  • 小型、不频繁的上传(字体、LUT、图标):不用命令池、 不用 fence、不用暂存簿记——一次调用搞定。
  • tiled/optimal 布局写入:驱动内部做 swizzle,你只递线性行数据。
  • 初始化期资源:在任何队列存在之前就能上传;大幅简化引擎启动。

不适用的地方

  • 逐帧流式上传——这次拷贝近似同步的主机工作,往往比异步 DMA 暂存拷贝还慢;每帧都传的数据(视频帧、动态图集)用经典暂存路径 或 HOST_COHERENT device-local 缓冲仍然更快。
  • 并非所有格式/布局都支持——查 vkGetPhysicalDeviceFormatProperties2 → VkFormatProperties3::hostImageCopy 和 vkGetPhysicalDeviceImageFormatProperties2 的 hostImageCopySupport。
probe.cpp
vk::FormatProperties3 fp3{};
dev.getPhysicalDeviceFormatProperties2(
        vk::PhysicalDeviceFormatInfo2{vk::Format::eR8G8B8A8Unorm})
   .get<vk::FormatProperties2, vk::FormatProperties3>();
// fp3.optimalTilingFeatures & eHostImageCopy?

实用准则

  • 总是设 eHostTransfer usage,并在两次写入之间把图像保持在 兼容主机传输的布局(eGeneral 到处都能用)。
  • 它并没有免除正确布局追踪的需求——只是把转换挪到主机调用上。
  • 把它当作便利 + 少铺管线,而不是性能升级。

按类别查看类似文章: Vulkan C++