经典的 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_COHERENTdevice-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?
实用准则
- 总是设
eHostTransferusage,并在两次写入之间把图像保持在 兼容主机传输的布局(eGeneral到处都能用)。 - 它并没有免除正确布局追踪的需求——只是把转换挪到主机调用上。
- 把它当作便利 + 少铺管线,而不是性能升级。